From nobody Sun Apr 28 22:42:50 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+45135+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45135+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1565245509; cv=none; d=zoho.com; s=zohoarc; b=mF5iLThc9OuGAN8DXOm4K4wOvT5rfu/Fb5YBlqwGw26Afc6Ebz6KQ+opbgPn+vA+8FKIWMRV66yJgizy8Ar57Iyr8bZW4g2SExU6l3LwKBtqa88HCWrBmvXNeyCnoNbgpdBW3W5pBG/qcSfHTCZfvN7NhB4Re95YVsgbbEAqkt4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1565245509; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To:ARC-Authentication-Results; bh=ZyjT9XE8frYQdAIbQTTGxZmUo9v2SiHxtfq2T//6rhg=; b=kjCN26x5FQ7fcLzCqq3QymIcM5UsGWYOc70Z9d1v70fkG0mRjk0dZYz7y0g1sgjUE+V0bwQMlrcMALxdaJvXaoAOSoi5eK5+rxGJCZjU1FYsKDG5HMt2/dS9J9w5qd+FvLaQq0em83lpV+Uim299e1GxoVJWQX8xXRNkbhVv61E= ARC-Authentication-Results: i=1; mx.zoho.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45135+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1565245509954421.8224498424936; Wed, 7 Aug 2019 23:25:09 -0700 (PDT) Return-Path: X-Received: from mga14.intel.com (mga14.intel.com []) by groups.io with SMTP; Wed, 07 Aug 2019 23:25:09 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Aug 2019 23:25:08 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.64,360,1559545200"; d="scan'208";a="198923284" X-Received: from ydong10-win10.ccr.corp.intel.com ([10.239.158.133]) by fmsmga004.fm.intel.com with ESMTP; 07 Aug 2019 23:25:08 -0700 From: "Dong, Eric" To: devel@edk2.groups.io Cc: Laszlo Ersek , Jordan Justen , Ard Biesheuvel Subject: [edk2-devel] [Patch v6 1/9] OvmfPkg/PlatformPei: Change referenced MSR name. Date: Thu, 8 Aug 2019 14:24:52 +0800 Message-Id: <20190808062500.26996-2-eric.dong@intel.com> In-Reply-To: <20190808062500.26996-1-eric.dong@intel.com> References: <20190808062500.26996-1-eric.dong@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,eric.dong@intel.com Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1565245509; bh=De0wHODe4qcdBwpffqUDsDjjVjAjNI7reOQ3j4FLw/k=; h=Cc:Date:From:Reply-To:Subject:To; b=hn5MI8/Wr/SzUtpwmtvAIBIG1E1vZCbzuOZIP5goP2efGq5BLJpCS2vcFxhwRskWtrq nlBln5rypS1PJYowmQ4wkq987nmT/R2MrsPA3e3ttN5wk506bUBRjTyGFmQPBMI1X3nye 70orZTT3r5G7NF/A3CXMFGh17Cr9ld6dMRY= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" Change referenced MSR name to avoid later build failure. Signed-off-by: Eric Dong Cc: Laszlo Ersek Cc: Jordan Justen Cc: Ard Biesheuvel Reviewed-by: Laszlo Ersek --- OvmfPkg/PlatformPei/FeatureControl.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/OvmfPkg/PlatformPei/FeatureControl.c b/OvmfPkg/PlatformPei/Fea= tureControl.c index 837da2119a..1a9d75022f 100644 --- a/OvmfPkg/PlatformPei/FeatureControl.c +++ b/OvmfPkg/PlatformPei/FeatureControl.c @@ -11,7 +11,7 @@ #include #include #include -#include +#include =20 #include "Platform.h" =20 @@ -37,7 +37,7 @@ WriteFeatureControl ( IN OUT VOID *WorkSpace ) { - AsmWriteMsr64 (MSR_CORE2_FEATURE_CONTROL, mFeatureControlValue); + AsmWriteMsr64 (MSR_IA32_FEATURE_CONTROL, mFeatureControlValue); } =20 /** --=20 2.21.0.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#45135): https://edk2.groups.io/g/devel/message/45135 Mute This Topic: https://groups.io/mt/32796059/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- From nobody Sun Apr 28 22:42:50 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+45136+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45136+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1565245511; cv=none; d=zoho.com; s=zohoarc; b=RqIF2ldZQLI+8bjApKjhhGhuAXr9e2l//aeMefDvOWMmCOkNOs6iVD4GpqZC1VN5wrmzoo98x50JgwQP6EIKIcoDANPcoLLwBHQI8sMyK2iIlTwecklvydtYrO+h33rgUCl1LViU10RlD5DFp/qyKSE3OH0MnByJQpk/pNpBzXc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1565245511; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To:ARC-Authentication-Results; bh=xwJsl4uKk74Gt/D02kHdRWPKY/Eu/5p7CVy723jVU0I=; b=ThRyvnwedNHCkUnMyjFsb/v3wB+/l/hQRSk1hZQCqQ86ab7hHC8gy1RR8uwcGzuWVAxzj9Shm0KT5/mksm0bIiakVh4O7mYBFResXkdu6fus592a0BxG4qkfJzffsreNBX5dEsJBi6B+Iwgxr/YOD98WOfAmJK7IcA5HTJHBXI0= ARC-Authentication-Results: i=1; mx.zoho.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45136+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1565245511104180.14190319952866; Wed, 7 Aug 2019 23:25:11 -0700 (PDT) Return-Path: X-Received: from mga14.intel.com (mga14.intel.com []) by groups.io with SMTP; Wed, 07 Aug 2019 23:25:10 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Aug 2019 23:25:09 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.64,360,1559545200"; d="scan'208";a="198923299" X-Received: from ydong10-win10.ccr.corp.intel.com ([10.239.158.133]) by fmsmga004.fm.intel.com with ESMTP; 07 Aug 2019 23:25:09 -0700 From: "Dong, Eric" To: devel@edk2.groups.io Cc: "Ni, Ray" , Laszlo Ersek Subject: [edk2-devel] [Patch v6 2/9] UefiCpuPkg/MpInitLib: Enable 5-level paging for AP when BSP's enabled Date: Thu, 8 Aug 2019 14:24:53 +0800 Message-Id: <20190808062500.26996-3-eric.dong@intel.com> In-Reply-To: <20190808062500.26996-1-eric.dong@intel.com> References: <20190808062500.26996-1-eric.dong@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,eric.dong@intel.com Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1565245510; bh=LfVtc4EZPTNKkEB1svH81YVgmHlOka8JT+pHiJiT3no=; h=Cc:Date:From:Reply-To:Subject:To; b=rKcpCJo2ymkrMruLhuuWvFOpQoM4uyuvDiAfuHgNI+2hXOu21xBiHsIG9G0xBRoKGHR vGh3VG+XRhzCGgE0RbUltTUV8biMvVgC/rtT9GtTAKEoJW4LV/EQ2ZD2wKL+nAFyk4MEK 7L8IlSU1FDIbwH1BFd+Uiv3cU8usyIQ2TAY= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: "Ni, Ray" REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D2008 MpInitLib is the library that's responsible to wake up APs to provide MP PPI and Protocol services. The patch synchronizes BSP's CR4.LA57 to each AP's CR4.LA57. Without this change, AP may enter to GP fault when BSP's 5-level page table is set to AP during AP wakes up. Signed-off-by: Ray Ni Reviewed-by: Eric Dong Regression-tested-by: Laszlo Ersek --- UefiCpuPkg/Library/MpInitLib/MpLib.c | 13 +++++++++++++ UefiCpuPkg/Library/MpInitLib/MpLib.h | 4 ++++ UefiCpuPkg/Library/MpInitLib/X64/MpEqu.inc | 3 ++- UefiCpuPkg/Library/MpInitLib/X64/MpFuncs.nasm | 14 +++++++++++++- 4 files changed, 32 insertions(+), 2 deletions(-) diff --git a/UefiCpuPkg/Library/MpInitLib/MpLib.c b/UefiCpuPkg/Library/MpIn= itLib/MpLib.c index a1ad665564..d6f84c6f45 100644 --- a/UefiCpuPkg/Library/MpInitLib/MpLib.c +++ b/UefiCpuPkg/Library/MpInitLib/MpLib.c @@ -790,6 +790,7 @@ FillExchangeInfoData ( volatile MP_CPU_EXCHANGE_INFO *ExchangeInfo; UINTN Size; IA32_SEGMENT_DESCRIPTOR *Selector; + IA32_CR4 Cr4; =20 ExchangeInfo =3D CpuMpData->MpCpuExchangeInfo; ExchangeInfo->Lock =3D 0; @@ -814,6 +815,18 @@ FillExchangeInfoData ( =20 ExchangeInfo->InitializeFloatingPointUnitsAddress =3D (UINTN)InitializeF= loatingPointUnits; =20 + // + // We can check either CPUID(7).ECX[bit16] or check CR4.LA57[bit12] + // to determin whether 5-Level Paging is enabled. + // CPUID(7).ECX[bit16] shows CPU's capability, CR4.LA57[bit12] shows + // current system setting. + // Using latter way is simpler because it also eliminates the needs to + // check whether platform wants to enable it. + // + Cr4.UintN =3D AsmReadCr4 (); + ExchangeInfo->Enable5LevelPaging =3D (BOOLEAN) (Cr4.Bits.LA57 =3D=3D 1); + DEBUG ((DEBUG_INFO, "%a: 5-Level Paging =3D %d\n", gEfiCallerBaseName, E= xchangeInfo->Enable5LevelPaging)); + // // Get the BSP's data of GDT and IDT // diff --git a/UefiCpuPkg/Library/MpInitLib/MpLib.h b/UefiCpuPkg/Library/MpIn= itLib/MpLib.h index effa235778..4b12f91d47 100644 --- a/UefiCpuPkg/Library/MpInitLib/MpLib.h +++ b/UefiCpuPkg/Library/MpInitLib/MpLib.h @@ -185,6 +185,10 @@ typedef struct { UINT16 ModeTransitionSegment; UINT32 ModeHighMemory; UINT16 ModeHighSegment; + // + // Enable5LevelPaging indicates whether 5-level paging is enabled in lon= g mode. + // + BOOLEAN Enable5LevelPaging; } MP_CPU_EXCHANGE_INFO; =20 #pragma pack() diff --git a/UefiCpuPkg/Library/MpInitLib/X64/MpEqu.inc b/UefiCpuPkg/Librar= y/MpInitLib/X64/MpEqu.inc index 467f54a860..58ef369342 100644 --- a/UefiCpuPkg/Library/MpInitLib/X64/MpEqu.inc +++ b/UefiCpuPkg/Library/MpInitLib/X64/MpEqu.inc @@ -1,5 +1,5 @@ ;-------------------------------------------------------------------------= ----- ; -; Copyright (c) 2015 - 2017, Intel Corporation. All rights reserved.
+; Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
; SPDX-License-Identifier: BSD-2-Clause-Patent ; ; Module Name: @@ -40,3 +40,4 @@ ModeTransitionMemoryLocation equ LockLocation + 9= 4h ModeTransitionSegmentLocation equ LockLocation + 98h ModeHighMemoryLocation equ LockLocation + 9Ah ModeHighSegmentLocation equ LockLocation + 9Eh +Enable5LevelPagingLocation equ LockLocation + 0A0h diff --git a/UefiCpuPkg/Library/MpInitLib/X64/MpFuncs.nasm b/UefiCpuPkg/Lib= rary/MpInitLib/X64/MpFuncs.nasm index cea90f3d4d..87f2523e85 100644 --- a/UefiCpuPkg/Library/MpInitLib/X64/MpFuncs.nasm +++ b/UefiCpuPkg/Library/MpInitLib/X64/MpFuncs.nasm @@ -1,5 +1,5 @@ ;-------------------------------------------------------------------------= ----- ; -; Copyright (c) 2015 - 2018, Intel Corporation. All rights reserved.
+; Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
; SPDX-License-Identifier: BSD-2-Clause-Patent ; ; Module Name: @@ -100,6 +100,18 @@ SkipEnableExecuteDisableBit: ; mov eax, cr4 bts eax, 5 + + mov esi, Enable5LevelPagingLocation + cmp byte [ebx + esi], 0 + jz SkipEnable5LevelPaging + + ; + ; Enable 5 Level Paging + ; + bts eax, 12 ; Set LA57=3D1. + +SkipEnable5LevelPaging: + mov cr4, eax =20 ; --=20 2.21.0.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#45136): https://edk2.groups.io/g/devel/message/45136 Mute This Topic: https://groups.io/mt/32796060/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- From nobody Sun Apr 28 22:42:50 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+45137+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45137+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1565245511; cv=none; d=zoho.com; s=zohoarc; b=YV5A7FhwnYItB4d4U9mgMLAlRXdUPXN5ZwJhd0rZdiVs719VqylpoY6qrM4opIiM7tZg3rckXPo+bvzR8ZxgALVfEYTH2nCMD9MSTx56xALjzQTp1wPufkl4jIvz5RQNZ9ZXpNaE3CXMtUia3oHtlPZ9uYpGKzPgvwWq4TdnMw4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1565245511; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To:ARC-Authentication-Results; bh=fywRFesWI2W9KTAdgqSS5LBRySqmATKJqMGnlhBPzEo=; b=L3MJBW+ZErLRBITUJ0+kn2B8t/Muk1aoB169aPPR8dqPJQYgB1BFwevoIqWDPsmqXF4G0hkkh4mzToYtwNCbZhOrhuyfGdxxteMSfduGCrmgpKHTLS2LzhbXx4Bv56pKRgfyk/9+axyNKhn/hQV/HrQUgrHgcWRlGu8Vd2i5cbU= ARC-Authentication-Results: i=1; mx.zoho.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45137+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1565245511869328.73023551483936; Wed, 7 Aug 2019 23:25:11 -0700 (PDT) Return-Path: X-Received: from mga14.intel.com (mga14.intel.com []) by groups.io with SMTP; Wed, 07 Aug 2019 23:25:11 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Aug 2019 23:25:10 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.64,360,1559545200"; d="scan'208";a="198923313" X-Received: from ydong10-win10.ccr.corp.intel.com ([10.239.158.133]) by fmsmga004.fm.intel.com with ESMTP; 07 Aug 2019 23:25:09 -0700 From: "Dong, Eric" To: devel@edk2.groups.io Cc: "Ni, Ray" , Jiewen Yao , Laszlo Ersek Subject: [edk2-devel] [Patch v6 3/9] UefiCpuPkg/CpuDxe: Remove unnecessary macros Date: Thu, 8 Aug 2019 14:24:54 +0800 Message-Id: <20190808062500.26996-4-eric.dong@intel.com> In-Reply-To: <20190808062500.26996-1-eric.dong@intel.com> References: <20190808062500.26996-1-eric.dong@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,eric.dong@intel.com Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1565245511; bh=ulZjZBrZN7Jq21/EIiRh5k3sMCy5gRGt8t/HqaFE/78=; h=Cc:Date:From:Reply-To:Subject:To; b=agFiMSQ/kNWEMfEr7mpHAqmvpaBp5wWxmOxzKeprOpCTjQ5HcJW++NiFsZheDoGMZ6p 6G9QYioXp7SBdnwmfjQq2UGWi4skEmEpQIt9vuL8DjR5sImAB4MjKyyuH+diZlDQSH1bH XiHiZGfrJoN6GAFQGq0EU+WoBD2yjmNngl4= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: "Ni, Ray" Today's code defines macros like CR0_PG, CR0_WP, CR4_PSE, CR4_PAE when checking whether individual bits are set in CR0 or CR4 register. The patch changes the code to use IA32_CR0 and IA32_CR4 structure defined in MdePkg/Include/Library/BaseLib.h so that the module local macros can be removed. There is no functionality impact to this change. Signed-off-by: Ray Ni Cc: Jiewen Yao Reviewed-by: Eric Dong Regression-tested-by: Laszlo Ersek --- UefiCpuPkg/CpuDxe/CpuPageTable.c | 43 ++++++++++++++++++-------------- 1 file changed, 24 insertions(+), 19 deletions(-) diff --git a/UefiCpuPkg/CpuDxe/CpuPageTable.c b/UefiCpuPkg/CpuDxe/CpuPageTa= ble.c index c369b44f12..16a2528b55 100644 --- a/UefiCpuPkg/CpuDxe/CpuPageTable.c +++ b/UefiCpuPkg/CpuDxe/CpuPageTable.c @@ -1,7 +1,7 @@ /** @file Page table management support. =20 - Copyright (c) 2017, Intel Corporation. All rights reserved.
+ Copyright (c) 2017 - 2019, Intel Corporation. All rights reserved.
Copyright (c) 2017, AMD Incorporated. All rights reserved.
=20 SPDX-License-Identifier: BSD-2-Clause-Patent @@ -21,14 +21,6 @@ #include "CpuDxe.h" #include "CpuPageTable.h" =20 -/// -/// Paging registers -/// -#define CR0_WP BIT16 -#define CR0_PG BIT31 -#define CR4_PSE BIT4 -#define CR4_PAE BIT5 - /// /// Page Table Entry /// @@ -161,6 +153,8 @@ GetCurrentPagingContext ( UINT32 RegEax; CPUID_EXTENDED_CPU_SIG_EDX RegEdx; MSR_IA32_EFER_REGISTER MsrEfer; + IA32_CR4 Cr4; + IA32_CR0 Cr0; =20 // // Don't retrieve current paging context from processor if in SMM mode. @@ -172,21 +166,24 @@ GetCurrentPagingContext ( } else { mPagingContext.MachineType =3D IMAGE_FILE_MACHINE_I386; } - if ((AsmReadCr0 () & CR0_PG) !=3D 0) { + + Cr0.UintN =3D AsmReadCr0 (); + Cr4.UintN =3D AsmReadCr4 (); + + if (Cr0.Bits.PG !=3D 0) { mPagingContext.ContextData.X64.PageTableBase =3D (AsmReadCr3 () & PA= GING_4K_ADDRESS_MASK_64); } else { mPagingContext.ContextData.X64.PageTableBase =3D 0; } - - if ((AsmReadCr4 () & CR4_PSE) !=3D 0) { + if (Cr0.Bits.WP !=3D 0) { + mPagingContext.ContextData.Ia32.Attributes |=3D PAGE_TABLE_LIB_PAGIN= G_CONTEXT_IA32_X64_ATTRIBUTES_WP_ENABLE; + } + if (Cr4.Bits.PSE !=3D 0) { mPagingContext.ContextData.Ia32.Attributes |=3D PAGE_TABLE_LIB_PAGIN= G_CONTEXT_IA32_X64_ATTRIBUTES_PSE; } - if ((AsmReadCr4 () & CR4_PAE) !=3D 0) { + if (Cr4.Bits.PAE !=3D 0) { mPagingContext.ContextData.Ia32.Attributes |=3D PAGE_TABLE_LIB_PAGIN= G_CONTEXT_IA32_X64_ATTRIBUTES_PAE; } - if ((AsmReadCr0 () & CR0_WP) !=3D 0) { - mPagingContext.ContextData.Ia32.Attributes |=3D PAGE_TABLE_LIB_PAGIN= G_CONTEXT_IA32_X64_ATTRIBUTES_WP_ENABLE; - } =20 AsmCpuid (CPUID_EXTENDED_FUNCTION, &RegEax, NULL, NULL, NULL); if (RegEax >=3D CPUID_EXTENDED_CPU_SIG) { @@ -581,12 +578,14 @@ IsReadOnlyPageWriteProtected ( VOID ) { + IA32_CR0 Cr0; // // To avoid unforseen consequences, don't touch paging settings in SMM m= ode // in this driver. // if (!IsInSmm ()) { - return ((AsmReadCr0 () & CR0_WP) !=3D 0); + Cr0.UintN =3D AsmReadCr0 (); + return (BOOLEAN) (Cr0.Bits.WP !=3D 0); } return FALSE; } @@ -599,12 +598,15 @@ DisableReadOnlyPageWriteProtect ( VOID ) { + IA32_CR0 Cr0; // // To avoid unforseen consequences, don't touch paging settings in SMM m= ode // in this driver. // if (!IsInSmm ()) { - AsmWriteCr0 (AsmReadCr0 () & ~CR0_WP); + Cr0.UintN =3D AsmReadCr0 (); + Cr0.Bits.WP =3D 0; + AsmWriteCr0 (Cr0.UintN); } } =20 @@ -616,12 +618,15 @@ EnableReadOnlyPageWriteProtect ( VOID ) { + IA32_CR0 Cr0; // // To avoid unforseen consequences, don't touch paging settings in SMM m= ode // in this driver. // if (!IsInSmm ()) { - AsmWriteCr0 (AsmReadCr0 () | CR0_WP); + Cr0.UintN =3D AsmReadCr0 (); + Cr0.Bits.WP =3D 1; + AsmWriteCr0 (Cr0.UintN); } } =20 --=20 2.21.0.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#45137): https://edk2.groups.io/g/devel/message/45137 Mute This Topic: https://groups.io/mt/32796061/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- From nobody Sun Apr 28 22:42:50 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+45138+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45138+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1565245513; cv=none; d=zoho.com; s=zohoarc; b=M4CIFJfJylMn9MOKya3FqTLeNhiW92x8IisMSqCiLrM713QqhZCPKHXxwd/9lQpDGi8BOdJwHtIXZTYQnYp6AfyHgnrYUOVOazx5Bg6Z7AgF67bzQ/5mesPDwn59l6AIr00lcd4y+BEI1LP0nleMncoIG+Kvjvx35UaWAZhpz70= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1565245513; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To:ARC-Authentication-Results; bh=qS19mvAIBNhSG4dYAFUBfk5dIdaN2vta6BIQHK+r46A=; b=LNFRbLzGjx6vhXdUvpBYfo8aeIamp+kb+Bg1uoSVgDRqyCEo/zf3S7Qc85UQtWc9EkIAO6FjYE/umBAfnuCiyPud7zVbUfjt+qSQOyyDClZgljJo0wb5STpNFJFhfBBrCcjYKV6j0NN6V+BJ7/OBx7B7qt6uaF1cid0AIxbx4Fc= ARC-Authentication-Results: i=1; mx.zoho.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45138+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1565245513148679.8384870255705; Wed, 7 Aug 2019 23:25:13 -0700 (PDT) Return-Path: X-Received: from mga14.intel.com (mga14.intel.com []) by groups.io with SMTP; Wed, 07 Aug 2019 23:25:12 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Aug 2019 23:25:12 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.64,360,1559545200"; d="scan'208";a="198923338" X-Received: from ydong10-win10.ccr.corp.intel.com ([10.239.158.133]) by fmsmga004.fm.intel.com with ESMTP; 07 Aug 2019 23:25:11 -0700 From: "Dong, Eric" To: devel@edk2.groups.io Cc: "Ni, Ray" , Laszlo Ersek Subject: [edk2-devel] [Patch v6 4/9] UefiCpuPkg/CpuDxe: Support parsing 5-level page table Date: Thu, 8 Aug 2019 14:24:55 +0800 Message-Id: <20190808062500.26996-5-eric.dong@intel.com> In-Reply-To: <20190808062500.26996-1-eric.dong@intel.com> References: <20190808062500.26996-1-eric.dong@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,eric.dong@intel.com Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1565245512; bh=UACAhXqWszyzOnQCgkZi75jmjAITBwHrpBKkl+9hCSk=; h=Cc:Date:From:Reply-To:Subject:To; b=Ubuql+D4clKrKwh8lYKQdswECy85oL1RMJHaDWpUX2GwQWdrmFvufgJIgtby2cxYg/x 2gCq8tSObwwdkIV8sHUDqsG+tUeS+50FUr2ckF+vhLRR/zpURKJ8C3dmG2kcU2PK8BaHe BSm42YaTeK6QVyPn9wyXTmrqXJCmMki1vss= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: "Ni, Ray" REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D2008 Signed-off-by: Ray Ni Reviewed-by: Eric Dong Regression-tested-by: Laszlo Ersek --- UefiCpuPkg/CpuDxe/CpuPageTable.c | 18 +++++++++++++++++- UefiCpuPkg/CpuDxe/CpuPageTable.h | 3 ++- 2 files changed, 19 insertions(+), 2 deletions(-) diff --git a/UefiCpuPkg/CpuDxe/CpuPageTable.c b/UefiCpuPkg/CpuDxe/CpuPageTa= ble.c index 16a2528b55..36ce90d66c 100644 --- a/UefiCpuPkg/CpuDxe/CpuPageTable.c +++ b/UefiCpuPkg/CpuDxe/CpuPageTable.c @@ -184,6 +184,9 @@ GetCurrentPagingContext ( if (Cr4.Bits.PAE !=3D 0) { mPagingContext.ContextData.Ia32.Attributes |=3D PAGE_TABLE_LIB_PAGIN= G_CONTEXT_IA32_X64_ATTRIBUTES_PAE; } + if (Cr4.Bits.LA57 !=3D 0) { + mPagingContext.ContextData.Ia32.Attributes |=3D PAGE_TABLE_LIB_PAGIN= G_CONTEXT_IA32_X64_ATTRIBUTES_5_LEVEL; + } =20 AsmCpuid (CPUID_EXTENDED_FUNCTION, &RegEax, NULL, NULL, NULL); if (RegEax >=3D CPUID_EXTENDED_CPU_SIG) { @@ -273,14 +276,17 @@ GetPageTableEntry ( UINTN Index2; UINTN Index3; UINTN Index4; + UINTN Index5; UINT64 *L1PageTable; UINT64 *L2PageTable; UINT64 *L3PageTable; UINT64 *L4PageTable; + UINT64 *L5PageTable; UINT64 AddressEncMask; =20 ASSERT (PagingContext !=3D NULL); =20 + Index5 =3D ((UINTN)RShiftU64 (Address, 48)) & PAGING_PAE_INDEX_MASK; Index4 =3D ((UINTN)RShiftU64 (Address, 39)) & PAGING_PAE_INDEX_MASK; Index3 =3D ((UINTN)Address >> 30) & PAGING_PAE_INDEX_MASK; Index2 =3D ((UINTN)Address >> 21) & PAGING_PAE_INDEX_MASK; @@ -291,7 +297,17 @@ GetPageTableEntry ( AddressEncMask =3D PcdGet64 (PcdPteMemoryEncryptionAddressOrMask) & PAGI= NG_1G_ADDRESS_MASK_64; =20 if (PagingContext->MachineType =3D=3D IMAGE_FILE_MACHINE_X64) { - L4PageTable =3D (UINT64 *)(UINTN)PagingContext->ContextData.X64.PageTa= bleBase; + if ((PagingContext->ContextData.X64.Attributes & PAGE_TABLE_LIB_PAGING= _CONTEXT_IA32_X64_ATTRIBUTES_5_LEVEL) !=3D 0) { + L5PageTable =3D (UINT64 *)(UINTN)PagingContext->ContextData.X64.Page= TableBase; + if (L5PageTable[Index5] =3D=3D 0) { + *PageAttribute =3D PageNone; + return NULL; + } + + L4PageTable =3D (UINT64 *)(UINTN)(L5PageTable[Index5] & ~AddressEncM= ask & PAGING_4K_ADDRESS_MASK_64); + } else { + L4PageTable =3D (UINT64 *)(UINTN)PagingContext->ContextData.X64.Page= TableBase; + } if (L4PageTable[Index4] =3D=3D 0) { *PageAttribute =3D PageNone; return NULL; diff --git a/UefiCpuPkg/CpuDxe/CpuPageTable.h b/UefiCpuPkg/CpuDxe/CpuPageTa= ble.h index 02d62f2b14..f845956f73 100644 --- a/UefiCpuPkg/CpuDxe/CpuPageTable.h +++ b/UefiCpuPkg/CpuDxe/CpuPageTable.h @@ -1,7 +1,7 @@ /** @file Page table management header file. =20 - Copyright (c) 2017, Intel Corporation. All rights reserved.
+ Copyright (c) 2017 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 **/ @@ -14,6 +14,7 @@ #define PAGE_TABLE_LIB_PAGING_CONTEXT_IA32_X64_ATTRIBUTES_PSE = BIT0 #define PAGE_TABLE_LIB_PAGING_CONTEXT_IA32_X64_ATTRIBUTES_PAE = BIT1 #define PAGE_TABLE_LIB_PAGING_CONTEXT_IA32_X64_ATTRIBUTES_PAGE_1G_SUPPORT = BIT2 +#define PAGE_TABLE_LIB_PAGING_CONTEXT_IA32_X64_ATTRIBUTES_5_LEVEL = BIT3 #define PAGE_TABLE_LIB_PAGING_CONTEXT_IA32_X64_ATTRIBUTES_WP_ENABLE = BIT30 #define PAGE_TABLE_LIB_PAGING_CONTEXT_IA32_X64_ATTRIBUTES_XD_ACTIVATED = BIT31 // Other bits are reserved for future use --=20 2.21.0.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#45138): https://edk2.groups.io/g/devel/message/45138 Mute This Topic: https://groups.io/mt/32796062/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- From nobody Sun Apr 28 22:42:50 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+45139+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45139+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1565245514; cv=none; d=zoho.com; s=zohoarc; b=AMHAKJGQX8s4DIj5UWkixfgrsQ0/BV3y2scHHB0O2ReDE7xjUToW2yAQTmlYU7HpIIfliYxAaItPQ6QeHPAdMW3iSzkE/9/YLZpribvsTI9xEyvsozN9QSsYLFFsr5JwzurolVG3sPXoSqmVxSV9P+5FIpDb++wxtrieO2M/djM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1565245514; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To:ARC-Authentication-Results; bh=20JXMWMKhK0nqm9N0qjnPhB03x/r7CywGajpNvSAoVE=; b=FSKNrHhp5TOu9k7W1GuDst0D91JCYpr4XW2+dwELFkKp9j0TO7ww3z2ZqZUNLlO+hZOl43HGIsCD5kaTv1efK2OU/OjuryWbvhrCnrak2oBZgbo/ejuc+sQucBFPE+alQkYLbKSMRSYVO3vqIx0c4HIT9s2eDUP01oTnZT04J0g= ARC-Authentication-Results: i=1; mx.zoho.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45139+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1565245514038824.4765914309612; Wed, 7 Aug 2019 23:25:14 -0700 (PDT) Return-Path: X-Received: from mga14.intel.com (mga14.intel.com []) by groups.io with SMTP; Wed, 07 Aug 2019 23:25:13 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Aug 2019 23:25:13 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.64,360,1559545200"; d="scan'208";a="198923357" X-Received: from ydong10-win10.ccr.corp.intel.com ([10.239.158.133]) by fmsmga004.fm.intel.com with ESMTP; 07 Aug 2019 23:25:12 -0700 From: "Dong, Eric" To: devel@edk2.groups.io Cc: "Ni, Ray" , Laszlo Ersek , Hao A Wu Subject: [edk2-devel] [Patch v6 5/9] MdeModulePkg/DxeIpl: Introduce PCD PcdUse5LevelPageTable Date: Thu, 8 Aug 2019 14:24:56 +0800 Message-Id: <20190808062500.26996-6-eric.dong@intel.com> In-Reply-To: <20190808062500.26996-1-eric.dong@intel.com> References: <20190808062500.26996-1-eric.dong@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,eric.dong@intel.com Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1565245513; bh=Y2COdH8kxSJLMt4wi+8UtTfzLiDn2tMLJFJDQQuLRdQ=; h=Cc:Date:From:Reply-To:Subject:To; b=e89Sj3iJdh9JeUTR8iKnrtDf24PCfp+xx8jTSL1CgDlG2/xqmzFyQInOF9mnnc9Om4d +0WMAumIcF/MyIXZZneXX0xTqD4/+kSq1BYALyAhgiWyVudEaU+MiTFHEjUEcxaA085oL KkqPVZ60plm1N/i5CWsgfsb8SS1PU+2R8Tg= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: "Ni, Ray" REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D2008 The PCD indicates if 5-Level Paging will be enabled in long mode. 5-Level Paging will not be enabled when the PCD is TRUE but CPU doesn't support 5-Level Paging. Signed-off-by: Ray Ni Reviewed-by: Eric Dong Regression-tested-by: Laszlo Ersek Reviewed-by: Hao A Wu --- MdeModulePkg/MdeModulePkg.dec | 7 +++++++ MdeModulePkg/MdeModulePkg.uni | 7 +++++++ 2 files changed, 14 insertions(+) diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec index c4139753d3..35935d7aa6 100644 --- a/MdeModulePkg/MdeModulePkg.dec +++ b/MdeModulePkg/MdeModulePkg.dec @@ -1981,6 +1981,13 @@ # @Prompt The address mask when memory encryption is enabled. gEfiMdeModulePkgTokenSpaceGuid.PcdPteMemoryEncryptionAddressOrMask|0x0|U= INT64|0x30001047 =20 + ## Indicates if 5-Level Paging will be enabled in long mode. 5-Level Pag= ing will not be enabled + # when the PCD is TRUE but CPU doesn't support 5-Level Paging. + # TRUE - 5-Level Paging will be enabled.
+ # FALSE - 5-Level Paging will not be enabled.
+ # @Prompt Enable 5-Level Paging support in long mode. + gEfiMdeModulePkgTokenSpaceGuid.PcdUse5LevelPageTable|FALSE|BOOLEAN|0x000= 1105F + ## Capsule In Ram is to use memory to deliver the capsules that will be = processed after system # reset.

# This PCD indicates if the Capsule In Ram is supported.
diff --git a/MdeModulePkg/MdeModulePkg.uni b/MdeModulePkg/MdeModulePkg.uni index 2bd1ad29f2..29d0a70ce0 100644 --- a/MdeModulePkg/MdeModulePkg.uni +++ b/MdeModulePkg/MdeModulePkg.uni @@ -1298,3 +1298,10 @@ = "It is used to set VPD region base address. So, it can't be Dynami= cExVpd PCD. Its value is" = "required to be accessed in PcdDxe driver entry point. So, its val= ue must be set in PEI phase." = "It can't depend on EFI variable service, and can't be DynamicExHi= i PCD." + +#string STR_gEfiMdeModulePkgTokenSpaceGuid_PcdUse5LevelPageTable_PROMPT #= language en-US "Enable 5-Level Paging support in long mode" + +#string STR_gEfiMdeModulePkgTokenSpaceGuid_PcdUse5LevelPageTable_HELP #la= nguage en-US "Indicates if 5-Level Paging will be enabled in long mode. 5-L= evel Paging will not be enabled" + = "when the PCD is TRUE but CPU doesn't support 5-Level Paging." + = " TRUE - 5-Level Paging will be enabled." + = " FALSE - 5-Level Paging will not be enabled." --=20 2.21.0.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#45139): https://edk2.groups.io/g/devel/message/45139 Mute This Topic: https://groups.io/mt/32796063/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- From nobody Sun Apr 28 22:42:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+45140+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45140+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1565245518; cv=none; d=zoho.com; s=zohoarc; b=ILd+BugSa2nW/SQkQEjuO4afG9/2zdFkBmA5MaFDxWKBhOd10HmEFIVXSUaytbgqYU9BIpnRX/IEydcLa0GVfkfvcszxpmh4vetgUeLjRnRrDcg+55lOA7W8W6pWoqnViQYwCozFrQP3B0tzFXmpk5DBrYL7/SHqfiVeWLKKsho= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1565245518; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To:ARC-Authentication-Results; bh=Fl5VZlaZrIeyhU26Xgh9tmtIsm09cbr9k3N7/AekJcM=; b=PHewG96YxOfxrgkdLFIgbtFr02wubm1yh7nzbUgTWxqNUNbaEo4ZbcaQZ0me0k9oAsT6y2HgtFUZJcqjOWix3bW3Lj2Dxjjk6p18Hi6wl5Et+C6DFaQrB8ZtB+sW7xzJDLC8qsGhSG9SWUITUI6qSsfyWBppXaZm/vDbYyPCSWk= ARC-Authentication-Results: i=1; mx.zoho.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45140+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1565245518342451.99478363088804; Wed, 7 Aug 2019 23:25:18 -0700 (PDT) Return-Path: X-Received: from mga14.intel.com (mga14.intel.com []) by groups.io with SMTP; Wed, 07 Aug 2019 23:25:16 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Aug 2019 23:25:16 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.64,360,1559545200"; d="scan'208";a="198923427" X-Received: from ydong10-win10.ccr.corp.intel.com ([10.239.158.133]) by fmsmga004.fm.intel.com with ESMTP; 07 Aug 2019 23:25:13 -0700 From: "Dong, Eric" To: devel@edk2.groups.io Cc: "Ni, Ray" , Michael D Kinney , Liming Gao , Laszlo Ersek Subject: [edk2-devel] [Patch v6 6/9] MdePkg/Cpuid.h: Move Cpuid.h from UefiCpuPkg to MdePkg Date: Thu, 8 Aug 2019 14:24:57 +0800 Message-Id: <20190808062500.26996-7-eric.dong@intel.com> In-Reply-To: <20190808062500.26996-1-eric.dong@intel.com> References: <20190808062500.26996-1-eric.dong@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,eric.dong@intel.com Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1565245517; bh=m8ngYuV1WQK5vnEYNq9p6/8dZSSaZCiKRXgmun67t98=; h=Cc:Date:From:Reply-To:Subject:To; b=YhLrw2BMEgor7dmYD1LyKQmdizm3Q+eFaRF5nkJWXouoqL18CXlK2JphtykXr7cYTfu I3fGEgBph3O1QKKWCVpRf+slZBhXU+IFrn/jsUn1HyZJQDdbTn6vctXtdZOf4oThKAhW0 kivH88bzmodyibK4xeGM/p2bIgcA85jP1xY= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: "Ni, Ray" REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D2008 MdeModulePkg/DxeIpl needs to get CPUID output for CPU 5-level paging capability detection. In order to use the macros/structures defined in UefiCpuPkg/Include/Register/Cpuid.h, the patch adds Intel/Cpuid.h to MdePkg/Include/Register/ directory and updates Cpuid.h in UefiCpuPkg to include the new one in MdePkg. Signed-off-by: Ray Ni Cc: Michael D Kinney Reviewed-by: Liming Gao Reviewed-by: Eric Dong Regression-tested-by: Laszlo Ersek --- MdePkg/Include/Register/Intel/Cpuid.h | 3997 +++++++++++++++++++++++++ UefiCpuPkg/Include/Register/Cpuid.h | 3983 +----------------------- 2 files changed, 3999 insertions(+), 3981 deletions(-) create mode 100644 MdePkg/Include/Register/Intel/Cpuid.h diff --git a/MdePkg/Include/Register/Intel/Cpuid.h b/MdePkg/Include/Registe= r/Intel/Cpuid.h new file mode 100644 index 0000000000..d449607957 --- /dev/null +++ b/MdePkg/Include/Register/Intel/Cpuid.h @@ -0,0 +1,3997 @@ +/** @file + Intel CPUID leaf definitions. + + Provides defines for CPUID leaf indexes. Data structures are provided f= or + registers returned by a CPUID leaf that contain one or more bit fields. + If a register returned is a single 32-bit value, then a data structure is + not provided for that register. + + Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent + + @par Specification Reference: + Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume = 2A, + November 2018, CPUID instruction. + +**/ + +#ifndef __INTEL_CPUID_H__ +#define __INTEL_CPUID_H__ + +/** + CPUID Signature Information + + @param EAX CPUID_SIGNATURE (0x00) + + @retval EAX Returns the highest value the CPUID instruction recognizes= for + returning basic processor information. The value is return= ed is + processor specific. + @retval EBX First 4 characters of a vendor identification string. + @retval ECX Last 4 characters of a vendor identification string. + @retval EDX Middle 4 characters of a vendor identification string. + + Example usage + @code + UINT32 Eax; + UINT32 Ebx; + UINT32 Ecx; + UINT32 Edx; + + AsmCpuid (CPUID_SIGNATURE, &Eax, &Ebx, &Ecx, &Edx); + @endcode +**/ +#define CPUID_SIGNATURE 0x00 + +/// +/// @{ CPUID signature values returned by Intel processors +/// +#define CPUID_SIGNATURE_GENUINE_INTEL_EBX SIGNATURE_32 ('G', 'e', 'n', 'u= ') +#define CPUID_SIGNATURE_GENUINE_INTEL_EDX SIGNATURE_32 ('i', 'n', 'e', 'I= ') +#define CPUID_SIGNATURE_GENUINE_INTEL_ECX SIGNATURE_32 ('n', 't', 'e', 'l= ') +/// +/// @} +/// + + +/** + CPUID Version Information + + @param EAX CPUID_VERSION_INFO (0x01) + + @retval EAX Returns Model, Family, Stepping Information described by t= he + type CPUID_VERSION_INFO_EAX. + @retval EBX Returns Brand, Cache Line Size, and Initial APIC ID descri= bed by + the type CPUID_VERSION_INFO_EBX. + @retval ECX CPU Feature Information described by the type + CPUID_VERSION_INFO_ECX. + @retval EDX CPU Feature Information described by the type + CPUID_VERSION_INFO_EDX. + + Example usage + @code + CPUID_VERSION_INFO_EAX Eax; + CPUID_VERSION_INFO_EBX Ebx; + CPUID_VERSION_INFO_ECX Ecx; + CPUID_VERSION_INFO_EDX Edx; + + AsmCpuid (CPUID_VERSION_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Ed= x.Uint32); + @endcode +**/ +#define CPUID_VERSION_INFO 0x01 + +/** + CPUID Version Information returned in EAX for CPUID leaf + #CPUID_VERSION_INFO. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 SteppingId:4; ///< [Bits 3:0] Stepping ID + UINT32 Model:4; ///< [Bits 7:4] Model + UINT32 FamilyId:4; ///< [Bits 11:8] Family + UINT32 ProcessorType:2; ///< [Bits 13:12] Processor Type + UINT32 Reserved1:2; ///< [Bits 15:14] Reserved + UINT32 ExtendedModelId:4; ///< [Bits 19:16] Extended Model ID + UINT32 ExtendedFamilyId:8; ///< [Bits 27:20] Extended Family ID + UINT32 Reserved2:4; ///< Reserved + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_VERSION_INFO_EAX; + +/// +/// @{ Define value for bit field CPUID_VERSION_INFO_EAX.ProcessorType +/// +#define CPUID_VERSION_INFO_EAX_PROCESSOR_TYPE_ORIGINAL_OEM_PROCESSOR 0= x00 +#define CPUID_VERSION_INFO_EAX_PROCESSOR_TYPE_INTEL_OVERDRIVE_PROCESSOR 0= x01 +#define CPUID_VERSION_INFO_EAX_PROCESSOR_TYPE_DUAL_PROCESSOR 0= x02 +/// +/// @} +/// + +/** + CPUID Version Information returned in EBX for CPUID leaf + #CPUID_VERSION_INFO. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Provides an entry into a brand string table that contai= ns + /// brand strings for IA-32 processors. + /// + UINT32 BrandIndex:8; + /// + /// [Bits 15:8] Indicates the size of the cache line flushed by the CL= FLUSH + /// and CLFLUSHOPT instructions in 8-byte increments. This field was + /// introduced in the Pentium 4 processor. + /// + UINT32 CacheLineSize:8; + /// + /// [Bits 23:16] Maximum number of addressable IDs for logical process= ors + /// in this physical package. + /// + /// @note + /// The nearest power-of-2 integer that is not smaller than EBX[23:16]= is + /// the number of unique initial APICIDs reserved for addressing diffe= rent + /// logical processors in a physical package. This field is only valid= if + /// CPUID.1.EDX.HTT[bit 28]=3D 1. + /// + UINT32 MaximumAddressableIdsForLogicalProcessors:8; + /// + /// [Bits 31:24] The 8-bit ID that is assigned to the local APIC on the + /// processor during power up. This field was introduced in the Pentiu= m 4 + /// processor. + /// + UINT32 InitialLocalApicId:8; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_VERSION_INFO_EBX; + +/** + CPUID Version Information returned in ECX for CPUID leaf + #CPUID_VERSION_INFO. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Streaming SIMD Extensions 3 (SSE3). A value of 1 indicate= s the + /// processor supports this technology + /// + UINT32 SSE3:1; + /// + /// [Bit 1] A value of 1 indicates the processor supports the PCLMULQDQ + /// instruction. Carryless Multiplication + /// + UINT32 PCLMULQDQ:1; + /// + /// [Bit 2] 64-bit DS Area. A value of 1 indicates the processor supp= orts + /// DS area using 64-bit layout. + /// + UINT32 DTES64:1; + /// + /// [Bit 3] MONITOR/MWAIT. A value of 1 indicates the processor suppo= rts + /// this feature. + /// + UINT32 MONITOR:1; + /// + /// [Bit 4] CPL Qualified Debug Store. A value of 1 indicates the pro= cessor + /// supports the extensions to the Debug Store feature to allow for br= anch + /// message storage qualified by CPL + /// + UINT32 DS_CPL:1; + /// + /// [Bit 5] Virtual Machine Extensions. A value of 1 indicates that t= he + /// processor supports this technology. + /// + UINT32 VMX:1; + /// + /// [Bit 6] Safer Mode Extensions. A value of 1 indicates that the pro= cessor + /// supports this technology + /// + UINT32 SMX:1; + /// + /// [Bit 7] Enhanced Intel SpeedStep(R) technology. A value of 1 indi= cates + /// that the processor supports this technology + /// + UINT32 EIST:1; + /// + /// [Bit 8] Thermal Monitor 2. A value of 1 indicates whether the pro= cessor + /// supports this technology + /// + UINT32 TM2:1; + /// + /// [Bit 9] A value of 1 indicates the presence of the Supplemental St= reaming + /// SIMD Extensions 3 (SSSE3). A value of 0 indicates the instruction + /// extensions are not present in the processor. + /// + UINT32 SSSE3:1; + /// + /// [Bit 10] L1 Context ID. A value of 1 indicates the L1 data cache = mode + /// can be set to either adaptive mode or shared mode. A value of 0 in= dicates + /// this feature is not supported. See definition of the IA32_MISC_ENA= BLE MSR + /// Bit 24 (L1 Data Cache Context Mode) for details + /// + UINT32 CNXT_ID:1; + /// + /// [Bit 11] A value of 1 indicates the processor supports IA32_DEBUG_= INTERFACE + /// MSR for silicon debug + /// + UINT32 SDBG:1; + /// + /// [Bit 12] A value of 1 indicates the processor supports FMA (Fused = Multiple + /// Add) extensions using YMM state. + /// + UINT32 FMA:1; + /// + /// [Bit 13] CMPXCHG16B Available. A value of 1 indicates that the fe= ature + /// is available. + /// + UINT32 CMPXCHG16B:1; + /// + /// [Bit 14] xTPR Update Control. A value of 1 indicates that the pro= cessor + /// supports changing IA32_MISC_ENABLE[Bit 23]. + /// + UINT32 xTPR_Update_Control:1; + /// + /// [Bit 15] Perfmon and Debug Capability: A value of 1 indicates the + /// processor supports the performance and debug feature indication MSR + /// IA32_PERF_CAPABILITIES. + /// + UINT32 PDCM:1; + UINT32 Reserved:1; + /// + /// [Bit 17] Process-context identifiers. A value of 1 indicates that= the + /// processor supports PCIDs and that software may set CR4.PCIDE to 1. + /// + UINT32 PCID:1; + /// + /// [Bit 18] A value of 1 indicates the processor supports the ability= to + /// prefetch data from a memory mapped device. Direct Cache Access. + /// + UINT32 DCA:1; + /// + /// [Bit 19] A value of 1 indicates that the processor supports SSE4.1. + /// + UINT32 SSE4_1:1; + /// + /// [Bit 20] A value of 1 indicates that the processor supports SSE4.2. + /// + UINT32 SSE4_2:1; + /// + /// [Bit 21] A value of 1 indicates that the processor supports x2APIC + /// feature. + /// + UINT32 x2APIC:1; + /// + /// [Bit 22] A value of 1 indicates that the processor supports MOVBE + /// instruction. + /// + UINT32 MOVBE:1; + /// + /// [Bit 23] A value of 1 indicates that the processor supports the PO= PCNT + /// instruction. + /// + UINT32 POPCNT:1; + /// + /// [Bit 24] A value of 1 indicates that the processor's local APIC ti= mer + /// supports one-shot operation using a TSC deadline value. + /// + UINT32 TSC_Deadline:1; + /// + /// [Bit 25] A value of 1 indicates that the processor supports the AE= SNI + /// instruction extensions. + /// + UINT32 AESNI:1; + /// + /// [Bit 26] A value of 1 indicates that the processor supports the + /// XSAVE/XRSTOR processor extended states feature, the XSETBV/XGETBV + /// instructions, and XCR0. + /// + UINT32 XSAVE:1; + /// + /// [Bit 27] A value of 1 indicates that the OS has set CR4.OSXSAVE[Bi= t 18] + /// to enable XSETBV/XGETBV instructions to access XCR0 and to support + /// processor extended state management using XSAVE/XRSTOR. + /// + UINT32 OSXSAVE:1; + /// + /// [Bit 28] A value of 1 indicates the processor supports the AVX ins= truction + /// extensions. + /// + UINT32 AVX:1; + /// + /// [Bit 29] A value of 1 indicates that processor supports 16-bit + /// floating-point conversion instructions. + /// + UINT32 F16C:1; + /// + /// [Bit 30] A value of 1 indicates that processor supports RDRAND ins= truction. + /// + UINT32 RDRAND:1; + /// + /// [Bit 31] Always returns 0. + /// + UINT32 NotUsed:1; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_VERSION_INFO_ECX; + +/** + CPUID Version Information returned in EDX for CPUID leaf + #CPUID_VERSION_INFO. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Floating Point Unit On-Chip. The processor contains an x87= FPU. + /// + UINT32 FPU:1; + /// + /// [Bit 1] Virtual 8086 Mode Enhancements. Virtual 8086 mode enhance= ments, + /// including CR4.VME for controlling the feature, CR4.PVI for protect= ed + /// mode virtual interrupts, software interrupt indirection, expansion= of + /// the TSS with the software indirection bitmap, and EFLAGS.VIF and + /// EFLAGS.VIP flags. + /// + UINT32 VME:1; + /// + /// [Bit 2] Debugging Extensions. Support for I/O breakpoints, includ= ing + /// CR4.DE for controlling the feature, and optional trapping of acces= ses to + /// DR4 and DR5. + /// + UINT32 DE:1; + /// + /// [Bit 3] Page Size Extension. Large pages of size 4 MByte are supp= orted, + /// including CR4.PSE for controlling the feature, the defined dirty b= it in + /// PDE (Page Directory Entries), optional reserved bit trapping in CR= 3, + /// PDEs, and PTEs. + /// + UINT32 PSE:1; + /// + /// [Bit 4] Time Stamp Counter. The RDTSC instruction is supported, + /// including CR4.TSD for controlling privilege. + /// + UINT32 TSC:1; + /// + /// [Bit 5] Model Specific Registers RDMSR and WRMSR Instructions. The + /// RDMSR and WRMSR instructions are supported. Some of the MSRs are + /// implementation dependent. + /// + UINT32 MSR:1; + /// + /// [Bit 6] Physical Address Extension. Physical addresses greater th= an 32 + /// bits are supported: extended page table entry formats, an extra le= vel in + /// the page translation tables is defined, 2-MByte pages are supported + /// instead of 4 Mbyte pages if PAE bit is 1. + /// + UINT32 PAE:1; + /// + /// [Bit 7] Machine Check Exception. Exception 18 is defined for Mach= ine + /// Checks, including CR4.MCE for controlling the feature. This featur= e does + /// not define the model-specific implementations of machine-check err= or + /// logging, reporting, and processor shutdowns. Machine Check excepti= on + /// handlers may have to depend on processor version to do model speci= fic + /// processing of the exception, or test for the presence of the Machi= ne + /// Check feature. + /// + UINT32 MCE:1; + /// + /// [Bit 8] CMPXCHG8B Instruction. The compare-and-exchange 8 bytes(6= 4 bits) + /// instruction is supported (implicitly locked and atomic). + /// + UINT32 CX8:1; + /// + /// [Bit 9] APIC On-Chip. The processor contains an Advanced Programm= able + /// Interrupt Controller (APIC), responding to memory mapped commands = in the + /// physical address range FFFE0000H to FFFE0FFFH (by default - some + /// processors permit the APIC to be relocated). + /// + UINT32 APIC:1; + UINT32 Reserved1:1; + /// + /// [Bit 11] SYSENTER and SYSEXIT Instructions. The SYSENTER and SYSE= XIT + /// and associated MSRs are supported. + /// + UINT32 SEP:1; + /// + /// [Bit 12] Memory Type Range Registers. MTRRs are supported. The MT= RRcap + /// MSR contains feature bits that describe what memory types are supp= orted, + /// how many variable MTRRs are supported, and whether fixed MTRRs are + /// supported. + /// + UINT32 MTRR:1; + /// + /// [Bit 13] Page Global Bit. The global bit is supported in paging-s= tructure + /// entries that map a page, indicating TLB entries that are common to + /// different processes and need not be flushed. The CR4.PGE bit contr= ols + /// this feature. + /// + UINT32 PGE:1; + /// + /// [Bit 14] Machine Check Architecture. A value of 1 indicates the Ma= chine + /// Check Architecture of reporting machine errors is supported. The M= CG_CAP + /// MSR contains feature bits describing how many banks of error repor= ting + /// MSRs are supported. + /// + UINT32 MCA:1; + /// + /// [Bit 15] Conditional Move Instructions. The conditional move inst= ruction + /// CMOV is supported. In addition, if x87 FPU is present as indicated= by the + /// CPUID.FPU feature bit, then the FCOMI and FCMOV instructions are s= upported. + /// + UINT32 CMOV:1; + /// + /// [Bit 16] Page Attribute Table. Page Attribute Table is supported.= This + /// feature augments the Memory Type Range Registers (MTRRs), allowing= an + /// operating system to specify attributes of memory accessed through a + /// linear address on a 4KB granularity. + /// + UINT32 PAT:1; + /// + /// [Bit 17] 36-Bit Page Size Extension. 4-MByte pages addressing phy= sical + /// memory beyond 4 GBytes are supported with 32-bit paging. This feat= ure + /// indicates that upper bits of the physical address of a 4-MByte pag= e are + /// encoded in bits 20:13 of the page-directory entry. Such physical + /// addresses are limited by MAXPHYADDR and may be up to 40 bits in si= ze. + /// + UINT32 PSE_36:1; + /// + /// [Bit 18] Processor Serial Number. The processor supports the 96-b= it + /// processor identification number feature and the feature is enabled. + /// + UINT32 PSN:1; + /// + /// [Bit 19] CLFLUSH Instruction. CLFLUSH Instruction is supported. + /// + UINT32 CLFSH:1; + UINT32 Reserved2:1; + /// + /// [Bit 21] Debug Store. The processor supports the ability to write= debug + /// information into a memory resident buffer. This feature is used b= y the + /// branch trace store (BTS) and precise event-based sampling (PEBS) + /// facilities. + /// + UINT32 DS:1; + /// + /// [Bit 22] Thermal Monitor and Software Controlled Clock Facilities.= The + /// processor implements internal MSRs that allow processor temperatur= e to + /// be monitored and processor performance to be modulated in predefin= ed + /// duty cycles under software control. + /// + UINT32 ACPI:1; + /// + /// [Bit 23] Intel MMX Technology. The processor supports the Intel M= MX + /// technology. + /// + UINT32 MMX:1; + /// + /// [Bit 24] FXSAVE and FXRSTOR Instructions. The FXSAVE and FXRSTOR + /// instructions are supported for fast save and restore of the floati= ng + /// point context. Presence of this bit also indicates that CR4.OSFXSR= is + /// available for an operating system to indicate that it supports the + /// FXSAVE and FXRSTOR instructions. + /// + UINT32 FXSR:1; + /// + /// [Bit 25] SSE. The processor supports the SSE extensions. + /// + UINT32 SSE:1; + /// + /// [Bit 26] SSE2. The processor supports the SSE2 extensions. + /// + UINT32 SSE2:1; + /// + /// [Bit 27] Self Snoop. The processor supports the management of + /// conflicting memory types by performing a snoop of its own cache + /// structure for transactions issued to the bus. + /// + UINT32 SS:1; + /// + /// [Bit 28] Max APIC IDs reserved field is Valid. A value of 0 for H= TT + /// indicates there is only a single logical processor in the package = and + /// software should assume only a single APIC ID is reserved. A value = of 1 + /// for HTT indicates the value in CPUID.1.EBX[23:16] (the Maximum num= ber of + /// addressable IDs for logical processors in this package) is valid f= or the + /// package. + /// + UINT32 HTT:1; + /// + /// [Bit 29] Thermal Monitor. The processor implements the thermal mo= nitor + /// automatic thermal control circuitry (TCC). + /// + UINT32 TM:1; + UINT32 Reserved3:1; + /// + /// [Bit 31] Pending Break Enable. The processor supports the use of = the + /// FERR#/PBE# pin when the processor is in the stop-clock state (STPC= LK# is + /// asserted) to signal the processor that an interrupt is pending and= that + /// the processor should return to normal operation to handle the inte= rrupt. + /// Bit 10 (PBE enable) in the IA32_MISC_ENABLE MSR enables this capab= ility. + /// + UINT32 PBE:1; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_VERSION_INFO_EDX; + + +/** + CPUID Cache and TLB Information + + @param EAX CPUID_CACHE_INFO (0x02) + + @retval EAX Cache and TLB Information described by the type + CPUID_CACHE_INFO_CACHE_TLB. + CPUID_CACHE_INFO_CACHE_TLB.CacheDescriptor[0] always retur= ns + 0x01 and must be ignored. Only valid if + CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear. + @retval EBX Cache and TLB Information described by the type + CPUID_CACHE_INFO_CACHE_TLB. Only valid if + CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear. + @retval ECX Cache and TLB Information described by the type + CPUID_CACHE_INFO_CACHE_TLB. Only valid if + CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear. + @retval EDX Cache and TLB Information described by the type + CPUID_CACHE_INFO_CACHE_TLB. Only valid if + CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear. + + Example usage + @code + CPUID_CACHE_INFO_CACHE_TLB Eax; + CPUID_CACHE_INFO_CACHE_TLB Ebx; + CPUID_CACHE_INFO_CACHE_TLB Ecx; + CPUID_CACHE_INFO_CACHE_TLB Edx; + + AsmCpuid (CPUID_CACHE_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.= Uint32); + @endcode + + Cache Descriptor values + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Value Type Description
0x00 General Null descriptor, this byte con= tains no information
0x01 TLB Instruction TLB: 4 KByte pages= , 4-way set associative, 32 entries
0x02 TLB Instruction TLB: 4 MByte pages= , fully associative, 2 entries
0x03 TLB Data TLB: 4 KByte pages, 4-way= set associative, 64 entries
0x04 TLB Data TLB: 4 MByte pages, 4-way= set associative, 8 entries
0x05 TLB Data TLB1: 4 MByte pages, 4-wa= y set associative, 32 entries
0x06 Cache 1st-level instruction cache: 8= KBytes, 4-way set associative, + 32 byte line size
0x08 Cache 1st-level instruction cache: 1= 6 KBytes, 4-way set associative, + 32 byte line size
0x09 Cache 1st-level instruction cache: 3= 2KBytes, 4-way set associative, + 64 byte line size
0x0A Cache 1st-level data cache: 8 KBytes= , 2-way set associative, 32 byte line size
0x0B TLB Instruction TLB: 4 MByte pages= , 4-way set associative, 4 entries
0x0C Cache 1st-level data cache: 16 KByte= s, 4-way set associative, 32 byte line size
0x0D Cache 1st-level data cache: 16 KByte= s, 4-way set associative, 64 byte line size
0x0E Cache 1st-level data cache: 24 KByte= s, 6-way set associative, 64 byte line size
0x1D Cache 2nd-level cache: 128 KBytes, 2= -way set associative, 64 byte line size
0x21 Cache 2nd-level cache: 256 KBytes, 8= -way set associative, 64 byte line size
0x22 Cache 3rd-level cache: 512 KBytes, 4= -way set associative, 64 byte line size, + 2 lines per sector
0x23 Cache 3rd-level cache: 1 MBytes, 8-w= ay set associative, 64 byte line size, + 2 lines per sector
0x24 Cache 2nd-level cache: 1 MBytes, 16-= way set associative, 64 byte line size
0x25 Cache 3rd-level cache: 2 MBytes, 8-w= ay set associative, 64 byte line size, + 2 lines per sector
0x29 Cache 3rd-level cache: 4 MBytes, 8-w= ay set associative, 64 byte line size, + 2 lines per sector
0x2C Cache 1st-level data cache: 32 KByte= s, 8-way set associative, + 64 byte line size
0x30 Cache 1st-level instruction cache: 3= 2 KBytes, 8-way set associative, + 64 byte line size
0x40 Cache No 2nd-level cache or, if proc= essor contains a valid 2nd-level cache, + no 3rd-level cache
0x41 Cache 2nd-level cache: 128 KBytes, 4= -way set associative, 32 byte line size
0x42 Cache 2nd-level cache: 256 KBytes, 4= -way set associative, 32 byte line size
0x43 Cache 2nd-level cache: 512 KBytes, 4= -way set associative, 32 byte line size
0x44 Cache 2nd-level cache: 1 MByte, 4-wa= y set associative, 32 byte line size
0x45 Cache 2nd-level cache: 2 MByte, 4-wa= y set associative, 32 byte line size
0x46 Cache 3rd-level cache: 4 MByte, 4-wa= y set associative, 64 byte line size
0x47 Cache 3rd-level cache: 8 MByte, 8-wa= y set associative, 64 byte line size
0x48 Cache 2nd-level cache: 3MByte, 12-wa= y set associative, 64 byte line size
0x49 Cache 3rd-level cache: 4MB, 16-way s= et associative, 64-byte line size + (Intel Xeon processor MP, Fami= ly 0FH, Model 06H)
+ 2nd-level cache: 4 MByte, 16-w= ay set associative, 64 byte line size
0x4A Cache 3rd-level cache: 6MByte, 12-wa= y set associative, 64 byte line size
0x4B Cache 3rd-level cache: 8MByte, 16-wa= y set associative, 64 byte line size
0x4C Cache 3rd-level cache: 12MByte, 12-w= ay set associative, 64 byte line size
0x4D Cache 3rd-level cache: 16MByte, 16-w= ay set associative, 64 byte line size
0x4E Cache 2nd-level cache: 6MByte, 24-wa= y set associative, 64 byte line size
0x4F TLB Instruction TLB: 4 KByte pages= , 32 entries
0x50 TLB Instruction TLB: 4 KByte and 2= -MByte or 4-MByte pages, 64 entries
0x51 TLB Instruction TLB: 4 KByte and 2= -MByte or 4-MByte pages, 128 entries
0x52 TLB Instruction TLB: 4 KByte and 2= -MByte or 4-MByte pages, 256 entries
0x55 TLB Instruction TLB: 2-MByte or 4-= MByte pages, fully associative, 7 entries
0x56 TLB Data TLB0: 4 MByte pages, 4-wa= y set associative, 16 entries
0x57 TLB Data TLB0: 4 KByte pages, 4-wa= y associative, 16 entries
0x59 TLB Data TLB0: 4 KByte pages, full= y associative, 16 entries
0x5A TLB Data TLB0: 2 MByte or 4 MByte = pages, 4-way set associative, 32 entries
0x5B TLB Data TLB: 4 KByte and 4 MByte = pages, 64 entries
0x5C TLB Data TLB: 4 KByte and 4 MByte = pages,128 entries
0x5D TLB Data TLB: 4 KByte and 4 MByte = pages,256 entries
0x60 Cache 1st-level data cache: 16 KByte= , 8-way set associative, 64 byte line size
0x61 TLB Instruction TLB: 4 KByte pages= , fully associative, 48 entries
0x63 TLB Data TLB: 2 MByte or 4 MByte p= ages, 4-way set associative, + 32 entries and a separate arra= y with 1 GByte pages, 4-way set associative, + 4 entries
0x64 TLB Data TLB: 4 KByte pages, 4-way= set associative, 512 entries
0x66 Cache 1st-level data cache: 8 KByte,= 4-way set associative, 64 byte line size
0x67 Cache 1st-level data cache: 16 KByte= , 4-way set associative, 64 byte line size
0x68 Cache 1st-level data cache: 32 KByte= , 4-way set associative, 64 byte line size
0x6A Cache uTLB: 4 KByte pages, 8-way set= associative, 64 entries
0x6B Cache DTLB: 4 KByte pages, 8-way set= associative, 256 entries
0x6C Cache DTLB: 2M/4M pages, 8-way set a= ssociative, 128 entries
0x6D Cache DTLB: 1 GByte pages, fully ass= ociative, 16 entries
0x70 Cache Trace cache: 12 K-uop, 8-way s= et associative
0x71 Cache Trace cache: 16 K-uop, 8-way s= et associative
0x72 Cache Trace cache: 32 K-uop, 8-way s= et associative
0x76 TLB Instruction TLB: 2M/4M pages, = fully associative, 8 entries
0x78 Cache 2nd-level cache: 1 MByte, 4-wa= y set associative, 64byte line size
0x79 Cache 2nd-level cache: 128 KByte, 8-= way set associative, 64 byte line size, + 2 lines per sector
0x7A Cache 2nd-level cache: 256 KByte, 8-= way set associative, 64 byte line size, + 2 lines per sector
0x7B Cache 2nd-level cache: 512 KByte, 8-= way set associative, 64 byte line size, + 2 lines per sector
0x7C Cache 2nd-level cache: 1 MByte, 8-wa= y set associative, 64 byte line size, + 2 lines per sector
0x7D Cache 2nd-level cache: 2 MByte, 8-wa= y set associative, 64byte line size
0x7F Cache 2nd-level cache: 512 KByte, 2-= way set associative, 64-byte line size
0x80 Cache 2nd-level cache: 512 KByte, 8-= way set associative, 64-byte line size
0x82 Cache 2nd-level cache: 256 KByte, 8-= way set associative, 32 byte line size
0x83 Cache 2nd-level cache: 512 KByte, 8-= way set associative, 32 byte line size
0x84 Cache 2nd-level cache: 1 MByte, 8-wa= y set associative, 32 byte line size
0x85 Cache 2nd-level cache: 2 MByte, 8-wa= y set associative, 32 byte line size
0x86 Cache 2nd-level cache: 512 KByte, 4-= way set associative, 64 byte line size
0x87 Cache 2nd-level cache: 1 MByte, 8-wa= y set associative, 64 byte line size
0xA0 DTLB DTLB: 4k pages, fully associat= ive, 32 entries
0xB0 TLB Instruction TLB: 4 KByte pages= , 4-way set associative, 128 entries
0xB1 TLB Instruction TLB: 2M pages, 4-w= ay, 8 entries or 4M pages, 4-way, 4 entries
0xB2 TLB Instruction TLB: 4KByte pages,= 4-way set associative, 64 entries
0xB3 TLB Data TLB: 4 KByte pages, 4-way= set associative, 128 entries
0xB4 TLB Data TLB1: 4 KByte pages, 4-wa= y associative, 256 entries
0xB5 TLB Instruction TLB: 4KByte pages,= 8-way set associative, 64 entries
0xB6 TLB Instruction TLB: 4KByte pages,= 8-way set associative, + 128 entries
0xBA TLB Data TLB1: 4 KByte pages, 4-wa= y associative, 64 entries
0xC0 TLB Data TLB: 4 KByte and 4 MByte = pages, 4-way associative, 8 entries
0xC1 STLB Shared 2nd-Level TLB: 4 KByte/= 2MByte pages, 8-way associative, + 1024 entries
0xC2 DTLB DTLB: 4 KByte/2 MByte pages, 4= -way associative, 16 entries
0xC3 STLB Shared 2nd-Level TLB: 4 KByte = /2 MByte pages, 6-way associative, + 1536 entries. Also 1GBbyte pag= es, 4-way, 16 entries.
0xC4 DTLB DTLB: 2M/4M Byte pages, 4-way = associative, 32 entries
0xCA STLB Shared 2nd-Level TLB: 4 KByte = pages, 4-way associative, 512 entries
0xD0 Cache 3rd-level cache: 512 KByte, 4-= way set associative, 64 byte line size
0xD1 Cache 3rd-level cache: 1 MByte, 4-wa= y set associative, 64 byte line size
0xD2 Cache 3rd-level cache: 2 MByte, 4-wa= y set associative, 64 byte line size
0xD6 Cache 3rd-level cache: 1 MByte, 8-wa= y set associative, 64 byte line size
0xD7 Cache 3rd-level cache: 2 MByte, 8-wa= y set associative, 64 byte line size
0xD8 Cache 3rd-level cache: 4 MByte, 8-wa= y set associative, 64 byte line size
0xDC Cache 3rd-level cache: 1.5 MByte, 12= -way set associative, 64 byte line size
0xDD Cache 3rd-level cache: 3 MByte, 12-w= ay set associative, 64 byte line size
0xDE Cache 3rd-level cache: 6 MByte, 12-w= ay set associative, 64 byte line size
0xE2 Cache 3rd-level cache: 2 MByte, 16-w= ay set associative, 64 byte line size
0xE3 Cache 3rd-level cache: 4 MByte, 16-w= ay set associative, 64 byte line size
0xE4 Cache 3rd-level cache: 8 MByte, 16-w= ay set associative, 64 byte line size
0xEA Cache 3rd-level cache: 12MByte, 24-w= ay set associative, 64 byte line size
0xEB Cache 3rd-level cache: 18MByte, 24-w= ay set associative, 64 byte line size
0xEC Cache 3rd-level cache: 24MByte, 24-w= ay set associative, 64 byte line size
0xF0 Prefetch 64-Byte prefetching
0xF1 Prefetch 128-Byte prefetching
0xFE General CPUID leaf 2 does not report T= LB descriptor information; use CPUID + leaf 18H to query TLB and othe= r address translation parameters.
0xFF General CPUID leaf 2 does not report c= ache descriptor information, + use CPUID leaf 4 to query cach= e parameters
+**/ +#define CPUID_CACHE_INFO 0x02 + +/** + CPUID Cache and TLB Information returned in EAX, EBX, ECX, and EDX for C= PUID + leaf #CPUID_CACHE_INFO. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved:31; + /// + /// [Bit 31] If 0, then the cache descriptor bytes in the register are= valid. + /// if 1, then none of the cache descriptor bytes in the register are = valid. + /// + UINT32 NotValid:1; + } Bits; + /// + /// Array of Cache and TLB descriptor bytes + /// + UINT8 CacheDescriptor[4]; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_CACHE_INFO_CACHE_TLB; + + +/** + CPUID Processor Serial Number + + Processor serial number (PSN) is not supported in the Pentium 4 processor + or later. On all models, use the PSN flag (returned using CPUID) to che= ck + for PSN support before accessing the feature. + + @param EAX CPUID_SERIAL_NUMBER (0x03) + + @retval EAX Reserved. + @retval EBX Reserved. + @retval ECX Bits 31:0 of 96 bit processor serial number. (Available in + Pentium III processor only; otherwise, the value in this + register is reserved.) + @retval EDX Bits 63:32 of 96 bit processor serial number. (Available in + Pentium III processor only; otherwise, the value in this + register is reserved.) + + Example usage + @code + UINT32 Ecx; + UINT32 Edx; + + AsmCpuid (CPUID_SERIAL_NUMBER, NULL, NULL, &Ecx, &Edx); + @endcode +**/ +#define CPUID_SERIAL_NUMBER 0x03 + + +/** + CPUID Cache Parameters + + @param EAX CPUID_CACHE_PARAMS (0x04) + @param ECX Cache Level. Valid values start at 0. Software can enume= rate + the deterministic cache parameters for each level of the c= ache + hierarchy starting with an index value of 0, until the + parameters report the value associated with the CacheType + field in CPUID_CACHE_PARAMS_EAX is 0. + + @retval EAX Returns cache type information described by the type + CPUID_CACHE_PARAMS_EAX. + @retval EBX Returns cache line and associativity information described= by + the type CPUID_CACHE_PARAMS_EBX. + @retval ECX Returns the number of sets in the cache. + @retval EDX Returns cache WINVD/INVD behavior described by the type + CPUID_CACHE_PARAMS_EDX. + + Example usage + @code + UINT32 CacheLevel; + CPUID_CACHE_PARAMS_EAX Eax; + CPUID_CACHE_PARAMS_EBX Ebx; + UINT32 Ecx; + CPUID_CACHE_PARAMS_EDX Edx; + + CacheLevel =3D 0; + do { + AsmCpuidEx ( + CPUID_CACHE_PARAMS, CacheLevel, + &Eax.Uint32, &Ebx.Uint32, &Ecx, &Edx.Uint32 + ); + CacheLevel++; + } while (Eax.Bits.CacheType !=3D CPUID_CACHE_PARAMS_CACHE_TYPE_NULL); + @endcode +**/ +#define CPUID_CACHE_PARAMS 0x04 + +/** + CPUID Cache Parameters Information returned in EAX for CPUID leaf + #CPUID_CACHE_PARAMS. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 4:0] Cache type field. If #CPUID_CACHE_PARAMS_CACHE_TYPE_NU= LL, + /// then there is no information for the requested cache level. + /// + UINT32 CacheType:5; + /// + /// [Bits 7:5] Cache level (Starts at 1). + /// + UINT32 CacheLevel:3; + /// + /// [Bit 8] Self Initializing cache level (does not need SW initializa= tion). + /// + UINT32 SelfInitializingCache:1; + /// + /// [Bit 9] Fully Associative cache. + /// + UINT32 FullyAssociativeCache:1; + /// + /// [Bits 13:10] Reserved. + /// + UINT32 Reserved:4; + /// + /// [Bits 25:14] Maximum number of addressable IDs for logical process= ors + /// sharing this cache. + /// + /// Add one to the return value to get the result. + /// The nearest power-of-2 integer that is not smaller than (1 + EAX[2= 5:14]) + /// is the number of unique initial APIC IDs reserved for addressing + /// different logical processors sharing this cache. + /// + UINT32 MaximumAddressableIdsForLogicalProcessors:12; + /// + /// [Bits 31:26] Maximum number of addressable IDs for processor cores= in + /// the physical package. + /// + /// The nearest power-of-2 integer that is not smaller than (1 + EAX[3= 1:26]) + /// is the number of unique Core_IDs reserved for addressing different + /// processor cores in a physical package. Core ID is a subset of bits= of + /// the initial APIC ID. + /// The returned value is constant for valid initial values in ECX. Va= lid + /// ECX values start from 0. + /// + UINT32 MaximumAddressableIdsForProcessorCores:6; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_CACHE_PARAMS_EAX; + +/// +/// @{ Define value for bit field CPUID_CACHE_PARAMS_EAX.CacheType +/// +#define CPUID_CACHE_PARAMS_CACHE_TYPE_NULL 0x00 +#define CPUID_CACHE_PARAMS_CACHE_TYPE_DATA 0x01 +#define CPUID_CACHE_PARAMS_CACHE_TYPE_INSTRUCTION 0x02 +#define CPUID_CACHE_PARAMS_CACHE_TYPE_UNIFIED 0x03 +/// +/// @} +/// + +/** + CPUID Cache Parameters Information returned in EBX for CPUID leaf + #CPUID_CACHE_PARAMS. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 11:0] System Coherency Line Size. Add one to the return val= ue to + /// get the result. + /// + UINT32 LineSize:12; + /// + /// [Bits 21:12] Physical Line Partitions. Add one to the return valu= e to + /// get the result. + /// + UINT32 LinePartitions:10; + /// + /// [Bits 31:22] Ways of associativity. Add one to the return value t= o get + /// the result. + /// + UINT32 Ways:10; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_CACHE_PARAMS_EBX; + +/** + CPUID Cache Parameters Information returned in EDX for CPUID leaf + #CPUID_CACHE_PARAMS. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Write-Back Invalidate/Invalidate. + /// 0 =3D WBINVD/INVD from threads sharing this cache acts upon lower = level + /// caches for threads sharing this cache. + /// 1 =3D WBINVD/INVD is not guaranteed to act upon lower level caches= of + /// non-originating threads sharing this cache. + /// + UINT32 Invalidate:1; + /// + /// [Bit 1] Cache Inclusiveness. + /// 0 =3D Cache is not inclusive of lower cache levels. + /// 1 =3D Cache is inclusive of lower cache levels. + /// + UINT32 CacheInclusiveness:1; + /// + /// [Bit 2] Complex Cache Indexing. + /// 0 =3D Direct mapped cache. + /// 1 =3D A complex function is used to index the cache, potentially u= sing all + /// address bits. + /// + UINT32 ComplexCacheIndexing:1; + UINT32 Reserved:29; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_CACHE_PARAMS_EDX; + + +/** + CPUID MONITOR/MWAIT Information + + @param EAX CPUID_MONITOR_MWAIT (0x05) + + @retval EAX Smallest monitor-line size in bytes described by the type + CPUID_MONITOR_MWAIT_EAX. + @retval EBX Largest monitor-line size in bytes described by the type + CPUID_MONITOR_MWAIT_EBX. + @retval ECX Enumeration of Monitor-Mwait extensions support described = by + the type CPUID_MONITOR_MWAIT_ECX. + @retval EDX Sub C-states supported described by the type + CPUID_MONITOR_MWAIT_EDX. + + Example usage + @code + CPUID_MONITOR_MWAIT_EAX Eax; + CPUID_MONITOR_MWAIT_EBX Ebx; + CPUID_MONITOR_MWAIT_ECX Ecx; + CPUID_MONITOR_MWAIT_EDX Edx; + + AsmCpuid (CPUID_MONITOR_MWAIT, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &E= dx.Uint32); + @endcode +**/ +#define CPUID_MONITOR_MWAIT 0x05 + +/** + CPUID MONITOR/MWAIT Information returned in EAX for CPUID leaf + #CPUID_MONITOR_MWAIT. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Smallest monitor-line size in bytes (default is proces= sor's + /// monitor granularity). + /// + UINT32 SmallestMonitorLineSize:16; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_MONITOR_MWAIT_EAX; + +/** + CPUID MONITOR/MWAIT Information returned in EBX for CPUID leaf + #CPUID_MONITOR_MWAIT. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Largest monitor-line size in bytes (default is process= or's + /// monitor granularity). + /// + UINT32 LargestMonitorLineSize:16; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_MONITOR_MWAIT_EBX; + +/** + CPUID MONITOR/MWAIT Information returned in ECX for CPUID leaf + #CPUID_MONITOR_MWAIT. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] If 0, then only EAX and EBX are valid. If 1, then EAX, EB= X, ECX, + /// and EDX are valid. + /// + UINT32 ExtensionsSupported:1; + /// + /// [Bit 1] Supports treating interrupts as break-event for MWAIT, eve= n when + /// interrupts disabled. + /// + UINT32 InterruptAsBreak:1; + UINT32 Reserved:30; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_MONITOR_MWAIT_ECX; + +/** + CPUID MONITOR/MWAIT Information returned in EDX for CPUID leaf + #CPUID_MONITOR_MWAIT. + + @note + The definition of C0 through C7 states for MWAIT extension are + processor-specific C-states, not ACPI C-states. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 3:0] Number of C0 sub C-states supported using MWAIT. + /// + UINT32 C0States:4; + /// + /// [Bits 7:4] Number of C1 sub C-states supported using MWAIT. + /// + UINT32 C1States:4; + /// + /// [Bits 11:8] Number of C2 sub C-states supported using MWAIT. + /// + UINT32 C2States:4; + /// + /// [Bits 15:12] Number of C3 sub C-states supported using MWAIT. + /// + UINT32 C3States:4; + /// + /// [Bits 19:16] Number of C4 sub C-states supported using MWAIT. + /// + UINT32 C4States:4; + /// + /// [Bits 23:20] Number of C5 sub C-states supported using MWAIT. + /// + UINT32 C5States:4; + /// + /// [Bits 27:24] Number of C6 sub C-states supported using MWAIT. + /// + UINT32 C6States:4; + /// + /// [Bits 31:28] Number of C7 sub C-states supported using MWAIT. + /// + UINT32 C7States:4; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_MONITOR_MWAIT_EDX; + + +/** + CPUID Thermal and Power Management + + @param EAX CPUID_THERMAL_POWER_MANAGEMENT (0x06) + + @retval EAX Thermal and power management features described by the type + CPUID_THERMAL_POWER_MANAGEMENT_EAX. + @retval EBX Number of Interrupt Thresholds in Digital Thermal Sensor + described by the type CPUID_THERMAL_POWER_MANAGEMENT_EBX. + @retval ECX Performance features described by the type + CPUID_THERMAL_POWER_MANAGEMENT_ECX. + @retval EDX Reserved. + + Example usage + @code + CPUID_THERMAL_POWER_MANAGEMENT_EAX Eax; + CPUID_THERMAL_POWER_MANAGEMENT_EBX Ebx; + CPUID_THERMAL_POWER_MANAGEMENT_ECX Ecx; + + AsmCpuid (CPUID_THERMAL_POWER_MANAGEMENT, &Eax.Uint32, &Ebx.Uint32, &Ecx= .Uint32, NULL); + @endcode +**/ +#define CPUID_THERMAL_POWER_MANAGEMENT 0x06 + +/** + CPUID Thermal and Power Management Information returned in EAX for CPUID= leaf + #CPUID_THERMAL_POWER_MANAGEMENT. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Digital temperature sensor is supported if set. + /// + UINT32 DigitalTemperatureSensor:1; + /// + /// [Bit 1] Intel Turbo Boost Technology Available (see IA32_MISC_ENAB= LE[38]). + /// + UINT32 TurboBoostTechnology:1; + /// + /// [Bit 2] APIC-Timer-always-running feature is supported if set. + /// + UINT32 ARAT:1; + UINT32 Reserved1:1; + /// + /// [Bit 4] Power limit notification controls are supported if set. + /// + UINT32 PLN:1; + /// + /// [Bit 5] Clock modulation duty cycle extension is supported if set. + /// + UINT32 ECMD:1; + /// + /// [Bit 6] Package thermal management is supported if set. + /// + UINT32 PTM:1; + /// + /// [Bit 7] HWP base registers (IA32_PM_ENABLE[Bit 0], IA32_HWP_CAPABI= LITIES, + /// IA32_HWP_REQUEST, IA32_HWP_STATUS) are supported if set. + /// + UINT32 HWP:1; + /// + /// [Bit 8] IA32_HWP_INTERRUPT MSR is supported if set. + /// + UINT32 HWP_Notification:1; + /// + /// [Bit 9] IA32_HWP_REQUEST[Bits 41:32] is supported if set. + /// + UINT32 HWP_Activity_Window:1; + /// + /// [Bit 10] IA32_HWP_REQUEST[Bits 31:24] is supported if set. + /// + UINT32 HWP_Energy_Performance_Preference:1; + /// + /// [Bit 11] IA32_HWP_REQUEST_PKG MSR is supported if set. + /// + UINT32 HWP_Package_Level_Request:1; + UINT32 Reserved2:1; + /// + /// [Bit 13] HDC base registers IA32_PKG_HDC_CTL, IA32_PM_CTL1, + /// IA32_THREAD_STALL MSRs are supported if set. + /// + UINT32 HDC:1; + /// + /// [Bit 14] Intel Turbo Boost Max Technology 3.0 available. + /// + UINT32 TurboBoostMaxTechnology30:1; + /// + /// [Bit 15] HWP Capabilities. + /// Highest Performance change is supported if set. + /// + UINT32 HWPCapabilities:1; + /// + /// [Bit 16] HWP PECI override is supported if set. + /// + UINT32 HWPPECIOverride:1; + /// + /// [Bit 17] Flexible HWP is supported if set. + /// + UINT32 FlexibleHWP:1; + /// + /// [Bit 18] Fast access mode for the IA32_HWP_REQUEST MSR is supporte= d if set. + /// + UINT32 FastAccessMode:1; + UINT32 Reserved4:1; + /// + /// [Bit 20] Ignoring Idle Logical Processor HWP request is supported = if set. + /// + UINT32 IgnoringIdleLogicalProcessorHWPRequest:1; + UINT32 Reserved5:11; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_THERMAL_POWER_MANAGEMENT_EAX; + +/** + CPUID Thermal and Power Management Information returned in EBX for CPUID= leaf + #CPUID_THERMAL_POWER_MANAGEMENT. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// {Bits 3:0] Number of Interrupt Thresholds in Digital Thermal Senso= r. + /// + UINT32 InterruptThresholds:4; + UINT32 Reserved:28; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_THERMAL_POWER_MANAGEMENT_EBX; + +/** + CPUID Thermal and Power Management Information returned in ECX for CPUID= leaf + #CPUID_THERMAL_POWER_MANAGEMENT. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Hardware Coordination Feedback Capability (Presence of IA3= 2_MPERF + /// and IA32_APERF). The capability to provide a measure of delivered + /// processor performance (since last reset of the counters), as a per= centage + /// of the expected processor performance when running at the TSC freq= uency. + /// + UINT32 HardwareCoordinationFeedback:1; + UINT32 Reserved1:2; + /// + /// [Bit 3] If this bit is set, then the processor supports performanc= e-energy + /// bias preference and the architectural MSR called IA32_ENERGY_PERF_= BIAS + /// (1B0H). + /// + UINT32 PerformanceEnergyBias:1; + UINT32 Reserved2:28; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_THERMAL_POWER_MANAGEMENT_ECX; + + +/** + CPUID Structured Extended Feature Flags Enumeration + + @param EAX CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS (0x07) + @param ECX CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO (0x0= 0). + + @note + If ECX contains an invalid sub-leaf index, EAX/EBX/ECX/EDX return 0. Su= b-leaf + index n is invalid if n exceeds the value that sub-leaf 0 returns in EAX. + + @retval EAX The maximum input value for ECX to retrieve sub-leaf infor= mation. + @retval EBX Structured Extended Feature Flags described by the type + CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EBX. + @retval EBX Structured Extended Feature Flags described by the type + CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX. + @retval EDX Reserved. + + Example usage + @code + UINT32 Eax; + CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EBX Ebx; + CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX Ecx; + UINT32 SubLeaf; + + AsmCpuidEx ( + CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS, + CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO, + &Eax, NULL, NULL, NULL + ); + for (SubLeaf =3D 0; SubLeaf <=3D Eax; SubLeaf++) { + AsmCpuidEx ( + CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS, + SubLeaf, + NULL, &Ebx.Uint32, &Ecx.Uint32, NULL + ); + } + @endcode +**/ +#define CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS 0x07 + +/// +/// CPUID Structured Extended Feature Flags Enumeration sub-leaf +/// +#define CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO 0x00 + +/** + CPUID Structured Extended Feature Flags Enumeration in EBX for CPUID leaf + #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS sub leaf + #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Supports RDFSBASE/RDGSBASE/WRFSBASE/WRGSBASE if 1. + /// + UINT32 FSGSBASE:1; + /// + /// [Bit 1] IA32_TSC_ADJUST MSR is supported if 1. + /// + UINT32 IA32_TSC_ADJUST:1; + /// + /// [Bit 2] Intel SGX is supported if 1. See section 37.7 "DISCOVERING= SUPPORT + /// FOR INTEL(R) SGX AND ENABLING ENCLAVE INSTRUCTIONS". + /// + UINT32 SGX:1; + /// + /// [Bit 3] If 1 indicates the processor supports the first group of a= dvanced + /// bit manipulation extensions (ANDN, BEXTR, BLSI, BLSMSK, BLSR, TZCN= T) + /// + UINT32 BMI1:1; + /// + /// [Bit 4] Hardware Lock Elision + /// + UINT32 HLE:1; + /// + /// [Bit 5] If 1 indicates the processor supports AVX2 instruction ext= ensions. + /// + UINT32 AVX2:1; + /// + /// [Bit 6] x87 FPU Data Pointer updated only on x87 exceptions if 1. + /// + UINT32 FDP_EXCPTN_ONLY:1; + /// + /// [Bit 7] Supports Supervisor-Mode Execution Prevention if 1. + /// + UINT32 SMEP:1; + /// + /// [Bit 8] If 1 indicates the processor supports the second group of + /// advanced bit manipulation extensions (BZHI, MULX, PDEP, PEXT, RORX, + /// SARX, SHLX, SHRX) + /// + UINT32 BMI2:1; + /// + /// [Bit 9] Supports Enhanced REP MOVSB/STOSB if 1. + /// + UINT32 EnhancedRepMovsbStosb:1; + /// + /// [Bit 10] If 1, supports INVPCID instruction for system software th= at + /// manages process-context identifiers. + /// + UINT32 INVPCID:1; + /// + /// [Bit 11] Restricted Transactional Memory + /// + UINT32 RTM:1; + /// + /// [Bit 12] Supports Intel(R) Resource Director Technology (Intel(R) = RDT) + /// Monitoring capability if 1. + /// + UINT32 RDT_M:1; + /// + /// [Bit 13] Deprecates FPU CS and FPU DS values if 1. + /// + UINT32 DeprecateFpuCsDs:1; + /// + /// [Bit 14] Supports Intel(R) Memory Protection Extensions if 1. + /// + UINT32 MPX:1; + /// + /// [Bit 15] Supports Intel(R) Resource Director Technology (Intel(R) = RDT) + /// Allocation capability if 1. + /// + UINT32 RDT_A:1; + /// + /// [Bit 16] AVX512F. + /// + UINT32 AVX512F:1; + /// + /// [Bit 17] AVX512DQ. + /// + UINT32 AVX512DQ:1; + /// + /// [Bit 18] If 1 indicates the processor supports the RDSEED instruct= ion. + /// + UINT32 RDSEED:1; + /// + /// [Bit 19] If 1 indicates the processor supports the ADCX and ADOX + /// instructions. + /// + UINT32 ADX:1; + /// + /// [Bit 20] Supports Supervisor-Mode Access Prevention (and the CLAC/= STAC + /// instructions) if 1. + /// + UINT32 SMAP:1; + /// + /// [Bit 21] AVX512_IFMA. + /// + UINT32 AVX512_IFMA:1; + UINT32 Reserved6:1; + /// + /// [Bit 23] If 1 indicates the processor supports the CLFLUSHOPT inst= ruction. + /// + UINT32 CLFLUSHOPT:1; + /// + /// [Bit 24] If 1 indicates the processor supports the CLWB instructio= n. + /// + UINT32 CLWB:1; + /// + /// [Bit 25] If 1 indicates the processor supports the Intel Processor= Trace + /// extensions. + /// + UINT32 IntelProcessorTrace:1; + /// + /// [Bit 26] AVX512PF. (Intel Xeon Phi only.). + /// + UINT32 AVX512PF:1; + /// + /// [Bit 27] AVX512ER. (Intel Xeon Phi only.). + /// + UINT32 AVX512ER:1; + /// + /// [Bit 28] AVX512CD. + /// + UINT32 AVX512CD:1; + /// + /// [Bit 29] Supports Intel(R) Secure Hash Algorithm Extensions (Intel= (R) + /// SHA Extensions) if 1. + /// + UINT32 SHA:1; + /// + /// [Bit 30] AVX512BW. + /// + UINT32 AVX512BW:1; + /// + /// [Bit 31] AVX512VL. + /// + UINT32 AVX512VL:1; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EBX; + +/** + CPUID Structured Extended Feature Flags Enumeration in ECX for CPUID leaf + #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS sub leaf + #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] If 1 indicates the processor supports the PREFETCHWT1 inst= ruction. + /// (Intel Xeon Phi only.) + /// + UINT32 PREFETCHWT1:1; + /// + /// [Bit 1] AVX512_VBMI. + /// + UINT32 AVX512_VBMI:1; + /// + /// [Bit 2] Supports user-mode instruction prevention if 1. + /// + UINT32 UMIP:1; + /// + /// [Bit 3] Supports protection keys for user-mode pages if 1. + /// + UINT32 PKU:1; + /// + /// [Bit 4] If 1, OS has set CR4.PKE to enable protection keys (and the + /// RDPKRU/WRPKRU instructions). + /// + UINT32 OSPKE:1; + UINT32 Reserved5:9; + /// + /// [Bits 14] AVX512_VPOPCNTDQ. (Intel Xeon Phi only.). + /// + UINT32 AVX512_VPOPCNTDQ:1; + UINT32 Reserved7:1; + /// + /// [Bits 16] Supports 5-level paging if 1. + /// + UINT32 FiveLevelPage:1; + /// + /// [Bits 21:17] The value of MAWAU used by the BNDLDX and BNDSTX inst= ructions + /// in 64-bit mode. + /// + UINT32 MAWAU:5; + /// + /// [Bit 22] RDPID and IA32_TSC_AUX are available if 1. + /// + UINT32 RDPID:1; + UINT32 Reserved3:7; + /// + /// [Bit 30] Supports SGX Launch Configuration if 1. + /// + UINT32 SGX_LC:1; + UINT32 Reserved4:1; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX; + +/** + CPUID Structured Extended Feature Flags Enumeration in EDX for CPUID leaf + #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS sub leaf + #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 1:0] Reserved. + /// + UINT32 Reserved1:2; + /// + /// [Bit 2] AVX512_4VNNIW. (Intel Xeon Phi only.) + /// + UINT32 AVX512_4VNNIW:1; + /// + /// [Bit 3] AVX512_4FMAPS. (Intel Xeon Phi only.) + /// + UINT32 AVX512_4FMAPS:1; + /// + /// [Bit 25:4] Reserved. + /// + UINT32 Reserved2:22; + /// + /// [Bit 26] Enumerates support for indirect branch restricted specula= tion + /// (IBRS) and the indirect branch pre-dictor barrier (IBPB). Processo= rs + /// that set this bit support the IA32_SPEC_CTRL MSR and the IA32_PRED= _CMD + /// MSR. They allow software to set IA32_SPEC_CTRL[0] (IBRS) and + /// IA32_PRED_CMD[0] (IBPB). + /// + UINT32 EnumeratesSupportForIBRSAndIBPB:1; + /// + /// [Bit 27] Enumerates support for single thread indirect branch + /// predictors (STIBP). Processors that set this bit support the + /// IA32_SPEC_CTRL MSR. They allow software to set IA32_SPEC_CTRL[1] + /// (STIBP). + /// + UINT32 EnumeratesSupportForSTIBP:1; + /// + /// [Bit 28] Enumerates support for L1D_FLUSH. Processors that set thi= s bit + /// support the IA32_FLUSH_CMD MSR. They allow software to set + /// IA32_FLUSH_CMD[0] (L1D_FLUSH). + /// + UINT32 EnumeratesSupportForL1D_FLUSH:1; + /// + /// [Bit 29] Enumerates support for the IA32_ARCH_CAPABILITIES MSR. + /// + UINT32 EnumeratesSupportForCapability:1; + /// + /// [Bit 30] Reserved. + /// + UINT32 Reserved3:1; + /// + /// [Bit 31] Enumerates support for Speculative Store Bypass Disable (= SSBD). + /// Processors that set this bit sup-port the IA32_SPEC_CTRL MSR. They= allow + /// software to set IA32_SPEC_CTRL[2] (SSBD). + /// + UINT32 EnumeratesSupportForSSBD:1; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EDX; + +/** + CPUID Direct Cache Access Information + + @param EAX CPUID_DIRECT_CACHE_ACCESS_INFO (0x09) + + @retval EAX Value of bits [31:0] of IA32_PLATFORM_DCA_CAP MSR (address= 1F8H). + @retval EBX Reserved. + @retval ECX Reserved. + @retval EDX Reserved. + + Example usage + @code + UINT32 Eax; + + AsmCpuid (CPUID_DIRECT_CACHE_ACCESS_INFO, &Eax, NULL, NULL, NULL); + @endcode +**/ +#define CPUID_DIRECT_CACHE_ACCESS_INFO 0x09 + + +/** + CPUID Architectural Performance Monitoring + + @param EAX CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING (0x0A) + + @retval EAX Architectural Performance Monitoring information described= by + the type CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EAX. + @retval EBX Architectural Performance Monitoring information described= by + the type CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EBX. + @retval ECX Reserved. + @retval EDX Architectural Performance Monitoring information described= by + the type CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EDX. + + Example usage + @code + CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EAX Eax; + CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EBX Ebx; + CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EDX Edx; + + AsmCpuid (CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING, &Eax.Uint32, &Ebx.= Uint32, NULL, &Edx.Uint32); + @endcode +**/ +#define CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING 0x0A + +/** + CPUID Architectural Performance Monitoring EAX for CPUID leaf + #CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 7:0] Version ID of architectural performance monitoring. + /// + UINT32 ArchPerfMonVerID:8; + /// + /// [Bits 15:8] Number of general-purpose performance monitoring count= er + /// per logical processor. + /// + /// IA32_PERFEVTSELx MSRs start at address 186H and occupy a contiguous + /// block of MSR address space. Each performance event select register= is + /// paired with a corresponding performance counter in the 0C1H address + /// block. + /// + UINT32 PerformanceMonitorCounters:8; + /// + /// [Bits 23:16] Bit width of general-purpose, performance monitoring = counter. + /// + /// The bit width of an IA32_PMCx MSR. This the number of valid bits f= or + /// read operation. On write operations, the lower-order 32 bits of th= e MSR + /// may be written with any value, and the high-order bits are sign-ex= tended + /// from the value of bit 31. + /// + UINT32 PerformanceMonitorCounterWidth:8; + /// + /// [Bits 31:24] Length of EBX bit vector to enumerate architectural + /// performance monitoring events. + /// + UINT32 EbxBitVectorLength:8; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EAX; + +/** + CPUID Architectural Performance Monitoring EBX for CPUID leaf + #CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Core cycle event not available if 1. + /// + UINT32 UnhaltedCoreCycles:1; + /// + /// [Bit 1] Instruction retired event not available if 1. + /// + UINT32 InstructionsRetired:1; + /// + /// [Bit 2] Reference cycles event not available if 1. + /// + UINT32 UnhaltedReferenceCycles:1; + /// + /// [Bit 3] Last-level cache reference event not available if 1. + /// + UINT32 LastLevelCacheReferences:1; + /// + /// [Bit 4] Last-level cache misses event not available if 1. + /// + UINT32 LastLevelCacheMisses:1; + /// + /// [Bit 5] Branch instruction retired event not available if 1. + /// + UINT32 BranchInstructionsRetired:1; + /// + /// [Bit 6] Branch mispredict retired event not available if 1. + /// + UINT32 AllBranchMispredictRetired:1; + UINT32 Reserved:25; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EBX; + +/** + CPUID Architectural Performance Monitoring EDX for CPUID leaf + #CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 4:0] Number of fixed-function performance counters + /// (if Version ID > 1). + /// + UINT32 FixedFunctionPerformanceCounters:5; + /// + /// [Bits 12:5] Bit width of fixed-function performance counters + /// (if Version ID > 1). + /// + UINT32 FixedFunctionPerformanceCounterWidth:8; + UINT32 Reserved1:2; + /// + /// [Bits 15] AnyThread deprecation. + /// + UINT32 AnyThreadDeprecation:1; + UINT32 Reserved2:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EDX; + + +/** + CPUID Extended Topology Information + + @note + CPUID leaf 1FH is a preferred superset to leaf 0BH. Intel recommends fir= st + checking for the existence of Leaf 1FH before using leaf 0BH. + Most of Leaf 0BH output depends on the initial value in ECX. The EDX ou= tput + of leaf 0BH is always valid and does not vary with input value in ECX. = Output + value in ECX[7:0] always equals input value in ECX[7:0]. + Sub-leaf index 0 enumerates SMT level. Each subsequent higher sub-leaf i= ndex + enumerates a higher-level topological entity in hierarchical order. + For sub-leaves that return an invalid level-type of 0 in ECX[15:8]; EAX = and + EBX will return 0. + If an input value n in ECX returns the invalid level-type of 0 in ECX[15= :8], + other input values with ECX > n also return 0 in ECX[15:8]. + + @param EAX CPUID_EXTENDED_TOPOLOGY (0x0B) + @param ECX Level number + + @retval EAX Extended topology information described by the type + CPUID_EXTENDED_TOPOLOGY_EAX. + @retval EBX Extended topology information described by the type + CPUID_EXTENDED_TOPOLOGY_EBX. + @retval ECX Extended topology information described by the type + CPUID_EXTENDED_TOPOLOGY_ECX. + @retval EDX x2APIC ID the current logical processor. + + Example usage + @code + CPUID_EXTENDED_TOPOLOGY_EAX Eax; + CPUID_EXTENDED_TOPOLOGY_EBX Ebx; + CPUID_EXTENDED_TOPOLOGY_ECX Ecx; + UINT32 Edx; + UINT32 LevelNumber; + + LevelNumber =3D 0; + do { + AsmCpuidEx ( + CPUID_EXTENDED_TOPOLOGY, LevelNumber, + &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx + ); + LevelNumber++; + } while (Eax.Bits.ApicIdShift !=3D 0); + @endcode +**/ +#define CPUID_EXTENDED_TOPOLOGY 0x0B + +/** + CPUID Extended Topology Information EAX for CPUID leaf #CPUID_EXTENDED_T= OPOLOGY. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 4:0] Number of bits to shift right on x2APIC ID to get a uni= que + /// topology ID of the next level type. All logical processors with t= he + /// same next level ID share current level. + /// + /// @note + /// Software should use this field (EAX[4:0]) to enumerate processor + /// topology of the system. + /// + UINT32 ApicIdShift:5; + UINT32 Reserved:27; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_TOPOLOGY_EAX; + +/** + CPUID Extended Topology Information EBX for CPUID leaf #CPUID_EXTENDED_T= OPOLOGY. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Number of logical processors at this level type. The n= umber + /// reflects configuration as shipped by Intel. + /// + /// @note + /// Software must not use EBX[15:0] to enumerate processor topology of= the + /// system. This value in this field (EBX[15:0]) is only intended for + /// display/diagnostic purposes. The actual number of logical processo= rs + /// available to BIOS/OS/Applications may be different from the value = of + /// EBX[15:0], depending on software and platform hardware configurati= ons. + /// + UINT32 LogicalProcessors:16; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_TOPOLOGY_EBX; + +/** + CPUID Extended Topology Information ECX for CPUID leaf #CPUID_EXTENDED_T= OPOLOGY. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Level number. Same value in ECX input. + /// + UINT32 LevelNumber:8; + /// + /// [Bits 15:8] Level type. + /// + /// @note + /// The value of the "level type" field is not related to level number= s in + /// any way, higher "level type" values do not mean higher levels. + /// + UINT32 LevelType:8; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_TOPOLOGY_ECX; + +/// +/// @{ Define value for CPUID_EXTENDED_TOPOLOGY_ECX.LevelType +/// +#define CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_INVALID 0x00 +#define CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_SMT 0x01 +#define CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_CORE 0x02 +/// +/// @} +/// + + +/** + CPUID Extended State Information + + @param EAX CPUID_EXTENDED_STATE (0x0D) + @param ECX CPUID_EXTENDED_STATE_MAIN_LEAF (0x00). + CPUID_EXTENDED_STATE_SUB_LEAF (0x01). + CPUID_EXTENDED_STATE_SIZE_OFFSET (0x02). + Sub leafs 2..n based on supported bits in XCR0 or IA32_XSS= _MSR. +**/ +#define CPUID_EXTENDED_STATE 0x0D + +/** + CPUID Extended State Information Main Leaf + + @param EAX CPUID_EXTENDED_STATE (0x0D) + @param ECX CPUID_EXTENDED_STATE_MAIN_LEAF (0x00) + + @retval EAX Reports the supported bits of the lower 32 bits of XCR0. X= CR0[n] + can be set to 1 only if EAX[n] is 1. The format of the ex= tended + state main leaf is described by the type + CPUID_EXTENDED_STATE_MAIN_LEAF_EAX. + @retval EBX Maximum size (bytes, from the beginning of the XSAVE/XRSTO= R save + area) required by enabled features in XCR0. May be differe= nt than + ECX if some features at the end of the XSAVE save area are= not + enabled. + @retval ECX Maximum size (bytes, from the beginning of the XSAVE/XRSTO= R save + area) of the XSAVE/XRSTOR save area required by all suppor= ted + features in the processor, i.e., all the valid bit fields = in XCR0. + @retval EDX Reports the supported bits of the upper 32 bits of XCR0. + XCR0[n+32] can be set to 1 only if EDX[n] is 1. + + Example usage + @code + CPUID_EXTENDED_STATE_MAIN_LEAF_EAX Eax; + UINT32 Ebx; + UINT32 Ecx; + UINT32 Edx; + + AsmCpuidEx ( + CPUID_EXTENDED_STATE, CPUID_EXTENDED_STATE_MAIN_LEAF, + &Eax.Uint32, &Ebx, &Ecx, &Edx + ); + @endcode +**/ +#define CPUID_EXTENDED_STATE_MAIN_LEAF 0x00 + +/** + CPUID Extended State Information EAX for CPUID leaf #CPUID_EXTENDED_STAT= E, + sub-leaf #CPUID_EXTENDED_STATE_MAIN_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] x87 state. + /// + UINT32 x87:1; + /// + /// [Bit 1] SSE state. + /// + UINT32 SSE:1; + /// + /// [Bit 2] AVX state. + /// + UINT32 AVX:1; + /// + /// [Bits 4:3] MPX state. + /// + UINT32 MPX:2; + /// + /// [Bits 7:5] AVX-512 state. + /// + UINT32 AVX_512:3; + /// + /// [Bit 8] Used for IA32_XSS. + /// + UINT32 IA32_XSS:1; + /// + /// [Bit 9] PKRU state. + /// + UINT32 PKRU:1; + UINT32 Reserved1:3; + /// + /// [Bit 13] Used for IA32_XSS, part 2. + /// + UINT32 IA32_XSS_2:1; + UINT32 Reserved2:18; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_STATE_MAIN_LEAF_EAX; + +/** + CPUID Extended State Information Sub Leaf + + @param EAX CPUID_EXTENDED_STATE (0x0D) + @param ECX CPUID_EXTENDED_STATE_SUB_LEAF (0x01) + + @retval EAX The format of the extended state sub-leaf is described by = the + type CPUID_EXTENDED_STATE_SUB_LEAF_EAX. + @retval EBX The size in bytes of the XSAVE area containing all states + enabled by XCRO | IA32_XSS. + @retval ECX The format of the extended state sub-leaf is described by = the + type CPUID_EXTENDED_STATE_SUB_LEAF_ECX. + @retval EDX Reports the supported bits of the upper 32 bits of the + IA32_XSS MSR. IA32_XSS[n+32] can be set to 1 only if EDX[n= ] is 1. + + Example usage + @code + CPUID_EXTENDED_STATE_SUB_LEAF_EAX Eax; + UINT32 Ebx; + CPUID_EXTENDED_STATE_SUB_LEAF_ECX Ecx; + UINT32 Edx; + + AsmCpuidEx ( + CPUID_EXTENDED_STATE, CPUID_EXTENDED_STATE_SUB_LEAF, + &Eax.Uint32, &Ebx, &Ecx.Uint32, &Edx + ); + @endcode +**/ +#define CPUID_EXTENDED_STATE_SUB_LEAF 0x01 + +/** + CPUID Extended State Information EAX for CPUID leaf #CPUID_EXTENDED_STAT= E, + sub-leaf #CPUID_EXTENDED_STATE_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] XSAVEOPT is available. + /// + UINT32 XSAVEOPT:1; + /// + /// [Bit 1] Supports XSAVEC and the compacted form of XRSTOR if set. + /// + UINT32 XSAVEC:1; + /// + /// [Bit 2] Supports XGETBV with ECX =3D 1 if set. + /// + UINT32 XGETBV:1; + /// + /// [Bit 3] Supports XSAVES/XRSTORS and IA32_XSS if set. + /// + UINT32 XSAVES:1; + UINT32 Reserved:28; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_STATE_SUB_LEAF_EAX; + +/** + CPUID Extended State Information ECX for CPUID leaf #CPUID_EXTENDED_STAT= E, + sub-leaf #CPUID_EXTENDED_STATE_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Used for XCR0. + /// + UINT32 XCR0:1; + /// + /// [Bit 8] PT STate. + /// + UINT32 PT:1; + /// + /// [Bit 9] Used for XCR0. + /// + UINT32 XCR0_1:1; + UINT32 Reserved1:3; + /// + /// [Bit 13] HWP state. + /// + UINT32 HWPState:1; + UINT32 Reserved8:18; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_STATE_SUB_LEAF_ECX; + +/** + CPUID Extended State Information Size and Offset Sub Leaf + + @note + Leaf 0DH output depends on the initial value in ECX. + Each sub-leaf index (starting at position 2) is supported if it correspo= nds to + a supported bit in either the XCR0 register or the IA32_XSS MSR. + If ECX contains an invalid sub-leaf index, EAX/EBX/ECX/EDX return 0. Sub= -leaf + n (0 <=3D n <=3D 31) is invalid if sub-leaf 0 returns 0 in EAX[n] and su= b-leaf 1 + returns 0 in ECX[n]. Sub-leaf n (32 <=3D n <=3D 63) is invalid if sub-le= af 0 + returns 0 in EDX[n-32] and sub-leaf 1 returns 0 in EDX[n-32]. + + @param EAX CPUID_EXTENDED_STATE (0x0D) + @param ECX CPUID_EXTENDED_STATE_SIZE_OFFSET (0x02). Sub leafs 2..n b= ased + on supported bits in XCR0 or IA32_XSS_MSR. + + @retval EAX The size in bytes (from the offset specified in EBX) of th= e save + area for an extended state feature associated with a valid + sub-leaf index, n. + @retval EBX The offset in bytes of this extended state component's sav= e area + from the beginning of the XSAVE/XRSTOR area. This field r= eports + 0 if the sub-leaf index, n, does not map to a valid bit in= the + XCR0 register. + @retval ECX The format of the extended state components's save area as + described by the type CPUID_EXTENDED_STATE_SIZE_OFFSET_ECX. + This field reports 0 if the sub-leaf index, n, is invalid. + @retval EDX This field reports 0 if the sub-leaf index, n, is invalid; + otherwise it is reserved. + + Example usage + @code + UINT32 Eax; + UINT32 Ebx; + CPUID_EXTENDED_STATE_SIZE_OFFSET_ECX Ecx; + UINT32 Edx; + UINTN SubLeaf; + + for (SubLeaf =3D CPUID_EXTENDED_STATE_SIZE_OFFSET; SubLeaf < 32; SubLeaf= ++) { + AsmCpuidEx ( + CPUID_EXTENDED_STATE, SubLeaf, + &Eax, &Ebx, &Ecx.Uint32, &Edx + ); + } + @endcode +**/ +#define CPUID_EXTENDED_STATE_SIZE_OFFSET 0x02 + +/** + CPUID Extended State Information ECX for CPUID leaf #CPUID_EXTENDED_STAT= E, + sub-leaf #CPUID_EXTENDED_STATE_SIZE_OFFSET. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Is set if the bit n (corresponding to the sub-leaf index) = is + /// supported in the IA32_XSS MSR; it is clear if bit n is instead sup= ported + /// in XCR0. + /// + UINT32 XSS:1; + /// + /// [Bit 1] is set if, when the compacted format of an XSAVE area is u= sed, + /// this extended state component located on the next 64-byte boundary + /// following the preceding state component (otherwise, it is located + /// immediately following the preceding state component). + /// + UINT32 Compacted:1; + UINT32 Reserved:30; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_STATE_SIZE_OFFSET_ECX; + + +/** + CPUID Intel Resource Director Technology (Intel RDT) Monitoring Informat= ion + + @param EAX CPUID_INTEL_RDT_MONITORING (0x0F) + @param ECX CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF (0x00). + CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF (0x01). + +**/ +#define CPUID_INTEL_RDT_MONITORING 0x0F + +/** + CPUID Intel Resource Director Technology (Intel RDT) Monitoring Informat= ion + Enumeration Sub-leaf + + @param EAX CPUID_INTEL_RDT_MONITORING (0x0F) + @param ECX CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF (0x00) + + @retval EAX Reserved. + @retval EBX Maximum range (zero-based) of RMID within this physical + processor of all types. + @retval ECX Reserved. + @retval EDX L3 Cache Intel RDT Monitoring Information Enumeration desc= ribed by + the type CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF_E= DX. + + Example usage + @code + UINT32 Ebx; + CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF_EDX Edx; + + AsmCpuidEx ( + CPUID_INTEL_RDT_MONITORING, CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB= _LEAF, + NULL, &Ebx, NULL, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF 0x00 + +/** + CPUID Intel RDT Monitoring Information EDX for CPUID leaf + #CPUID_INTEL_RDT_MONITORING, sub-leaf + #CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved1:1; + /// + /// [Bit 1] Supports L3 Cache Intel RDT Monitoring if 1. + /// + UINT32 L3CacheRDT_M:1; + UINT32 Reserved2:30; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF_EDX; + +/** + CPUID L3 Cache Intel RDT Monitoring Capability Enumeration Sub-leaf + + @param EAX CPUID_INTEL_RDT_MONITORING (0x0F) + @param ECX CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF (0x01) + + @retval EAX Reserved. + @retval EBX Conversion factor from reported IA32_QM_CTR value to occup= ancy metric (bytes). + @retval ECX Maximum range (zero-based) of RMID of this resource type. + @retval EDX L3 Cache Intel RDT Monitoring Capability information descr= ibed by the + type CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF_EDX. + + Example usage + @code + UINT32 Ebx; + UINT32 Ecx; + CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF_EDX Edx; + + AsmCpuidEx ( + CPUID_INTEL_RDT_MONITORING, CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LE= AF, + NULL, &Ebx, &Ecx, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF 0x01 + +/** + CPUID L3 Cache Intel RDT Monitoring Capability Information EDX for CPUID= leaf + #CPUID_INTEL_RDT_MONITORING, sub-leaf + #CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Supports L3 occupancy monitoring if 1. + /// + UINT32 L3CacheOccupancyMonitoring:1; + /// + /// [Bit 1] Supports L3 Total Bandwidth monitoring if 1. + /// + UINT32 L3CacheTotalBandwidthMonitoring:1; + /// + /// [Bit 2] Supports L3 Local Bandwidth monitoring if 1. + /// + UINT32 L3CacheLocalBandwidthMonitoring:1; + UINT32 Reserved:29; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF_EDX; + + +/** + CPUID Intel Resource Director Technology (Intel RDT) Allocation Informat= ion + + @param EAX CPUID_INTEL_RDT_ALLOCATION (0x10). + @param ECX CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF (0x00). + CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF (0x01). + CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF (0x02). +**/ +#define CPUID_INTEL_RDT_ALLOCATION 0x10 + +/** + Intel Resource Director Technology (Intel RDT) Allocation Enumeration Su= b-leaf + + @param EAX CPUID_INTEL_RDT_ALLOCATION (0x10) + @param ECX CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF (0x00). + + @retval EAX Reserved. + @retval EBX L3 and L2 Cache Allocation Technology information describe= d by + the type CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF_E= BX. + @retval ECX Reserved. + @retval EDX Reserved. + + Example usage + @code + CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF_EBX Ebx; + + AsmCpuidEx ( + CPUID_INTEL_RDT_ALLOCATION, CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB= _LEAF, + NULL, &Ebx.Uint32, NULL, NULL + ); + @endcode +**/ +#define CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF 0x00 + +/** + CPUID L3 and L2 Cache Allocation Support Information EBX for CPUID leaf + #CPUID_INTEL_RDT_ALLOCATION, sub-leaf + #CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved1:1; + /// + /// [Bit 1] Supports L3 Cache Allocation Technology if 1. + /// + UINT32 L3CacheAllocation:1; + /// + /// [Bit 2] Supports L2 Cache Allocation Technology if 1. + /// + UINT32 L2CacheAllocation:1; + /// + /// [Bit 3] Supports Memory Bandwidth Allocation if 1. + /// + UINT32 MemoryBandwidth:1; + UINT32 Reserved3:28; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF_EBX; + + +/** + L3 Cache Allocation Technology Enumeration Sub-leaf + + @param EAX CPUID_INTEL_RDT_ALLOCATION (0x10) + @param ECX CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF (0x01) + + @retval EAX RESID L3 Cache Allocation Technology information described= by + the type CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EAX. + @retval EBX Bit-granular map of isolation/contention of allocation uni= ts. + @retval ECX RESID L3 Cache Allocation Technology information described= by + the type CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_ECX. + @retval EDX RESID L3 Cache Allocation Technology information described= by + the type CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EDX. + + Example usage + @code + CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EAX Eax; + UINT32 Ebx; + CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_ECX Ecx; + CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EDX Edx; + + AsmCpuidEx ( + CPUID_INTEL_RDT_ALLOCATION, CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LE= AF, + &Eax.Uint32, &Ebx, &Ecx.Uint32, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF 0x01 + +/** + CPUID L3 Cache Allocation Technology Information EAX for CPUID leaf + #CPUID_INTEL_RDT_ALLOCATION, sub-leaf + #CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 4:0] Length of the capacity bit mask for the corresponding R= esID + /// using minus-one notation. + /// + UINT32 CapacityLength:5; + UINT32 Reserved:27; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EAX; + +/** + CPUID L3 Cache Allocation Technology Information ECX for CPUID leaf + #CPUID_INTEL_RDT_ALLOCATION, sub-leaf + #CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved3:2; + /// + /// [Bit 2] Code and Data Prioritization Technology supported if 1. + /// + UINT32 CodeDataPrioritization:1; + UINT32 Reserved2:29; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_ECX; + +/** + CPUID L3 Cache Allocation Technology Information EDX for CPUID leaf + #CPUID_INTEL_RDT_ALLOCATION, sub-leaf + #CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Highest COS number supported for this ResID. + /// + UINT32 HighestCosNumber:16; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EDX; + +/** + L2 Cache Allocation Technology Enumeration Sub-leaf + + @param EAX CPUID_INTEL_RDT_ALLOCATION (0x10) + @param ECX CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF (0x02) + + @retval EAX RESID L2 Cache Allocation Technology information described= by + the type CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EAX. + @retval EBX Bit-granular map of isolation/contention of allocation uni= ts. + @retval ECX Reserved. + @retval EDX RESID L2 Cache Allocation Technology information described= by + the type CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EDX. + + Example usage + @code + CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EAX Eax; + UINT32 Ebx; + CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EDX Edx; + + AsmCpuidEx ( + CPUID_INTEL_RDT_ALLOCATION, CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LE= AF, + &Eax.Uint32, &Ebx, NULL, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF 0x02 + +/** + CPUID L2 Cache Allocation Technology Information EAX for CPUID leaf + #CPUID_INTEL_RDT_ALLOCATION, sub-leaf + #CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 4:0] Length of the capacity bit mask for the corresponding R= esID + /// using minus-one notation. + /// + UINT32 CapacityLength:5; + UINT32 Reserved:27; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EAX; + +/** + CPUID L2 Cache Allocation Technology Information EDX for CPUID leaf + #CPUID_INTEL_RDT_ALLOCATION, sub-leaf + #CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Highest COS number supported for this ResID. + /// + UINT32 HighestCosNumber:16; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EDX; + +/** + Memory Bandwidth Allocation Enumeration Sub-leaf + + @param EAX CPUID_INTEL_RDT_ALLOCATION (0x10) + @param ECX CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF (0x03) + + @retval EAX RESID memory bandwidth Allocation Technology information + described by the type + CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EAX. + @retval EBX Reserved. + @retval ECX RESID memory bandwidth Allocation Technology information + described by the type + CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_ECX. + @retval EDX RESID memory bandwidth Allocation Technology information + described by the type + CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EDX. + + Example usage + @code + CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EAX Eax; + UINT32 Ebx; + CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_ECX Ecx; + CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EDX Edx; + + + AsmCpuidEx ( + CPUID_INTEL_RDT_ALLOCATION, CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDT= H_SUB_LEAF, + &Eax.Uint32, &Ebx, NULL, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF 0x03 + +/** + CPUID memory bandwidth Allocation Technology Information EAX for CPUID l= eaf + #CPUID_INTEL_RDT_ALLOCATION, sub-leaf + #CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 11:0] Reports the maximum MBA throttling value supported for + /// the corresponding ResID using minus-one notation. + /// + UINT32 MaximumMBAThrottling:12; + UINT32 Reserved:20; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EAX; + +/** + CPUID memory bandwidth Allocation Technology Information ECX for CPUID l= eaf + #CPUID_INTEL_RDT_ALLOCATION, sub-leaf + #CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 1:0] Reserved. + /// + UINT32 Reserved1:2; + /// + /// [Bits 3] Reports whether the response of the delay values is linea= r. + /// + UINT32 Liner:1; + UINT32 Reserved2:29; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_ECX; + +/** + CPUID memory bandwidth Allocation Technology Information EDX for CPUID l= eaf + #CPUID_INTEL_RDT_ALLOCATION, sub-leaf + #CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Highest COS number supported for this ResID. + /// + UINT32 HighestCosNumber:16; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EDX; + +/** + Intel SGX resource capability and configuration. + See Section 37.7.2 "Intel(R) SGX Resource Enumeration Leaves". + + If CPUID.(EAX=3D07H, ECX=3D0H):EBX.SGX =3D 1, the processor also support= s querying + CPUID with EAX=3D12H on Intel SGX resource capability and configuration. + + @param EAX CPUID_INTEL_SGX (0x12) + @param ECX CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF (0x00). + CPUID_INTEL_SGX_CAPABILITIES_1_SUB_LEAF (0x01). + CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF (0x02). + Sub leafs 2..n based on the sub-leaf-type encoding (return= ed in EAX[3:0]) + until the sub-leaf type is invalid. + +**/ +#define CPUID_INTEL_SGX 0x12 + +/** + Sub-Leaf 0 Enumeration of Intel SGX Capabilities. + Enumerates Intel SGX capability, including enclave instruction opcode su= pport. + + @param EAX CPUID_INTEL_SGX (0x12) + @param ECX CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF (0x00) + + @retval EAX The format of Sub-Leaf 0 Enumeration of Intel SGX Capabili= ties is + described by the type CPUID_INTEL_SGX_CAPABILITIES_0_SUB_L= EAF_EAX. + @retval EBX MISCSELECT: Reports the bit vector of supported extended f= eatures + that can be written to the MISC region of the SSA. + @retval ECX Reserved. + @retval EDX The format of Sub-Leaf 0 Enumeration of Intel SGX Capabili= ties is + described by the type CPUID_INTEL_SGX_CAPABILITIES_0_SUB_L= EAF_EDX. + + Example usage + @code + CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF_EAX Eax; + UINT32 Ebx; + CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF_EDX Edx; + + AsmCpuidEx ( + CPUID_INTEL_SGX, CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF, + &Eax.Uint32, &Ebx, NULL, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF 0x00 + +/** + Sub-Leaf 0 Enumeration of Intel SGX Capabilities EAX for CPUID leaf #CPU= ID_INTEL_SGX, + sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] If 1, indicates leaf functions of SGX1 instruction are sup= ported. + /// + UINT32 SGX1:1; + /// + /// [Bit 1] If 1, indicates leaf functions of SGX2 instruction are sup= ported. + /// + UINT32 SGX2:1; + UINT32 Reserved1:3; + /// + /// [Bit 5] If 1, indicates Intel SGX supports ENCLV instruction leaves + /// EINCVIRTCHILD, EDECVIRTCHILD, and ESETCONTEXT. + /// + UINT32 ENCLV:1; + /// + /// [Bit 6] If 1, indicates Intel SGX supports ENCLS instruction leave= s ETRACKC, + /// ERDINFO, ELDBC, and ELDUC. + /// + UINT32 ENCLS:1; + UINT32 Reserved2:25; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF_EAX; + +/** + Sub-Leaf 0 Enumeration of Intel SGX Capabilities EDX for CPUID leaf #CPU= ID_INTEL_SGX, + sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 7:0] The maximum supported enclave size is 2^(EDX[7:0]) bytes + /// when not in 64-bit mode. + /// + UINT32 MaxEnclaveSize_Not64:8; + /// + /// [Bit 15:8] The maximum supported enclave size is 2^(EDX[15:8]) byt= es + /// when operating in 64-bit mode. + /// + UINT32 MaxEnclaveSize_64:8; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF_EDX; + + +/** + Sub-Leaf 1 Enumeration of Intel SGX Capabilities. + Enumerates Intel SGX capability of processor state configuration and enc= lave + configuration in the SECS structure. + + @param EAX CPUID_INTEL_SGX (0x12) + @param ECX CPUID_INTEL_SGX_CAPABILITIES_1_SUB_LEAF (0x01) + + @retval EAX Report the valid bits of SECS.ATTRIBUTES[31:0] that softwa= re can + set with ECREATE. SECS.ATTRIBUTES[n] can be set to 1 using= ECREATE + only if EAX[n] is 1, where n < 32. + @retval EBX Report the valid bits of SECS.ATTRIBUTES[63:32] that softw= are can + set with ECREATE. SECS.ATTRIBUTES[n+32] can be set to 1 us= ing ECREATE + only if EBX[n] is 1, where n < 32. + @retval ECX Report the valid bits of SECS.ATTRIBUTES[95:64] that softw= are can + set with ECREATE. SECS.ATTRIBUTES[n+64] can be set to 1 us= ing ECREATE + only if ECX[n] is 1, where n < 32. + @retval EDX Report the valid bits of SECS.ATTRIBUTES[127:96] that soft= ware can + set with ECREATE. SECS.ATTRIBUTES[n+96] can be set to 1 us= ing ECREATE + only if EDX[n] is 1, where n < 32. + + Example usage + @code + UINT32 Eax; + UINT32 Ebx; + UINT32 Ecx; + UINT32 Edx; + + AsmCpuidEx ( + CPUID_INTEL_SGX, CPUID_INTEL_SGX_CAPABILITIES_1_SUB_LEAF, + &Eax, &Ebx, &Ecx, &Edx + ); + @endcode +**/ +#define CPUID_INTEL_SGX_CAPABILITIES_1_SUB_LEAF 0x01 + + +/** + Sub-Leaf Index 2 or Higher Enumeration of Intel SGX Resources. + Enumerates available EPC resources. + + @param EAX CPUID_INTEL_SGX (0x12) + @param ECX CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF (0x02) + + @retval EAX The format of Sub-Leaf Index 2 or Higher Enumeration of In= tel SGX + Resources is described by the type + CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EAX. + @retval EBX The format of Sub-Leaf Index 2 or Higher Enumeration of In= tel SGX + Resources is described by the type + CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EBX. + @retval EDX The format of Sub-Leaf Index 2 or Higher Enumeration of In= tel SGX + Resources is described by the type + CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_ECX. + @retval EDX The format of Sub-Leaf Index 2 or Higher Enumeration of In= tel SGX + Resources is described by the type + CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EDX. + + Example usage + @code + CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EAX Eax; + CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EBX Ebx; + CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_ECX Ecx; + CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EDX Edx; + + AsmCpuidEx ( + CPUID_INTEL_SGX, CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF, + &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF 0x02 + +/** + Sub-Leaf Index 2 or Higher Enumeration of Intel SGX Resources EAX for CP= UID + leaf #CPUID_INTEL_SGX, sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_= SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 3:0] Sub-leaf-type encoding. + /// 0000b: This sub-leaf is invalid, EBX:EAX and EDX:ECX report 0. + /// 0001b: This sub-leaf provides information on the Enclave Page Cach= e (EPC) + /// in EBX:EAX and EDX:ECX. + /// All other encoding are reserved. + /// + UINT32 SubLeafType:4; + UINT32 Reserved:8; + /// + /// [Bit 31:12] If EAX[3:0] =3D 0001b, these are bits 31:12 of the phy= sical address of + /// the base of the EPC section. + /// + UINT32 LowAddressOfEpcSection:20; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EAX; + +/** + Sub-Leaf Index 2 or Higher Enumeration of Intel SGX Resources EBX for CP= UID + leaf #CPUID_INTEL_SGX, sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_= SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 19:0] If EAX[3:0] =3D 0001b, these are bits 51:32 of the phys= ical address of + /// the base of the EPC section. + /// + UINT32 HighAddressOfEpcSection:20; + UINT32 Reserved:12; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EBX; + +/** + Sub-Leaf Index 2 or Higher Enumeration of Intel SGX Resources ECX for CP= UID + leaf #CPUID_INTEL_SGX, sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_= SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 3:0] The EPC section encoding. + /// 0000b: Not valid. + /// 0001b: The EPC section is confidentiality, integrity and replay pr= otected. + /// All other encoding are reserved. + /// + UINT32 EpcSection:4; + UINT32 Reserved:8; + /// + /// [Bit 31:12] If EAX[3:0] =3D 0001b, these are bits 31:12 of the siz= e of the + /// corresponding EPC section within the Processor Reserved Memory. + /// + UINT32 LowSizeOfEpcSection:20; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_ECX; + +/** + Sub-Leaf Index 2 or Higher Enumeration of Intel SGX Resources EDX for CP= UID + leaf #CPUID_INTEL_SGX, sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_= SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 19:0] If EAX[3:0] =3D 0001b, these are bits 51:32 of the size= of the + /// corresponding EPC section within the Processor Reserved Memory. + /// + UINT32 HighSizeOfEpcSection:20; + UINT32 Reserved:12; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EDX; + + +/** + CPUID Intel Processor Trace Information + + @param EAX CPUID_INTEL_PROCESSOR_TRACE (0x14) + @param ECX CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF (0x00). + CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF (0x01). + +**/ +#define CPUID_INTEL_PROCESSOR_TRACE 0x14 + +/** + CPUID Intel Processor Trace Information Main Leaf + + @param EAX CPUID_INTEL_PROCEDSSOR_TRACE (0x14) + @param ECX CPUID_INTEL_PROCEDSSOR_TRACE_MAIN_LEAF (0x00) + + @retval EAX Reports the maximum sub-leaf supported in leaf 14H. + @retval EBX Returns Intel processor trace information described by the + type CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_EBX. + @retval ECX Returns Intel processor trace information described by the + type CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_ECX. + @retval EDX Reserved. + + Example usage + @code + UINT32 Eax; + CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_EBX Ebx; + CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_ECX Ecx; + + AsmCpuidEx ( + CPUID_INTEL_PROCESSOR_TRACE, CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF, + &Eax, &Ebx.Uint32, &Ecx.Uint32, NULL + ); + @endcode +**/ +#define CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF 0x00 + +/** + CPUID Intel Processor Trace EBX for CPUID leaf #CPUID_INTEL_PROCESSOR_TR= ACE, + sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] If 1, indicates that IA32_RTIT_CTL.CR3Filter can be set to= 1, + /// and that IA32_RTIT_CR3_MATCH MSR can be accessed. + /// + UINT32 Cr3Filter:1; + /// + /// [Bit 1] If 1, indicates support of Configurable PSB and Cycle-Accu= rate + /// Mode. + /// + UINT32 ConfigurablePsb:1; + /// + /// [Bit 2] If 1, indicates support of IP Filtering, TraceStop filteri= ng, + /// and preservation of Intel PT MSRs across warm reset. + /// + UINT32 IpTraceStopFiltering:1; + /// + /// [Bit 3] If 1, indicates support of MTC timing packet and suppressi= on of + /// COFI-based packets. + /// + UINT32 Mtc:1; + /// + /// [Bit 4] If 1, indicates support of PTWRITE. Writes can set + /// IA32_RTIT_CTL[12] (PTWEn) and IA32_RTIT_CTL[5] (FUPonPTW), and PTW= RITE + /// can generate packets. + /// + UINT32 PTWrite:1; + /// + /// [Bit 5] If 1, indicates support of Power Event Trace. Writes can s= et + /// IA32_RTIT_CTL[4] (PwrEvtEn), enabling Power Event Trace packet + /// generation. + /// + UINT32 PowerEventTrace:1; + UINT32 Reserved:26; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_EBX; + +/** + CPUID Intel Processor Trace ECX for CPUID leaf #CPUID_INTEL_PROCESSOR_TR= ACE, + sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] If 1, Tracing can be enabled with IA32_RTIT_CTL.ToPA =3D 1= , hence + /// utilizing the ToPA output scheme; IA32_RTIT_OUTPUT_BASE and + /// IA32_RTIT_OUTPUT_MASK_PTRS MSRs can be accessed. + /// + UINT32 RTIT:1; + /// + /// [Bit 1] If 1, ToPA tables can hold any number of output entries, u= p to + /// the maximum allowed by the MaskOrTableOffset field of + /// IA32_RTIT_OUTPUT_MASK_PTRS. + /// + UINT32 ToPA:1; + /// + /// [Bit 2] If 1, indicates support of Single-Range Output scheme. + /// + UINT32 SingleRangeOutput:1; + /// + /// [Bit 3] If 1, indicates support of output to Trace Transport subsy= stem. + /// + UINT32 TraceTransportSubsystem:1; + UINT32 Reserved:27; + /// + /// [Bit 31] If 1, generated packets which contain IP payloads have LIP + /// values, which include the CS base component. + /// + UINT32 LIP:1; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_ECX; + + +/** + CPUID Intel Processor Trace Information Sub-leaf + + @param EAX CPUID_INTEL_PROCEDSSOR_TRACE (0x14) + @param ECX CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF (0x01) + + @retval EAX Returns Intel processor trace information described by the + type CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EAX. + @retval EBX Returns Intel processor trace information described by the + type CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EBX. + @retval ECX Reserved. + @retval EDX Reserved. + + Example usage + @code + UINT32 MaximumSubLeaf; + UINT32 SubLeaf; + CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EAX Eax; + CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EBX Ebx; + + AsmCpuidEx ( + CPUID_INTEL_PROCESSOR_TRACE, CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF, + &MaximumSubLeaf, NULL, NULL, NULL + ); + + for (SubLeaf =3D CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF; SubLeaf <=3D Maxi= mumSubLeaf; SubLeaf++) { + AsmCpuidEx ( + CPUID_INTEL_PROCESSOR_TRACE, SubLeaf, + &Eax.Uint32, &Ebx.Uint32, NULL, NULL + ); + } + @endcode +**/ +#define CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF 0x01 + +/** + CPUID Intel Processor Trace EAX for CPUID leaf #CPUID_INTEL_PROCESSOR_TR= ACE, + sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 2:0] Number of configurable Address Ranges for filtering. + /// + UINT32 ConfigurableAddressRanges:3; + UINT32 Reserved:13; + /// + /// [Bits 31:16] Bitmap of supported MTC period encodings + /// + UINT32 MtcPeriodEncodings:16; + + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EAX; + +/** + CPUID Intel Processor Trace EBX for CPUID leaf #CPUID_INTEL_PROCESSOR_TR= ACE, + sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Bitmap of supported Cycle Threshold value encodings. + /// + UINT32 CycleThresholdEncodings:16; + /// + /// [Bits 31:16] Bitmap of supported Configurable PSB frequency encodi= ngs. + /// + UINT32 PsbFrequencyEncodings:16; + + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EBX; + + +/** + CPUID Time Stamp Counter and Nominal Core Crystal Clock Information + + @note + If EBX[31:0] is 0, the TSC/"core crystal clock" ratio is not enumerated. + EBX[31:0]/EAX[31:0] indicates the ratio of the TSC frequency and the core + crystal clock frequency. + If ECX is 0, the nominal core crystal clock frequency is not enumerated. + "TSC frequency" =3D "core crystal clock frequency" * EBX/EAX. + The core crystal clock may differ from the reference clock, bus clock, o= r core + clock frequencies. + + @param EAX CPUID_TIME_STAMP_COUNTER (0x15) + + @retval EAX An unsigned integer which is the denominator of the + TSC/"core crystal clock" ratio + @retval EBX An unsigned integer which is the numerator of the + TSC/"core crystal clock" ratio. + @retval ECX An unsigned integer which is the nominal frequency + of the core crystal clock in Hz. + @retval EDX Reserved. + + Example usage + @code + UINT32 Eax; + UINT32 Ebx; + UINT32 Ecx; + + AsmCpuid (CPUID_TIME_STAMP_COUNTER, &Eax, &Ebx, &Ecx, NULL); + @endcode +**/ +#define CPUID_TIME_STAMP_COUNTER 0x15 + + +/** + CPUID Processor Frequency Information + + @note + Data is returned from this interface in accordance with the processor's + specification and does not reflect actual values. Suitable use of this d= ata + includes the display of processor information in like manner to the proc= essor + brand string and for determining the appropriate range to use when displ= aying + processor information e.g. frequency history graphs. The returned inform= ation + should not be used for any other purpose as the returned information doe= s not + accurately correlate to information / counters returned by other process= or + interfaces. While a processor may support the Processor Frequency Infor= mation + leaf, fields that return a value of zero are not supported. + + @param EAX CPUID_TIME_STAMP_COUNTER (0x16) + + @retval EAX Returns processor base frequency information described by = the + type CPUID_PROCESSOR_FREQUENCY_EAX. + @retval EBX Returns maximum frequency information described by the type + CPUID_PROCESSOR_FREQUENCY_EBX. + @retval ECX Returns bus frequency information described by the type + CPUID_PROCESSOR_FREQUENCY_ECX. + @retval EDX Reserved. + + Example usage + @code + CPUID_PROCESSOR_FREQUENCY_EAX Eax; + CPUID_PROCESSOR_FREQUENCY_EBX Ebx; + CPUID_PROCESSOR_FREQUENCY_ECX Ecx; + + AsmCpuid (CPUID_PROCESSOR_FREQUENCY, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint= 32, NULL); + @endcode +**/ +#define CPUID_PROCESSOR_FREQUENCY 0x16 + +/** + CPUID Processor Frequency Information EAX for CPUID leaf + #CPUID_PROCESSOR_FREQUENCY. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Processor Base Frequency (in MHz). + /// + UINT32 ProcessorBaseFrequency:16; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_PROCESSOR_FREQUENCY_EAX; + +/** + CPUID Processor Frequency Information EBX for CPUID leaf + #CPUID_PROCESSOR_FREQUENCY. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Maximum Frequency (in MHz). + /// + UINT32 MaximumFrequency:16; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_PROCESSOR_FREQUENCY_EBX; + +/** + CPUID Processor Frequency Information ECX for CPUID leaf + #CPUID_PROCESSOR_FREQUENCY. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Bus (Reference) Frequency (in MHz). + /// + UINT32 BusFrequency:16; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_PROCESSOR_FREQUENCY_ECX; + + +/** + CPUID SoC Vendor Information + + @param EAX CPUID_SOC_VENDOR (0x17) + @param ECX CPUID_SOC_VENDOR_MAIN_LEAF (0x00) + CPUID_SOC_VENDOR_BRAND_STRING1 (0x01) + CPUID_SOC_VENDOR_BRAND_STRING1 (0x02) + CPUID_SOC_VENDOR_BRAND_STRING1 (0x03) + + @note + Leaf 17H output depends on the initial value in ECX. SOC Vendor Brand S= tring + is a UTF-8 encoded string padded with trailing bytes of 00H. The comple= te SOC + Vendor Brand String is constructed by concatenating in ascending order of + EAX:EBX:ECX:EDX and from the sub-leaf 1 fragment towards sub-leaf 3. + +**/ +#define CPUID_SOC_VENDOR 0x17 + +/** + CPUID SoC Vendor Information + + @param EAX CPUID_SOC_VENDOR (0x17) + @param ECX CPUID_SOC_VENDOR_MAIN_LEAF (0x00) + + @retval EAX MaxSOCID_Index. Reports the maximum input value of support= ed + sub-leaf in leaf 17H. + @retval EBX Returns SoC Vendor information described by the type + CPUID_SOC_VENDOR_MAIN_LEAF_EBX. + @retval ECX Project ID. A unique number an SOC vendor assigns to its S= OC + projects. + @retval EDX Stepping ID. A unique number within an SOC project that an= SOC + vendor assigns. + + Example usage + @code + UINT32 Eax; + CPUID_SOC_VENDOR_MAIN_LEAF_EBX Ebx; + UINT32 Ecx; + UINT32 Edx; + + AsmCpuidEx ( + CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_MAIN_LEAF, + &Eax, &Ebx.Uint32, &Ecx, &Edx + ); + @endcode +**/ +#define CPUID_SOC_VENDOR_MAIN_LEAF 0x00 + +/** + CPUID SoC Vendor Information EBX for CPUID leaf #CPUID_SOC_VENDOR sub-le= af + #CPUID_SOC_VENDOR_MAIN_LEAF. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] SOC Vendor ID. + /// + UINT32 SocVendorId:16; + /// + /// [Bit 16] If 1, the SOC Vendor ID field is assigned via an industry + /// standard enumeration scheme. Otherwise, the SOC Vendor ID field is + /// assigned by Intel. + /// + UINT32 IsVendorScheme:1; + UINT32 Reserved:15; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_SOC_VENDOR_MAIN_LEAF_EBX; + +/** + CPUID SoC Vendor Information + + @param EAX CPUID_SOC_VENDOR (0x17) + @param ECX CPUID_SOC_VENDOR_BRAND_STRING1 (0x01) + + @retval EAX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + @retval EBX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + @retval ECX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + @retval EDX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + + Example usage + @code + CPUID_SOC_VENDOR_BRAND_STRING_DATA Eax; + CPUID_SOC_VENDOR_BRAND_STRING_DATA Ebx; + CPUID_SOC_VENDOR_BRAND_STRING_DATA Ecx; + CPUID_SOC_VENDOR_BRAND_STRING_DATA Edx; + + AsmCpuidEx ( + CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING1, + &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_SOC_VENDOR_BRAND_STRING1 0x01 + +/** + CPUID SoC Vendor Brand String for CPUID leafs #CPUID_SOC_VENDOR_BRAND_ST= RING1, + #CPUID_SOC_VENDOR_BRAND_STRING2, and #CPUID_SOC_VENDOR_BRAND_STRING3. +**/ +typedef union { + /// + /// 4 UTF-8 characters of Soc Vendor Brand String + /// + CHAR8 BrandString[4]; + /// + /// All fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_SOC_VENDOR_BRAND_STRING_DATA; + +/** + CPUID SoC Vendor Information + + @param EAX CPUID_SOC_VENDOR (0x17) + @param ECX CPUID_SOC_VENDOR_BRAND_STRING2 (0x02) + + @retval EAX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + @retval EBX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + @retval ECX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + @retval EDX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + + Example usage + @code + CPUID_SOC_VENDOR_BRAND_STRING_DATA Eax; + CPUID_SOC_VENDOR_BRAND_STRING_DATA Ebx; + CPUID_SOC_VENDOR_BRAND_STRING_DATA Ecx; + CPUID_SOC_VENDOR_BRAND_STRING_DATA Edx; + + AsmCpuidEx ( + CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING2, + &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_SOC_VENDOR_BRAND_STRING2 0x02 + +/** + CPUID SoC Vendor Information + + @param EAX CPUID_SOC_VENDOR (0x17) + @param ECX CPUID_SOC_VENDOR_BRAND_STRING3 (0x03) + + @retval EAX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + @retval EBX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + @retval ECX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + @retval EDX SOC Vendor Brand String. UTF-8 encoded string of type + CPUID_SOC_VENDOR_BRAND_STRING_DATA. + + Example usage + @code + CPUID_SOC_VENDOR_BRAND_STRING_DATA Eax; + CPUID_SOC_VENDOR_BRAND_STRING_DATA Ebx; + CPUID_SOC_VENDOR_BRAND_STRING_DATA Ecx; + CPUID_SOC_VENDOR_BRAND_STRING_DATA Edx; + + AsmCpuidEx ( + CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING3, + &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_SOC_VENDOR_BRAND_STRING3 0x03 + +/** + CPUID Deterministic Address Translation Parameters + + @note + Each sub-leaf enumerates a different address translation structure. + If ECX contains an invalid sub-leaf index, EAX/EBX/ECX/EDX return 0. Sub= -leaf + index n is invalid if n exceeds the value that sub-leaf 0 returns in EAX= . A + sub-leaf index is also invalid if EDX[4:0] returns 0. + Valid sub-leaves do not need to be contiguous or in any particular order= . A + valid sub-leaf may be in a higher input ECX value than an invalid sub-le= af or + than a valid sub-leaf of a higher or lower-level structure. + * Some unified TLBs will allow a single TLB entry to satisfy data read/w= rite + and instruction fetches. Others will require separate entries (e.g., one + loaded on data read/write and another loaded on an instruction fetch). + Please see the Intel 64 and IA-32 Architectures Optimization Reference M= anual + for details of a particular product. + ** Add one to the return value to get the result. + + @param EAX CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS (0x18) + @param ECX CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_MAIN_LE= AF (0x00) + CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_SUB_LEA= F (0x*) + +**/ +#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS 0x18 + +/** + CPUID Deterministic Address Translation Parameters + + @param EAX CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS (0x18) + @param ECX CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_MAIN_LE= AF (0x00) + + @retval EAX Reports the maximum input value of supported sub-leaf in l= eaf 18H. + @retval EBX Returns Deterministic Address Translation Parameters descr= ibed by + the type CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETER= S_EBX. + @retval ECX Number of Sets. + @retval EDX Returns Deterministic Address Translation Parameters descr= ibed by + the type CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETER= S_EDX. + + Example usage + @code + UINT32 Eax; + CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_EBX Ebx; + UINT32 Ecx; + CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_EDX Edx; + + AsmCpuidEx ( + CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS, + CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_MAIN_LEAF, + &Eax, &Ebx.Uint32, &Ecx, &Edx.Uint32 + ); + @endcode +**/ +#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_MAIN_LEAF 0x00 + +/** + CPUID Deterministic Address Translation Parameters EBX for CPUID leafs. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 0] 4K page size entries supported by this structure. + /// + UINT32 Page4K:1; + /// + /// [Bits 1] 2MB page size entries supported by this structure. + /// + UINT32 Page2M:1; + /// + /// [Bits 2] 4MB page size entries supported by this structure. + /// + UINT32 Page4M:1; + /// + /// [Bits 3] 1 GB page size entries supported by this structure. + /// + UINT32 Page1G:1; + /// + /// [Bits 7:4] Reserved. + /// + UINT32 Reserved1:4; + /// + /// [Bits 10:8] Partitioning (0: Soft partitioning between the logical + /// processors sharing this structure) + /// + UINT32 Partitioning:3; + /// + /// [Bits 15:11] Reserved. + /// + UINT32 Reserved2:5; + /// + /// [Bits 31:16] W =3D Ways of associativity. + /// + UINT32 Way:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_EBX; + +/** + CPUID Deterministic Address Translation Parameters EDX for CPUID leafs. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 4:0] Translation cache type field. + /// + UINT32 TranslationCacheType:5; + /// + /// [Bits 7:5] Translation cache level (starts at 1). + /// + UINT32 TranslationCacheLevel:3; + /// + /// [Bits 8] Fully associative structure. + /// + UINT32 FullyAssociative:1; + /// + /// [Bits 13:9] Reserved. + /// + UINT32 Reserved1:5; + /// + /// [Bits 25:14] Maximum number of addressable IDs for logical + /// processors sharing this translation cache. + /// + UINT32 MaximumNum:12; + /// + /// [Bits 31:26] Reserved. + /// + UINT32 Reserved2:6; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_EDX; + +/// +/// @{ Define value for CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS= _EDX.TranslationCacheType +/// +#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_TRANSLATION_C= ACHE_TYPE_INVALID 0x00 +#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_TRANSLATION_C= ACHE_TYPE_DATA_TLB 0x01 +#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_TRANSLATION_C= ACHE_TYPE_INSTRUCTION_TLB 0x02 +#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_TRANSLATION_C= ACHE_TYPE_UNIFIED_TLB 0x03 +/// +/// @} +/// + + +/** + CPUID V2 Extended Topology Enumeration Leaf + + @note + CPUID leaf 1FH is a preferred superset to leaf 0BH. Intel recommends fir= st checking + for the existence of Leaf 1FH and using this if available. + Most of Leaf 1FH output depends on the initial value in ECX. The EDX out= put of leaf + 1FH is always valid and does not vary with input value in ECX. Output va= lue in ECX[7:0] + always equals input value in ECX[7:0]. Sub-leaf index 0 enumerates SMT l= evel. Each + subsequent higher sub-leaf index enumerates a higher-level topological e= ntity in + hierarchical order. For sub-leaves that return an invalid level-type of = 0 in ECX[15:8]; + EAX and EBX will return 0. If an input value n in ECX returns the invali= d level-type of + 0 in ECX[15:8], other input values with ECX > n also return 0 in ECX[15:= 8]. + + Software should use this field (EAX[4:0]) to enumerate processor topolog= y of the system. + Software must not use EBX[15:0] to enumerate processor topology of the s= ystem. This value + in this field (EBX[15:0]) is only intended for display/diagnostic purpos= es. The actual + number of logical processors available to BIOS/OS/Applications may be di= fferent from the + value of EBX[15:0], depending on software and platform hardware configur= ations. + + @param EAX CPUID_V2_EXTENDED_TOPOLOGY (0x1F) + @param ECX Level number + +**/ +#define CPUID_V2_EXTENDED_TOPOLOGY 0x1F + +/// +/// @{ Define value for CPUID_EXTENDED_TOPOLOGY_ECX.LevelType +/// The value of the "level type" field is not related to level numbers in +/// any way, higher "level type" values do not mean higher levels. +/// +#define CPUID_V2_EXTENDED_TOPOLOGY_LEVEL_TYPE_MODULE 0x= 03 +#define CPUID_V2_EXTENDED_TOPOLOGY_LEVEL_TYPE_TILE 0x= 04 +#define CPUID_V2_EXTENDED_TOPOLOGY_LEVEL_TYPE_DIE 0x= 05 +/// +/// @} +/// + +/** + CPUID Extended Function + + @param EAX CPUID_EXTENDED_FUNCTION (0x80000000) + + @retval EAX Maximum Input Value for Extended Function CPUID Informatio= n. + @retval EBX Reserved. + @retval ECX Reserved. + @retval EDX Reserved. + + Example usage + @code + UINT32 Eax; + + AsmCpuid (CPUID_EXTENDED_FUNCTION, &Eax, NULL, NULL, NULL); + @endcode +**/ +#define CPUID_EXTENDED_FUNCTION 0x80000000 + + +/** + CPUID Extended Processor Signature and Feature Bits + + @param EAX CPUID_EXTENDED_CPU_SIG (0x80000001) + + @retval EAX CPUID_EXTENDED_CPU_SIG. + @retval EBX Reserved. + @retval ECX Extended Processor Signature and Feature Bits information + described by the type CPUID_EXTENDED_CPU_SIG_ECX. + @retval EDX Extended Processor Signature and Feature Bits information + described by the type CPUID_EXTENDED_CPU_SIG_EDX. + + Example usage + @code + UINT32 Eax; + CPUID_EXTENDED_CPU_SIG_ECX Ecx; + CPUID_EXTENDED_CPU_SIG_EDX Edx; + + AsmCpuid (CPUID_EXTENDED_CPU_SIG, &Eax, NULL, &Ecx.Uint32, &Edx.Uint32); + @endcode +**/ +#define CPUID_EXTENDED_CPU_SIG 0x80000001 + +/** + CPUID Extended Processor Signature and Feature Bits ECX for CPUID leaf + #CPUID_EXTENDED_CPU_SIG. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] LAHF/SAHF available in 64-bit mode. + /// + UINT32 LAHF_SAHF:1; + UINT32 Reserved1:4; + /// + /// [Bit 5] LZCNT. + /// + UINT32 LZCNT:1; + UINT32 Reserved2:2; + /// + /// [Bit 8] PREFETCHW. + /// + UINT32 PREFETCHW:1; + UINT32 Reserved3:23; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_CPU_SIG_ECX; + +/** + CPUID Extended Processor Signature and Feature Bits EDX for CPUID leaf + #CPUID_EXTENDED_CPU_SIG. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved1:11; + /// + /// [Bit 11] SYSCALL/SYSRET available in 64-bit mode. + /// + UINT32 SYSCALL_SYSRET:1; + UINT32 Reserved2:8; + /// + /// [Bit 20] Execute Disable Bit available. + /// + UINT32 NX:1; + UINT32 Reserved3:5; + /// + /// [Bit 26] 1-GByte pages are available if 1. + /// + UINT32 Page1GB:1; + /// + /// [Bit 27] RDTSCP and IA32_TSC_AUX are available if 1. + /// + UINT32 RDTSCP:1; + UINT32 Reserved4:1; + /// + /// [Bit 29] Intel(R) 64 Architecture available if 1. + /// + UINT32 LM:1; + UINT32 Reserved5:2; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_CPU_SIG_EDX; + + +/** + CPUID Processor Brand String + + @param EAX CPUID_BRAND_STRING1 (0x80000002) + + @retval EAX Processor Brand String in type CPUID_BRAND_STRING_DATA. + @retval EBX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + @retval ECX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + @retval EDX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + + Example usage + @code + CPUID_BRAND_STRING_DATA Eax; + CPUID_BRAND_STRING_DATA Ebx; + CPUID_BRAND_STRING_DATA Ecx; + CPUID_BRAND_STRING_DATA Edx; + + AsmCpuid (CPUID_BRAND_STRING1, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &E= dx.Uint32); + @endcode +**/ +#define CPUID_BRAND_STRING1 0x80000002 + +/** + CPUID Processor Brand String for CPUID leafs #CPUID_BRAND_STRING1, + #CPUID_BRAND_STRING2, and #CPUID_BRAND_STRING3. +**/ +typedef union { + /// + /// 4 ASCII characters of Processor Brand String + /// + CHAR8 BrandString[4]; + /// + /// All fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_BRAND_STRING_DATA; + +/** + CPUID Processor Brand String + + @param EAX CPUID_BRAND_STRING2 (0x80000003) + + @retval EAX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + @retval EBX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + @retval ECX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + @retval EDX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + + Example usage + @code + CPUID_BRAND_STRING_DATA Eax; + CPUID_BRAND_STRING_DATA Ebx; + CPUID_BRAND_STRING_DATA Ecx; + CPUID_BRAND_STRING_DATA Edx; + + AsmCpuid (CPUID_BRAND_STRING2, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &E= dx.Uint32); + @endcode +**/ +#define CPUID_BRAND_STRING2 0x80000003 + +/** + CPUID Processor Brand String + + @param EAX CPUID_BRAND_STRING3 (0x80000004) + + @retval EAX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + @retval EBX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + @retval ECX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + @retval EDX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. + + Example usage + @code + CPUID_BRAND_STRING_DATA Eax; + CPUID_BRAND_STRING_DATA Ebx; + CPUID_BRAND_STRING_DATA Ecx; + CPUID_BRAND_STRING_DATA Edx; + + AsmCpuid (CPUID_BRAND_STRING3, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &E= dx.Uint32); + @endcode +**/ +#define CPUID_BRAND_STRING3 0x80000004 + + +/** + CPUID Extended Cache information + + @param EAX CPUID_EXTENDED_CACHE_INFO (0x80000006) + + @retval EAX Reserved. + @retval EBX Reserved. + @retval ECX Extended cache information described by the type + CPUID_EXTENDED_CACHE_INFO_ECX. + @retval EDX Reserved. + + Example usage + @code + CPUID_EXTENDED_CACHE_INFO_ECX Ecx; + + AsmCpuid (CPUID_EXTENDED_CACHE_INFO, NULL, NULL, &Ecx.Uint32, NULL); + @endcode +**/ +#define CPUID_EXTENDED_CACHE_INFO 0x80000006 + +/** + CPUID Extended Cache information ECX for CPUID leaf #CPUID_EXTENDED_CACH= E_INFO. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Cache line size in bytes. + /// + UINT32 CacheLineSize:8; + UINT32 Reserved:4; + /// + /// [Bits 15:12] L2 Associativity field. Supported values are in the = range + /// #CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_DISABLED to + /// #CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_FULL + /// + UINT32 L2Associativity:4; + /// + /// [Bits 31:16] Cache size in 1K units. + /// + UINT32 CacheSize:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_CACHE_INFO_ECX; + +/// +/// @{ Define value for bit field CPUID_EXTENDED_CACHE_INFO_ECX.L2Associat= ivity +/// +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_DISABLED 0x00 +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_DIRECT_MAPPED 0x01 +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_2_WAY 0x02 +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_4_WAY 0x04 +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_8_WAY 0x06 +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_16_WAY 0x08 +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_32_WAY 0x0A +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_48_WAY 0x0B +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_64_WAY 0x0C +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_96_WAY 0x0D +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_128_WAY 0x0E +#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_FULL 0x0F +/// +/// @} +/// + +/** + CPUID Extended Time Stamp Counter information + + @param EAX CPUID_EXTENDED_TIME_STAMP_COUNTER (0x80000007) + + @retval EAX Reserved. + @retval EBX Reserved. + @retval ECX Reserved. + @retval EDX Extended time stamp counter (TSC) information described by= the + type CPUID_EXTENDED_TIME_STAMP_COUNTER_EDX. + + Example usage + @code + CPUID_EXTENDED_TIME_STAMP_COUNTER_EDX Edx; + + AsmCpuid (CPUID_EXTENDED_TIME_STAMP_COUNTER, NULL, NULL, NULL, &Edx.Uint= 32); + @endcode +**/ +#define CPUID_EXTENDED_TIME_STAMP_COUNTER 0x80000007 + +/** + CPUID Extended Time Stamp Counter information EDX for CPUID leaf + #CPUID_EXTENDED_TIME_STAMP_COUNTER. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved1:8; + /// + /// [Bit 8] Invariant TSC available if 1. + /// + UINT32 InvariantTsc:1; + UINT32 Reserved2:23; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_EXTENDED_TIME_STAMP_COUNTER_EDX; + + +/** + CPUID Linear Physical Address Size + + @param EAX CPUID_VIR_PHY_ADDRESS_SIZE (0x80000008) + + @retval EAX Linear/Physical Address Size described by the type + CPUID_VIR_PHY_ADDRESS_SIZE_EAX. + @retval EBX Reserved. + @retval ECX Reserved. + @retval EDX Reserved. + + Example usage + @code + CPUID_VIR_PHY_ADDRESS_SIZE_EAX Eax; + + AsmCpuid (CPUID_VIR_PHY_ADDRESS_SIZE, &Eax.Uint32, NULL, NULL, NULL); + @endcode +**/ +#define CPUID_VIR_PHY_ADDRESS_SIZE 0x80000008 + +/** + CPUID Linear Physical Address Size EAX for CPUID leaf + #CPUID_VIR_PHY_ADDRESS_SIZE. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Number of physical address bits. + /// + /// @note + /// If CPUID.80000008H:EAX[7:0] is supported, the maximum physical add= ress + /// number supported should come from this field. + /// + UINT32 PhysicalAddressBits:8; + /// + /// [Bits 15:8] Number of linear address bits. + /// + UINT32 LinearAddressBits:8; + UINT32 Reserved:16; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; +} CPUID_VIR_PHY_ADDRESS_SIZE_EAX; + +#endif diff --git a/UefiCpuPkg/Include/Register/Cpuid.h b/UefiCpuPkg/Include/Regis= ter/Cpuid.h index 6803471ea3..3946f2455f 100644 --- a/UefiCpuPkg/Include/Register/Cpuid.h +++ b/UefiCpuPkg/Include/Register/Cpuid.h @@ -1,10 +1,5 @@ /** @file - CPUID leaf definitions. - - Provides defines for CPUID leaf indexes. Data structures are provided f= or - registers returned by a CPUID leaf that contain one or more bit fields. - If a register returned is a single 32-bit value, then a data structure is - not provided for that register. + Wrapper header file to include in MdePkg. =20 Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent @@ -18,3980 +13,6 @@ #ifndef __CPUID_H__ #define __CPUID_H__ =20 -/** - CPUID Signature Information - - @param EAX CPUID_SIGNATURE (0x00) - - @retval EAX Returns the highest value the CPUID instruction recognizes= for - returning basic processor information. The value is return= ed is - processor specific. - @retval EBX First 4 characters of a vendor identification string. - @retval ECX Last 4 characters of a vendor identification string. - @retval EDX Middle 4 characters of a vendor identification string. - - Example usage - @code - UINT32 Eax; - UINT32 Ebx; - UINT32 Ecx; - UINT32 Edx; - - AsmCpuid (CPUID_SIGNATURE, &Eax, &Ebx, &Ecx, &Edx); - @endcode -**/ -#define CPUID_SIGNATURE 0x00 - -/// -/// @{ CPUID signature values returned by Intel processors -/// -#define CPUID_SIGNATURE_GENUINE_INTEL_EBX SIGNATURE_32 ('G', 'e', 'n', 'u= ') -#define CPUID_SIGNATURE_GENUINE_INTEL_EDX SIGNATURE_32 ('i', 'n', 'e', 'I= ') -#define CPUID_SIGNATURE_GENUINE_INTEL_ECX SIGNATURE_32 ('n', 't', 'e', 'l= ') -/// -/// @} -/// - - -/** - CPUID Version Information - - @param EAX CPUID_VERSION_INFO (0x01) - - @retval EAX Returns Model, Family, Stepping Information described by t= he - type CPUID_VERSION_INFO_EAX. - @retval EBX Returns Brand, Cache Line Size, and Initial APIC ID descri= bed by - the type CPUID_VERSION_INFO_EBX. - @retval ECX CPU Feature Information described by the type - CPUID_VERSION_INFO_ECX. - @retval EDX CPU Feature Information described by the type - CPUID_VERSION_INFO_EDX. - - Example usage - @code - CPUID_VERSION_INFO_EAX Eax; - CPUID_VERSION_INFO_EBX Ebx; - CPUID_VERSION_INFO_ECX Ecx; - CPUID_VERSION_INFO_EDX Edx; - - AsmCpuid (CPUID_VERSION_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Ed= x.Uint32); - @endcode -**/ -#define CPUID_VERSION_INFO 0x01 - -/** - CPUID Version Information returned in EAX for CPUID leaf - #CPUID_VERSION_INFO. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 SteppingId:4; ///< [Bits 3:0] Stepping ID - UINT32 Model:4; ///< [Bits 7:4] Model - UINT32 FamilyId:4; ///< [Bits 11:8] Family - UINT32 ProcessorType:2; ///< [Bits 13:12] Processor Type - UINT32 Reserved1:2; ///< [Bits 15:14] Reserved - UINT32 ExtendedModelId:4; ///< [Bits 19:16] Extended Model ID - UINT32 ExtendedFamilyId:8; ///< [Bits 27:20] Extended Family ID - UINT32 Reserved2:4; ///< Reserved - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_VERSION_INFO_EAX; - -/// -/// @{ Define value for bit field CPUID_VERSION_INFO_EAX.ProcessorType -/// -#define CPUID_VERSION_INFO_EAX_PROCESSOR_TYPE_ORIGINAL_OEM_PROCESSOR 0= x00 -#define CPUID_VERSION_INFO_EAX_PROCESSOR_TYPE_INTEL_OVERDRIVE_PROCESSOR 0= x01 -#define CPUID_VERSION_INFO_EAX_PROCESSOR_TYPE_DUAL_PROCESSOR 0= x02 -/// -/// @} -/// - -/** - CPUID Version Information returned in EBX for CPUID leaf - #CPUID_VERSION_INFO. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Provides an entry into a brand string table that contai= ns - /// brand strings for IA-32 processors. - /// - UINT32 BrandIndex:8; - /// - /// [Bits 15:8] Indicates the size of the cache line flushed by the CL= FLUSH - /// and CLFLUSHOPT instructions in 8-byte increments. This field was - /// introduced in the Pentium 4 processor. - /// - UINT32 CacheLineSize:8; - /// - /// [Bits 23:16] Maximum number of addressable IDs for logical process= ors - /// in this physical package. - /// - /// @note - /// The nearest power-of-2 integer that is not smaller than EBX[23:16]= is - /// the number of unique initial APICIDs reserved for addressing diffe= rent - /// logical processors in a physical package. This field is only valid= if - /// CPUID.1.EDX.HTT[bit 28]=3D 1. - /// - UINT32 MaximumAddressableIdsForLogicalProcessors:8; - /// - /// [Bits 31:24] The 8-bit ID that is assigned to the local APIC on the - /// processor during power up. This field was introduced in the Pentiu= m 4 - /// processor. - /// - UINT32 InitialLocalApicId:8; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_VERSION_INFO_EBX; - -/** - CPUID Version Information returned in ECX for CPUID leaf - #CPUID_VERSION_INFO. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Streaming SIMD Extensions 3 (SSE3). A value of 1 indicate= s the - /// processor supports this technology - /// - UINT32 SSE3:1; - /// - /// [Bit 1] A value of 1 indicates the processor supports the PCLMULQDQ - /// instruction. Carryless Multiplication - /// - UINT32 PCLMULQDQ:1; - /// - /// [Bit 2] 64-bit DS Area. A value of 1 indicates the processor supp= orts - /// DS area using 64-bit layout. - /// - UINT32 DTES64:1; - /// - /// [Bit 3] MONITOR/MWAIT. A value of 1 indicates the processor suppo= rts - /// this feature. - /// - UINT32 MONITOR:1; - /// - /// [Bit 4] CPL Qualified Debug Store. A value of 1 indicates the pro= cessor - /// supports the extensions to the Debug Store feature to allow for br= anch - /// message storage qualified by CPL - /// - UINT32 DS_CPL:1; - /// - /// [Bit 5] Virtual Machine Extensions. A value of 1 indicates that t= he - /// processor supports this technology. - /// - UINT32 VMX:1; - /// - /// [Bit 6] Safer Mode Extensions. A value of 1 indicates that the pro= cessor - /// supports this technology - /// - UINT32 SMX:1; - /// - /// [Bit 7] Enhanced Intel SpeedStep(R) technology. A value of 1 indi= cates - /// that the processor supports this technology - /// - UINT32 EIST:1; - /// - /// [Bit 8] Thermal Monitor 2. A value of 1 indicates whether the pro= cessor - /// supports this technology - /// - UINT32 TM2:1; - /// - /// [Bit 9] A value of 1 indicates the presence of the Supplemental St= reaming - /// SIMD Extensions 3 (SSSE3). A value of 0 indicates the instruction - /// extensions are not present in the processor. - /// - UINT32 SSSE3:1; - /// - /// [Bit 10] L1 Context ID. A value of 1 indicates the L1 data cache = mode - /// can be set to either adaptive mode or shared mode. A value of 0 in= dicates - /// this feature is not supported. See definition of the IA32_MISC_ENA= BLE MSR - /// Bit 24 (L1 Data Cache Context Mode) for details - /// - UINT32 CNXT_ID:1; - /// - /// [Bit 11] A value of 1 indicates the processor supports IA32_DEBUG_= INTERFACE - /// MSR for silicon debug - /// - UINT32 SDBG:1; - /// - /// [Bit 12] A value of 1 indicates the processor supports FMA (Fused = Multiple - /// Add) extensions using YMM state. - /// - UINT32 FMA:1; - /// - /// [Bit 13] CMPXCHG16B Available. A value of 1 indicates that the fe= ature - /// is available. - /// - UINT32 CMPXCHG16B:1; - /// - /// [Bit 14] xTPR Update Control. A value of 1 indicates that the pro= cessor - /// supports changing IA32_MISC_ENABLE[Bit 23]. - /// - UINT32 xTPR_Update_Control:1; - /// - /// [Bit 15] Perfmon and Debug Capability: A value of 1 indicates the - /// processor supports the performance and debug feature indication MSR - /// IA32_PERF_CAPABILITIES. - /// - UINT32 PDCM:1; - UINT32 Reserved:1; - /// - /// [Bit 17] Process-context identifiers. A value of 1 indicates that= the - /// processor supports PCIDs and that software may set CR4.PCIDE to 1. - /// - UINT32 PCID:1; - /// - /// [Bit 18] A value of 1 indicates the processor supports the ability= to - /// prefetch data from a memory mapped device. Direct Cache Access. - /// - UINT32 DCA:1; - /// - /// [Bit 19] A value of 1 indicates that the processor supports SSE4.1. - /// - UINT32 SSE4_1:1; - /// - /// [Bit 20] A value of 1 indicates that the processor supports SSE4.2. - /// - UINT32 SSE4_2:1; - /// - /// [Bit 21] A value of 1 indicates that the processor supports x2APIC - /// feature. - /// - UINT32 x2APIC:1; - /// - /// [Bit 22] A value of 1 indicates that the processor supports MOVBE - /// instruction. - /// - UINT32 MOVBE:1; - /// - /// [Bit 23] A value of 1 indicates that the processor supports the PO= PCNT - /// instruction. - /// - UINT32 POPCNT:1; - /// - /// [Bit 24] A value of 1 indicates that the processor's local APIC ti= mer - /// supports one-shot operation using a TSC deadline value. - /// - UINT32 TSC_Deadline:1; - /// - /// [Bit 25] A value of 1 indicates that the processor supports the AE= SNI - /// instruction extensions. - /// - UINT32 AESNI:1; - /// - /// [Bit 26] A value of 1 indicates that the processor supports the - /// XSAVE/XRSTOR processor extended states feature, the XSETBV/XGETBV - /// instructions, and XCR0. - /// - UINT32 XSAVE:1; - /// - /// [Bit 27] A value of 1 indicates that the OS has set CR4.OSXSAVE[Bi= t 18] - /// to enable XSETBV/XGETBV instructions to access XCR0 and to support - /// processor extended state management using XSAVE/XRSTOR. - /// - UINT32 OSXSAVE:1; - /// - /// [Bit 28] A value of 1 indicates the processor supports the AVX ins= truction - /// extensions. - /// - UINT32 AVX:1; - /// - /// [Bit 29] A value of 1 indicates that processor supports 16-bit - /// floating-point conversion instructions. - /// - UINT32 F16C:1; - /// - /// [Bit 30] A value of 1 indicates that processor supports RDRAND ins= truction. - /// - UINT32 RDRAND:1; - /// - /// [Bit 31] Always returns 0. - /// - UINT32 NotUsed:1; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_VERSION_INFO_ECX; - -/** - CPUID Version Information returned in EDX for CPUID leaf - #CPUID_VERSION_INFO. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Floating Point Unit On-Chip. The processor contains an x87= FPU. - /// - UINT32 FPU:1; - /// - /// [Bit 1] Virtual 8086 Mode Enhancements. Virtual 8086 mode enhance= ments, - /// including CR4.VME for controlling the feature, CR4.PVI for protect= ed - /// mode virtual interrupts, software interrupt indirection, expansion= of - /// the TSS with the software indirection bitmap, and EFLAGS.VIF and - /// EFLAGS.VIP flags. - /// - UINT32 VME:1; - /// - /// [Bit 2] Debugging Extensions. Support for I/O breakpoints, includ= ing - /// CR4.DE for controlling the feature, and optional trapping of acces= ses to - /// DR4 and DR5. - /// - UINT32 DE:1; - /// - /// [Bit 3] Page Size Extension. Large pages of size 4 MByte are supp= orted, - /// including CR4.PSE for controlling the feature, the defined dirty b= it in - /// PDE (Page Directory Entries), optional reserved bit trapping in CR= 3, - /// PDEs, and PTEs. - /// - UINT32 PSE:1; - /// - /// [Bit 4] Time Stamp Counter. The RDTSC instruction is supported, - /// including CR4.TSD for controlling privilege. - /// - UINT32 TSC:1; - /// - /// [Bit 5] Model Specific Registers RDMSR and WRMSR Instructions. The - /// RDMSR and WRMSR instructions are supported. Some of the MSRs are - /// implementation dependent. - /// - UINT32 MSR:1; - /// - /// [Bit 6] Physical Address Extension. Physical addresses greater th= an 32 - /// bits are supported: extended page table entry formats, an extra le= vel in - /// the page translation tables is defined, 2-MByte pages are supported - /// instead of 4 Mbyte pages if PAE bit is 1. - /// - UINT32 PAE:1; - /// - /// [Bit 7] Machine Check Exception. Exception 18 is defined for Mach= ine - /// Checks, including CR4.MCE for controlling the feature. This featur= e does - /// not define the model-specific implementations of machine-check err= or - /// logging, reporting, and processor shutdowns. Machine Check excepti= on - /// handlers may have to depend on processor version to do model speci= fic - /// processing of the exception, or test for the presence of the Machi= ne - /// Check feature. - /// - UINT32 MCE:1; - /// - /// [Bit 8] CMPXCHG8B Instruction. The compare-and-exchange 8 bytes(6= 4 bits) - /// instruction is supported (implicitly locked and atomic). - /// - UINT32 CX8:1; - /// - /// [Bit 9] APIC On-Chip. The processor contains an Advanced Programm= able - /// Interrupt Controller (APIC), responding to memory mapped commands = in the - /// physical address range FFFE0000H to FFFE0FFFH (by default - some - /// processors permit the APIC to be relocated). - /// - UINT32 APIC:1; - UINT32 Reserved1:1; - /// - /// [Bit 11] SYSENTER and SYSEXIT Instructions. The SYSENTER and SYSE= XIT - /// and associated MSRs are supported. - /// - UINT32 SEP:1; - /// - /// [Bit 12] Memory Type Range Registers. MTRRs are supported. The MT= RRcap - /// MSR contains feature bits that describe what memory types are supp= orted, - /// how many variable MTRRs are supported, and whether fixed MTRRs are - /// supported. - /// - UINT32 MTRR:1; - /// - /// [Bit 13] Page Global Bit. The global bit is supported in paging-s= tructure - /// entries that map a page, indicating TLB entries that are common to - /// different processes and need not be flushed. The CR4.PGE bit contr= ols - /// this feature. - /// - UINT32 PGE:1; - /// - /// [Bit 14] Machine Check Architecture. A value of 1 indicates the Ma= chine - /// Check Architecture of reporting machine errors is supported. The M= CG_CAP - /// MSR contains feature bits describing how many banks of error repor= ting - /// MSRs are supported. - /// - UINT32 MCA:1; - /// - /// [Bit 15] Conditional Move Instructions. The conditional move inst= ruction - /// CMOV is supported. In addition, if x87 FPU is present as indicated= by the - /// CPUID.FPU feature bit, then the FCOMI and FCMOV instructions are s= upported. - /// - UINT32 CMOV:1; - /// - /// [Bit 16] Page Attribute Table. Page Attribute Table is supported.= This - /// feature augments the Memory Type Range Registers (MTRRs), allowing= an - /// operating system to specify attributes of memory accessed through a - /// linear address on a 4KB granularity. - /// - UINT32 PAT:1; - /// - /// [Bit 17] 36-Bit Page Size Extension. 4-MByte pages addressing phy= sical - /// memory beyond 4 GBytes are supported with 32-bit paging. This feat= ure - /// indicates that upper bits of the physical address of a 4-MByte pag= e are - /// encoded in bits 20:13 of the page-directory entry. Such physical - /// addresses are limited by MAXPHYADDR and may be up to 40 bits in si= ze. - /// - UINT32 PSE_36:1; - /// - /// [Bit 18] Processor Serial Number. The processor supports the 96-b= it - /// processor identification number feature and the feature is enabled. - /// - UINT32 PSN:1; - /// - /// [Bit 19] CLFLUSH Instruction. CLFLUSH Instruction is supported. - /// - UINT32 CLFSH:1; - UINT32 Reserved2:1; - /// - /// [Bit 21] Debug Store. The processor supports the ability to write= debug - /// information into a memory resident buffer. This feature is used b= y the - /// branch trace store (BTS) and precise event-based sampling (PEBS) - /// facilities. - /// - UINT32 DS:1; - /// - /// [Bit 22] Thermal Monitor and Software Controlled Clock Facilities.= The - /// processor implements internal MSRs that allow processor temperatur= e to - /// be monitored and processor performance to be modulated in predefin= ed - /// duty cycles under software control. - /// - UINT32 ACPI:1; - /// - /// [Bit 23] Intel MMX Technology. The processor supports the Intel M= MX - /// technology. - /// - UINT32 MMX:1; - /// - /// [Bit 24] FXSAVE and FXRSTOR Instructions. The FXSAVE and FXRSTOR - /// instructions are supported for fast save and restore of the floati= ng - /// point context. Presence of this bit also indicates that CR4.OSFXSR= is - /// available for an operating system to indicate that it supports the - /// FXSAVE and FXRSTOR instructions. - /// - UINT32 FXSR:1; - /// - /// [Bit 25] SSE. The processor supports the SSE extensions. - /// - UINT32 SSE:1; - /// - /// [Bit 26] SSE2. The processor supports the SSE2 extensions. - /// - UINT32 SSE2:1; - /// - /// [Bit 27] Self Snoop. The processor supports the management of - /// conflicting memory types by performing a snoop of its own cache - /// structure for transactions issued to the bus. - /// - UINT32 SS:1; - /// - /// [Bit 28] Max APIC IDs reserved field is Valid. A value of 0 for H= TT - /// indicates there is only a single logical processor in the package = and - /// software should assume only a single APIC ID is reserved. A value = of 1 - /// for HTT indicates the value in CPUID.1.EBX[23:16] (the Maximum num= ber of - /// addressable IDs for logical processors in this package) is valid f= or the - /// package. - /// - UINT32 HTT:1; - /// - /// [Bit 29] Thermal Monitor. The processor implements the thermal mo= nitor - /// automatic thermal control circuitry (TCC). - /// - UINT32 TM:1; - UINT32 Reserved3:1; - /// - /// [Bit 31] Pending Break Enable. The processor supports the use of = the - /// FERR#/PBE# pin when the processor is in the stop-clock state (STPC= LK# is - /// asserted) to signal the processor that an interrupt is pending and= that - /// the processor should return to normal operation to handle the inte= rrupt. - /// Bit 10 (PBE enable) in the IA32_MISC_ENABLE MSR enables this capab= ility. - /// - UINT32 PBE:1; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_VERSION_INFO_EDX; - - -/** - CPUID Cache and TLB Information - - @param EAX CPUID_CACHE_INFO (0x02) - - @retval EAX Cache and TLB Information described by the type - CPUID_CACHE_INFO_CACHE_TLB. - CPUID_CACHE_INFO_CACHE_TLB.CacheDescriptor[0] always retur= ns - 0x01 and must be ignored. Only valid if - CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear. - @retval EBX Cache and TLB Information described by the type - CPUID_CACHE_INFO_CACHE_TLB. Only valid if - CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear. - @retval ECX Cache and TLB Information described by the type - CPUID_CACHE_INFO_CACHE_TLB. Only valid if - CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear. - @retval EDX Cache and TLB Information described by the type - CPUID_CACHE_INFO_CACHE_TLB. Only valid if - CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear. - - Example usage - @code - CPUID_CACHE_INFO_CACHE_TLB Eax; - CPUID_CACHE_INFO_CACHE_TLB Ebx; - CPUID_CACHE_INFO_CACHE_TLB Ecx; - CPUID_CACHE_INFO_CACHE_TLB Edx; - - AsmCpuid (CPUID_CACHE_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.= Uint32); - @endcode - - Cache Descriptor values - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Value Type Description
0x00 General Null descriptor, this byte con= tains no information
0x01 TLB Instruction TLB: 4 KByte pages= , 4-way set associative, 32 entries
0x02 TLB Instruction TLB: 4 MByte pages= , fully associative, 2 entries
0x03 TLB Data TLB: 4 KByte pages, 4-way= set associative, 64 entries
0x04 TLB Data TLB: 4 MByte pages, 4-way= set associative, 8 entries
0x05 TLB Data TLB1: 4 MByte pages, 4-wa= y set associative, 32 entries
0x06 Cache 1st-level instruction cache: 8= KBytes, 4-way set associative, - 32 byte line size
0x08 Cache 1st-level instruction cache: 1= 6 KBytes, 4-way set associative, - 32 byte line size
0x09 Cache 1st-level instruction cache: 3= 2KBytes, 4-way set associative, - 64 byte line size
0x0A Cache 1st-level data cache: 8 KBytes= , 2-way set associative, 32 byte line size
0x0B TLB Instruction TLB: 4 MByte pages= , 4-way set associative, 4 entries
0x0C Cache 1st-level data cache: 16 KByte= s, 4-way set associative, 32 byte line size
0x0D Cache 1st-level data cache: 16 KByte= s, 4-way set associative, 64 byte line size
0x0E Cache 1st-level data cache: 24 KByte= s, 6-way set associative, 64 byte line size
0x1D Cache 2nd-level cache: 128 KBytes, 2= -way set associative, 64 byte line size
0x21 Cache 2nd-level cache: 256 KBytes, 8= -way set associative, 64 byte line size
0x22 Cache 3rd-level cache: 512 KBytes, 4= -way set associative, 64 byte line size, - 2 lines per sector
0x23 Cache 3rd-level cache: 1 MBytes, 8-w= ay set associative, 64 byte line size, - 2 lines per sector
0x24 Cache 2nd-level cache: 1 MBytes, 16-= way set associative, 64 byte line size
0x25 Cache 3rd-level cache: 2 MBytes, 8-w= ay set associative, 64 byte line size, - 2 lines per sector
0x29 Cache 3rd-level cache: 4 MBytes, 8-w= ay set associative, 64 byte line size, - 2 lines per sector
0x2C Cache 1st-level data cache: 32 KByte= s, 8-way set associative, - 64 byte line size
0x30 Cache 1st-level instruction cache: 3= 2 KBytes, 8-way set associative, - 64 byte line size
0x40 Cache No 2nd-level cache or, if proc= essor contains a valid 2nd-level cache, - no 3rd-level cache
0x41 Cache 2nd-level cache: 128 KBytes, 4= -way set associative, 32 byte line size
0x42 Cache 2nd-level cache: 256 KBytes, 4= -way set associative, 32 byte line size
0x43 Cache 2nd-level cache: 512 KBytes, 4= -way set associative, 32 byte line size
0x44 Cache 2nd-level cache: 1 MByte, 4-wa= y set associative, 32 byte line size
0x45 Cache 2nd-level cache: 2 MByte, 4-wa= y set associative, 32 byte line size
0x46 Cache 3rd-level cache: 4 MByte, 4-wa= y set associative, 64 byte line size
0x47 Cache 3rd-level cache: 8 MByte, 8-wa= y set associative, 64 byte line size
0x48 Cache 2nd-level cache: 3MByte, 12-wa= y set associative, 64 byte line size
0x49 Cache 3rd-level cache: 4MB, 16-way s= et associative, 64-byte line size - (Intel Xeon processor MP, Fami= ly 0FH, Model 06H)
- 2nd-level cache: 4 MByte, 16-w= ay set associative, 64 byte line size
0x4A Cache 3rd-level cache: 6MByte, 12-wa= y set associative, 64 byte line size
0x4B Cache 3rd-level cache: 8MByte, 16-wa= y set associative, 64 byte line size
0x4C Cache 3rd-level cache: 12MByte, 12-w= ay set associative, 64 byte line size
0x4D Cache 3rd-level cache: 16MByte, 16-w= ay set associative, 64 byte line size
0x4E Cache 2nd-level cache: 6MByte, 24-wa= y set associative, 64 byte line size
0x4F TLB Instruction TLB: 4 KByte pages= , 32 entries
0x50 TLB Instruction TLB: 4 KByte and 2= -MByte or 4-MByte pages, 64 entries
0x51 TLB Instruction TLB: 4 KByte and 2= -MByte or 4-MByte pages, 128 entries
0x52 TLB Instruction TLB: 4 KByte and 2= -MByte or 4-MByte pages, 256 entries
0x55 TLB Instruction TLB: 2-MByte or 4-= MByte pages, fully associative, 7 entries
0x56 TLB Data TLB0: 4 MByte pages, 4-wa= y set associative, 16 entries
0x57 TLB Data TLB0: 4 KByte pages, 4-wa= y associative, 16 entries
0x59 TLB Data TLB0: 4 KByte pages, full= y associative, 16 entries
0x5A TLB Data TLB0: 2 MByte or 4 MByte = pages, 4-way set associative, 32 entries
0x5B TLB Data TLB: 4 KByte and 4 MByte = pages, 64 entries
0x5C TLB Data TLB: 4 KByte and 4 MByte = pages,128 entries
0x5D TLB Data TLB: 4 KByte and 4 MByte = pages,256 entries
0x60 Cache 1st-level data cache: 16 KByte= , 8-way set associative, 64 byte line size
0x61 TLB Instruction TLB: 4 KByte pages= , fully associative, 48 entries
0x63 TLB Data TLB: 2 MByte or 4 MByte p= ages, 4-way set associative, - 32 entries and a separate arra= y with 1 GByte pages, 4-way set associative, - 4 entries
0x64 TLB Data TLB: 4 KByte pages, 4-way= set associative, 512 entries
0x66 Cache 1st-level data cache: 8 KByte,= 4-way set associative, 64 byte line size
0x67 Cache 1st-level data cache: 16 KByte= , 4-way set associative, 64 byte line size
0x68 Cache 1st-level data cache: 32 KByte= , 4-way set associative, 64 byte line size
0x6A Cache uTLB: 4 KByte pages, 8-way set= associative, 64 entries
0x6B Cache DTLB: 4 KByte pages, 8-way set= associative, 256 entries
0x6C Cache DTLB: 2M/4M pages, 8-way set a= ssociative, 128 entries
0x6D Cache DTLB: 1 GByte pages, fully ass= ociative, 16 entries
0x70 Cache Trace cache: 12 K-uop, 8-way s= et associative
0x71 Cache Trace cache: 16 K-uop, 8-way s= et associative
0x72 Cache Trace cache: 32 K-uop, 8-way s= et associative
0x76 TLB Instruction TLB: 2M/4M pages, = fully associative, 8 entries
0x78 Cache 2nd-level cache: 1 MByte, 4-wa= y set associative, 64byte line size
0x79 Cache 2nd-level cache: 128 KByte, 8-= way set associative, 64 byte line size, - 2 lines per sector
0x7A Cache 2nd-level cache: 256 KByte, 8-= way set associative, 64 byte line size, - 2 lines per sector
0x7B Cache 2nd-level cache: 512 KByte, 8-= way set associative, 64 byte line size, - 2 lines per sector
0x7C Cache 2nd-level cache: 1 MByte, 8-wa= y set associative, 64 byte line size, - 2 lines per sector
0x7D Cache 2nd-level cache: 2 MByte, 8-wa= y set associative, 64byte line size
0x7F Cache 2nd-level cache: 512 KByte, 2-= way set associative, 64-byte line size
0x80 Cache 2nd-level cache: 512 KByte, 8-= way set associative, 64-byte line size
0x82 Cache 2nd-level cache: 256 KByte, 8-= way set associative, 32 byte line size
0x83 Cache 2nd-level cache: 512 KByte, 8-= way set associative, 32 byte line size
0x84 Cache 2nd-level cache: 1 MByte, 8-wa= y set associative, 32 byte line size
0x85 Cache 2nd-level cache: 2 MByte, 8-wa= y set associative, 32 byte line size
0x86 Cache 2nd-level cache: 512 KByte, 4-= way set associative, 64 byte line size
0x87 Cache 2nd-level cache: 1 MByte, 8-wa= y set associative, 64 byte line size
0xA0 DTLB DTLB: 4k pages, fully associat= ive, 32 entries
0xB0 TLB Instruction TLB: 4 KByte pages= , 4-way set associative, 128 entries
0xB1 TLB Instruction TLB: 2M pages, 4-w= ay, 8 entries or 4M pages, 4-way, 4 entries
0xB2 TLB Instruction TLB: 4KByte pages,= 4-way set associative, 64 entries
0xB3 TLB Data TLB: 4 KByte pages, 4-way= set associative, 128 entries
0xB4 TLB Data TLB1: 4 KByte pages, 4-wa= y associative, 256 entries
0xB5 TLB Instruction TLB: 4KByte pages,= 8-way set associative, 64 entries
0xB6 TLB Instruction TLB: 4KByte pages,= 8-way set associative, - 128 entries
0xBA TLB Data TLB1: 4 KByte pages, 4-wa= y associative, 64 entries
0xC0 TLB Data TLB: 4 KByte and 4 MByte = pages, 4-way associative, 8 entries
0xC1 STLB Shared 2nd-Level TLB: 4 KByte/= 2MByte pages, 8-way associative, - 1024 entries
0xC2 DTLB DTLB: 4 KByte/2 MByte pages, 4= -way associative, 16 entries
0xC3 STLB Shared 2nd-Level TLB: 4 KByte = /2 MByte pages, 6-way associative, - 1536 entries. Also 1GBbyte pag= es, 4-way, 16 entries.
0xC4 DTLB DTLB: 2M/4M Byte pages, 4-way = associative, 32 entries
0xCA STLB Shared 2nd-Level TLB: 4 KByte = pages, 4-way associative, 512 entries
0xD0 Cache 3rd-level cache: 512 KByte, 4-= way set associative, 64 byte line size
0xD1 Cache 3rd-level cache: 1 MByte, 4-wa= y set associative, 64 byte line size
0xD2 Cache 3rd-level cache: 2 MByte, 4-wa= y set associative, 64 byte line size
0xD6 Cache 3rd-level cache: 1 MByte, 8-wa= y set associative, 64 byte line size
0xD7 Cache 3rd-level cache: 2 MByte, 8-wa= y set associative, 64 byte line size
0xD8 Cache 3rd-level cache: 4 MByte, 8-wa= y set associative, 64 byte line size
0xDC Cache 3rd-level cache: 1.5 MByte, 12= -way set associative, 64 byte line size
0xDD Cache 3rd-level cache: 3 MByte, 12-w= ay set associative, 64 byte line size
0xDE Cache 3rd-level cache: 6 MByte, 12-w= ay set associative, 64 byte line size
0xE2 Cache 3rd-level cache: 2 MByte, 16-w= ay set associative, 64 byte line size
0xE3 Cache 3rd-level cache: 4 MByte, 16-w= ay set associative, 64 byte line size
0xE4 Cache 3rd-level cache: 8 MByte, 16-w= ay set associative, 64 byte line size
0xEA Cache 3rd-level cache: 12MByte, 24-w= ay set associative, 64 byte line size
0xEB Cache 3rd-level cache: 18MByte, 24-w= ay set associative, 64 byte line size
0xEC Cache 3rd-level cache: 24MByte, 24-w= ay set associative, 64 byte line size
0xF0 Prefetch 64-Byte prefetching
0xF1 Prefetch 128-Byte prefetching
0xFE General CPUID leaf 2 does not report T= LB descriptor information; use CPUID - leaf 18H to query TLB and othe= r address translation parameters.
0xFF General CPUID leaf 2 does not report c= ache descriptor information, - use CPUID leaf 4 to query cach= e parameters
-**/ -#define CPUID_CACHE_INFO 0x02 - -/** - CPUID Cache and TLB Information returned in EAX, EBX, ECX, and EDX for C= PUID - leaf #CPUID_CACHE_INFO. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved:31; - /// - /// [Bit 31] If 0, then the cache descriptor bytes in the register are= valid. - /// if 1, then none of the cache descriptor bytes in the register are = valid. - /// - UINT32 NotValid:1; - } Bits; - /// - /// Array of Cache and TLB descriptor bytes - /// - UINT8 CacheDescriptor[4]; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_CACHE_INFO_CACHE_TLB; - - -/** - CPUID Processor Serial Number - - Processor serial number (PSN) is not supported in the Pentium 4 processor - or later. On all models, use the PSN flag (returned using CPUID) to che= ck - for PSN support before accessing the feature. - - @param EAX CPUID_SERIAL_NUMBER (0x03) - - @retval EAX Reserved. - @retval EBX Reserved. - @retval ECX Bits 31:0 of 96 bit processor serial number. (Available in - Pentium III processor only; otherwise, the value in this - register is reserved.) - @retval EDX Bits 63:32 of 96 bit processor serial number. (Available in - Pentium III processor only; otherwise, the value in this - register is reserved.) - - Example usage - @code - UINT32 Ecx; - UINT32 Edx; - - AsmCpuid (CPUID_SERIAL_NUMBER, NULL, NULL, &Ecx, &Edx); - @endcode -**/ -#define CPUID_SERIAL_NUMBER 0x03 - - -/** - CPUID Cache Parameters - - @param EAX CPUID_CACHE_PARAMS (0x04) - @param ECX Cache Level. Valid values start at 0. Software can enume= rate - the deterministic cache parameters for each level of the c= ache - hierarchy starting with an index value of 0, until the - parameters report the value associated with the CacheType - field in CPUID_CACHE_PARAMS_EAX is 0. - - @retval EAX Returns cache type information described by the type - CPUID_CACHE_PARAMS_EAX. - @retval EBX Returns cache line and associativity information described= by - the type CPUID_CACHE_PARAMS_EBX. - @retval ECX Returns the number of sets in the cache. - @retval EDX Returns cache WINVD/INVD behavior described by the type - CPUID_CACHE_PARAMS_EDX. - - Example usage - @code - UINT32 CacheLevel; - CPUID_CACHE_PARAMS_EAX Eax; - CPUID_CACHE_PARAMS_EBX Ebx; - UINT32 Ecx; - CPUID_CACHE_PARAMS_EDX Edx; - - CacheLevel =3D 0; - do { - AsmCpuidEx ( - CPUID_CACHE_PARAMS, CacheLevel, - &Eax.Uint32, &Ebx.Uint32, &Ecx, &Edx.Uint32 - ); - CacheLevel++; - } while (Eax.Bits.CacheType !=3D CPUID_CACHE_PARAMS_CACHE_TYPE_NULL); - @endcode -**/ -#define CPUID_CACHE_PARAMS 0x04 - -/** - CPUID Cache Parameters Information returned in EAX for CPUID leaf - #CPUID_CACHE_PARAMS. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 4:0] Cache type field. If #CPUID_CACHE_PARAMS_CACHE_TYPE_NU= LL, - /// then there is no information for the requested cache level. - /// - UINT32 CacheType:5; - /// - /// [Bits 7:5] Cache level (Starts at 1). - /// - UINT32 CacheLevel:3; - /// - /// [Bit 8] Self Initializing cache level (does not need SW initializa= tion). - /// - UINT32 SelfInitializingCache:1; - /// - /// [Bit 9] Fully Associative cache. - /// - UINT32 FullyAssociativeCache:1; - /// - /// [Bits 13:10] Reserved. - /// - UINT32 Reserved:4; - /// - /// [Bits 25:14] Maximum number of addressable IDs for logical process= ors - /// sharing this cache. - /// - /// Add one to the return value to get the result. - /// The nearest power-of-2 integer that is not smaller than (1 + EAX[2= 5:14]) - /// is the number of unique initial APIC IDs reserved for addressing - /// different logical processors sharing this cache. - /// - UINT32 MaximumAddressableIdsForLogicalProcessors:12; - /// - /// [Bits 31:26] Maximum number of addressable IDs for processor cores= in - /// the physical package. - /// - /// The nearest power-of-2 integer that is not smaller than (1 + EAX[3= 1:26]) - /// is the number of unique Core_IDs reserved for addressing different - /// processor cores in a physical package. Core ID is a subset of bits= of - /// the initial APIC ID. - /// The returned value is constant for valid initial values in ECX. Va= lid - /// ECX values start from 0. - /// - UINT32 MaximumAddressableIdsForProcessorCores:6; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_CACHE_PARAMS_EAX; - -/// -/// @{ Define value for bit field CPUID_CACHE_PARAMS_EAX.CacheType -/// -#define CPUID_CACHE_PARAMS_CACHE_TYPE_NULL 0x00 -#define CPUID_CACHE_PARAMS_CACHE_TYPE_DATA 0x01 -#define CPUID_CACHE_PARAMS_CACHE_TYPE_INSTRUCTION 0x02 -#define CPUID_CACHE_PARAMS_CACHE_TYPE_UNIFIED 0x03 -/// -/// @} -/// - -/** - CPUID Cache Parameters Information returned in EBX for CPUID leaf - #CPUID_CACHE_PARAMS. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 11:0] System Coherency Line Size. Add one to the return val= ue to - /// get the result. - /// - UINT32 LineSize:12; - /// - /// [Bits 21:12] Physical Line Partitions. Add one to the return valu= e to - /// get the result. - /// - UINT32 LinePartitions:10; - /// - /// [Bits 31:22] Ways of associativity. Add one to the return value t= o get - /// the result. - /// - UINT32 Ways:10; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_CACHE_PARAMS_EBX; - -/** - CPUID Cache Parameters Information returned in EDX for CPUID leaf - #CPUID_CACHE_PARAMS. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Write-Back Invalidate/Invalidate. - /// 0 =3D WBINVD/INVD from threads sharing this cache acts upon lower = level - /// caches for threads sharing this cache. - /// 1 =3D WBINVD/INVD is not guaranteed to act upon lower level caches= of - /// non-originating threads sharing this cache. - /// - UINT32 Invalidate:1; - /// - /// [Bit 1] Cache Inclusiveness. - /// 0 =3D Cache is not inclusive of lower cache levels. - /// 1 =3D Cache is inclusive of lower cache levels. - /// - UINT32 CacheInclusiveness:1; - /// - /// [Bit 2] Complex Cache Indexing. - /// 0 =3D Direct mapped cache. - /// 1 =3D A complex function is used to index the cache, potentially u= sing all - /// address bits. - /// - UINT32 ComplexCacheIndexing:1; - UINT32 Reserved:29; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_CACHE_PARAMS_EDX; - - -/** - CPUID MONITOR/MWAIT Information - - @param EAX CPUID_MONITOR_MWAIT (0x05) - - @retval EAX Smallest monitor-line size in bytes described by the type - CPUID_MONITOR_MWAIT_EAX. - @retval EBX Largest monitor-line size in bytes described by the type - CPUID_MONITOR_MWAIT_EBX. - @retval ECX Enumeration of Monitor-Mwait extensions support described = by - the type CPUID_MONITOR_MWAIT_ECX. - @retval EDX Sub C-states supported described by the type - CPUID_MONITOR_MWAIT_EDX. - - Example usage - @code - CPUID_MONITOR_MWAIT_EAX Eax; - CPUID_MONITOR_MWAIT_EBX Ebx; - CPUID_MONITOR_MWAIT_ECX Ecx; - CPUID_MONITOR_MWAIT_EDX Edx; - - AsmCpuid (CPUID_MONITOR_MWAIT, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &E= dx.Uint32); - @endcode -**/ -#define CPUID_MONITOR_MWAIT 0x05 - -/** - CPUID MONITOR/MWAIT Information returned in EAX for CPUID leaf - #CPUID_MONITOR_MWAIT. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Smallest monitor-line size in bytes (default is proces= sor's - /// monitor granularity). - /// - UINT32 SmallestMonitorLineSize:16; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_MONITOR_MWAIT_EAX; - -/** - CPUID MONITOR/MWAIT Information returned in EBX for CPUID leaf - #CPUID_MONITOR_MWAIT. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Largest monitor-line size in bytes (default is process= or's - /// monitor granularity). - /// - UINT32 LargestMonitorLineSize:16; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_MONITOR_MWAIT_EBX; - -/** - CPUID MONITOR/MWAIT Information returned in ECX for CPUID leaf - #CPUID_MONITOR_MWAIT. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] If 0, then only EAX and EBX are valid. If 1, then EAX, EB= X, ECX, - /// and EDX are valid. - /// - UINT32 ExtensionsSupported:1; - /// - /// [Bit 1] Supports treating interrupts as break-event for MWAIT, eve= n when - /// interrupts disabled. - /// - UINT32 InterruptAsBreak:1; - UINT32 Reserved:30; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_MONITOR_MWAIT_ECX; - -/** - CPUID MONITOR/MWAIT Information returned in EDX for CPUID leaf - #CPUID_MONITOR_MWAIT. - - @note - The definition of C0 through C7 states for MWAIT extension are - processor-specific C-states, not ACPI C-states. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 3:0] Number of C0 sub C-states supported using MWAIT. - /// - UINT32 C0States:4; - /// - /// [Bits 7:4] Number of C1 sub C-states supported using MWAIT. - /// - UINT32 C1States:4; - /// - /// [Bits 11:8] Number of C2 sub C-states supported using MWAIT. - /// - UINT32 C2States:4; - /// - /// [Bits 15:12] Number of C3 sub C-states supported using MWAIT. - /// - UINT32 C3States:4; - /// - /// [Bits 19:16] Number of C4 sub C-states supported using MWAIT. - /// - UINT32 C4States:4; - /// - /// [Bits 23:20] Number of C5 sub C-states supported using MWAIT. - /// - UINT32 C5States:4; - /// - /// [Bits 27:24] Number of C6 sub C-states supported using MWAIT. - /// - UINT32 C6States:4; - /// - /// [Bits 31:28] Number of C7 sub C-states supported using MWAIT. - /// - UINT32 C7States:4; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_MONITOR_MWAIT_EDX; - - -/** - CPUID Thermal and Power Management - - @param EAX CPUID_THERMAL_POWER_MANAGEMENT (0x06) - - @retval EAX Thermal and power management features described by the type - CPUID_THERMAL_POWER_MANAGEMENT_EAX. - @retval EBX Number of Interrupt Thresholds in Digital Thermal Sensor - described by the type CPUID_THERMAL_POWER_MANAGEMENT_EBX. - @retval ECX Performance features described by the type - CPUID_THERMAL_POWER_MANAGEMENT_ECX. - @retval EDX Reserved. - - Example usage - @code - CPUID_THERMAL_POWER_MANAGEMENT_EAX Eax; - CPUID_THERMAL_POWER_MANAGEMENT_EBX Ebx; - CPUID_THERMAL_POWER_MANAGEMENT_ECX Ecx; - - AsmCpuid (CPUID_THERMAL_POWER_MANAGEMENT, &Eax.Uint32, &Ebx.Uint32, &Ecx= .Uint32, NULL); - @endcode -**/ -#define CPUID_THERMAL_POWER_MANAGEMENT 0x06 - -/** - CPUID Thermal and Power Management Information returned in EAX for CPUID= leaf - #CPUID_THERMAL_POWER_MANAGEMENT. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Digital temperature sensor is supported if set. - /// - UINT32 DigitalTemperatureSensor:1; - /// - /// [Bit 1] Intel Turbo Boost Technology Available (see IA32_MISC_ENAB= LE[38]). - /// - UINT32 TurboBoostTechnology:1; - /// - /// [Bit 2] APIC-Timer-always-running feature is supported if set. - /// - UINT32 ARAT:1; - UINT32 Reserved1:1; - /// - /// [Bit 4] Power limit notification controls are supported if set. - /// - UINT32 PLN:1; - /// - /// [Bit 5] Clock modulation duty cycle extension is supported if set. - /// - UINT32 ECMD:1; - /// - /// [Bit 6] Package thermal management is supported if set. - /// - UINT32 PTM:1; - /// - /// [Bit 7] HWP base registers (IA32_PM_ENABLE[Bit 0], IA32_HWP_CAPABI= LITIES, - /// IA32_HWP_REQUEST, IA32_HWP_STATUS) are supported if set. - /// - UINT32 HWP:1; - /// - /// [Bit 8] IA32_HWP_INTERRUPT MSR is supported if set. - /// - UINT32 HWP_Notification:1; - /// - /// [Bit 9] IA32_HWP_REQUEST[Bits 41:32] is supported if set. - /// - UINT32 HWP_Activity_Window:1; - /// - /// [Bit 10] IA32_HWP_REQUEST[Bits 31:24] is supported if set. - /// - UINT32 HWP_Energy_Performance_Preference:1; - /// - /// [Bit 11] IA32_HWP_REQUEST_PKG MSR is supported if set. - /// - UINT32 HWP_Package_Level_Request:1; - UINT32 Reserved2:1; - /// - /// [Bit 13] HDC base registers IA32_PKG_HDC_CTL, IA32_PM_CTL1, - /// IA32_THREAD_STALL MSRs are supported if set. - /// - UINT32 HDC:1; - /// - /// [Bit 14] Intel Turbo Boost Max Technology 3.0 available. - /// - UINT32 TurboBoostMaxTechnology30:1; - /// - /// [Bit 15] HWP Capabilities. - /// Highest Performance change is supported if set. - /// - UINT32 HWPCapabilities:1; - /// - /// [Bit 16] HWP PECI override is supported if set. - /// - UINT32 HWPPECIOverride:1; - /// - /// [Bit 17] Flexible HWP is supported if set. - /// - UINT32 FlexibleHWP:1; - /// - /// [Bit 18] Fast access mode for the IA32_HWP_REQUEST MSR is supporte= d if set. - /// - UINT32 FastAccessMode:1; - UINT32 Reserved4:1; - /// - /// [Bit 20] Ignoring Idle Logical Processor HWP request is supported = if set. - /// - UINT32 IgnoringIdleLogicalProcessorHWPRequest:1; - UINT32 Reserved5:11; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_THERMAL_POWER_MANAGEMENT_EAX; - -/** - CPUID Thermal and Power Management Information returned in EBX for CPUID= leaf - #CPUID_THERMAL_POWER_MANAGEMENT. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// {Bits 3:0] Number of Interrupt Thresholds in Digital Thermal Senso= r. - /// - UINT32 InterruptThresholds:4; - UINT32 Reserved:28; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_THERMAL_POWER_MANAGEMENT_EBX; - -/** - CPUID Thermal and Power Management Information returned in ECX for CPUID= leaf - #CPUID_THERMAL_POWER_MANAGEMENT. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Hardware Coordination Feedback Capability (Presence of IA3= 2_MPERF - /// and IA32_APERF). The capability to provide a measure of delivered - /// processor performance (since last reset of the counters), as a per= centage - /// of the expected processor performance when running at the TSC freq= uency. - /// - UINT32 HardwareCoordinationFeedback:1; - UINT32 Reserved1:2; - /// - /// [Bit 3] If this bit is set, then the processor supports performanc= e-energy - /// bias preference and the architectural MSR called IA32_ENERGY_PERF_= BIAS - /// (1B0H). - /// - UINT32 PerformanceEnergyBias:1; - UINT32 Reserved2:28; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_THERMAL_POWER_MANAGEMENT_ECX; - - -/** - CPUID Structured Extended Feature Flags Enumeration - - @param EAX CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS (0x07) - @param ECX CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO (0x0= 0). - - @note - If ECX contains an invalid sub-leaf index, EAX/EBX/ECX/EDX return 0. Su= b-leaf - index n is invalid if n exceeds the value that sub-leaf 0 returns in EAX. - - @retval EAX The maximum input value for ECX to retrieve sub-leaf infor= mation. - @retval EBX Structured Extended Feature Flags described by the type - CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EBX. - @retval EBX Structured Extended Feature Flags described by the type - CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX. - @retval EDX Reserved. - - Example usage - @code - UINT32 Eax; - CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EBX Ebx; - CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX Ecx; - UINT32 SubLeaf; - - AsmCpuidEx ( - CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS, - CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO, - &Eax, NULL, NULL, NULL - ); - for (SubLeaf =3D 0; SubLeaf <=3D Eax; SubLeaf++) { - AsmCpuidEx ( - CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS, - SubLeaf, - NULL, &Ebx.Uint32, &Ecx.Uint32, NULL - ); - } - @endcode -**/ -#define CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS 0x07 - -/// -/// CPUID Structured Extended Feature Flags Enumeration sub-leaf -/// -#define CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO 0x00 - -/** - CPUID Structured Extended Feature Flags Enumeration in EBX for CPUID leaf - #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS sub leaf - #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Supports RDFSBASE/RDGSBASE/WRFSBASE/WRGSBASE if 1. - /// - UINT32 FSGSBASE:1; - /// - /// [Bit 1] IA32_TSC_ADJUST MSR is supported if 1. - /// - UINT32 IA32_TSC_ADJUST:1; - /// - /// [Bit 2] Intel SGX is supported if 1. See section 37.7 "DISCOVERING= SUPPORT - /// FOR INTEL(R) SGX AND ENABLING ENCLAVE INSTRUCTIONS". - /// - UINT32 SGX:1; - /// - /// [Bit 3] If 1 indicates the processor supports the first group of a= dvanced - /// bit manipulation extensions (ANDN, BEXTR, BLSI, BLSMSK, BLSR, TZCN= T) - /// - UINT32 BMI1:1; - /// - /// [Bit 4] Hardware Lock Elision - /// - UINT32 HLE:1; - /// - /// [Bit 5] If 1 indicates the processor supports AVX2 instruction ext= ensions. - /// - UINT32 AVX2:1; - /// - /// [Bit 6] x87 FPU Data Pointer updated only on x87 exceptions if 1. - /// - UINT32 FDP_EXCPTN_ONLY:1; - /// - /// [Bit 7] Supports Supervisor-Mode Execution Prevention if 1. - /// - UINT32 SMEP:1; - /// - /// [Bit 8] If 1 indicates the processor supports the second group of - /// advanced bit manipulation extensions (BZHI, MULX, PDEP, PEXT, RORX, - /// SARX, SHLX, SHRX) - /// - UINT32 BMI2:1; - /// - /// [Bit 9] Supports Enhanced REP MOVSB/STOSB if 1. - /// - UINT32 EnhancedRepMovsbStosb:1; - /// - /// [Bit 10] If 1, supports INVPCID instruction for system software th= at - /// manages process-context identifiers. - /// - UINT32 INVPCID:1; - /// - /// [Bit 11] Restricted Transactional Memory - /// - UINT32 RTM:1; - /// - /// [Bit 12] Supports Intel(R) Resource Director Technology (Intel(R) = RDT) - /// Monitoring capability if 1. - /// - UINT32 RDT_M:1; - /// - /// [Bit 13] Deprecates FPU CS and FPU DS values if 1. - /// - UINT32 DeprecateFpuCsDs:1; - /// - /// [Bit 14] Supports Intel(R) Memory Protection Extensions if 1. - /// - UINT32 MPX:1; - /// - /// [Bit 15] Supports Intel(R) Resource Director Technology (Intel(R) = RDT) - /// Allocation capability if 1. - /// - UINT32 RDT_A:1; - /// - /// [Bit 16] AVX512F. - /// - UINT32 AVX512F:1; - /// - /// [Bit 17] AVX512DQ. - /// - UINT32 AVX512DQ:1; - /// - /// [Bit 18] If 1 indicates the processor supports the RDSEED instruct= ion. - /// - UINT32 RDSEED:1; - /// - /// [Bit 19] If 1 indicates the processor supports the ADCX and ADOX - /// instructions. - /// - UINT32 ADX:1; - /// - /// [Bit 20] Supports Supervisor-Mode Access Prevention (and the CLAC/= STAC - /// instructions) if 1. - /// - UINT32 SMAP:1; - /// - /// [Bit 21] AVX512_IFMA. - /// - UINT32 AVX512_IFMA:1; - UINT32 Reserved6:1; - /// - /// [Bit 23] If 1 indicates the processor supports the CLFLUSHOPT inst= ruction. - /// - UINT32 CLFLUSHOPT:1; - /// - /// [Bit 24] If 1 indicates the processor supports the CLWB instructio= n. - /// - UINT32 CLWB:1; - /// - /// [Bit 25] If 1 indicates the processor supports the Intel Processor= Trace - /// extensions. - /// - UINT32 IntelProcessorTrace:1; - /// - /// [Bit 26] AVX512PF. (Intel Xeon Phi only.). - /// - UINT32 AVX512PF:1; - /// - /// [Bit 27] AVX512ER. (Intel Xeon Phi only.). - /// - UINT32 AVX512ER:1; - /// - /// [Bit 28] AVX512CD. - /// - UINT32 AVX512CD:1; - /// - /// [Bit 29] Supports Intel(R) Secure Hash Algorithm Extensions (Intel= (R) - /// SHA Extensions) if 1. - /// - UINT32 SHA:1; - /// - /// [Bit 30] AVX512BW. - /// - UINT32 AVX512BW:1; - /// - /// [Bit 31] AVX512VL. - /// - UINT32 AVX512VL:1; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EBX; - -/** - CPUID Structured Extended Feature Flags Enumeration in ECX for CPUID leaf - #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS sub leaf - #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] If 1 indicates the processor supports the PREFETCHWT1 inst= ruction. - /// (Intel Xeon Phi only.) - /// - UINT32 PREFETCHWT1:1; - /// - /// [Bit 1] AVX512_VBMI. - /// - UINT32 AVX512_VBMI:1; - /// - /// [Bit 2] Supports user-mode instruction prevention if 1. - /// - UINT32 UMIP:1; - /// - /// [Bit 3] Supports protection keys for user-mode pages if 1. - /// - UINT32 PKU:1; - /// - /// [Bit 4] If 1, OS has set CR4.PKE to enable protection keys (and the - /// RDPKRU/WRPKRU instructions). - /// - UINT32 OSPKE:1; - UINT32 Reserved5:9; - /// - /// [Bits 14] AVX512_VPOPCNTDQ. (Intel Xeon Phi only.). - /// - UINT32 AVX512_VPOPCNTDQ:1; - UINT32 Reserved7:1; - /// - /// [Bits 16] Supports 5-level paging if 1. - /// - UINT32 FiveLevelPage:1; - /// - /// [Bits 21:17] The value of MAWAU used by the BNDLDX and BNDSTX inst= ructions - /// in 64-bit mode. - /// - UINT32 MAWAU:5; - /// - /// [Bit 22] RDPID and IA32_TSC_AUX are available if 1. - /// - UINT32 RDPID:1; - UINT32 Reserved3:7; - /// - /// [Bit 30] Supports SGX Launch Configuration if 1. - /// - UINT32 SGX_LC:1; - UINT32 Reserved4:1; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX; - -/** - CPUID Structured Extended Feature Flags Enumeration in EDX for CPUID leaf - #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS sub leaf - #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 1:0] Reserved. - /// - UINT32 Reserved1:2; - /// - /// [Bit 2] AVX512_4VNNIW. (Intel Xeon Phi only.) - /// - UINT32 AVX512_4VNNIW:1; - /// - /// [Bit 3] AVX512_4FMAPS. (Intel Xeon Phi only.) - /// - UINT32 AVX512_4FMAPS:1; - /// - /// [Bit 25:4] Reserved. - /// - UINT32 Reserved2:22; - /// - /// [Bit 26] Enumerates support for indirect branch restricted specula= tion - /// (IBRS) and the indirect branch pre-dictor barrier (IBPB). Processo= rs - /// that set this bit support the IA32_SPEC_CTRL MSR and the IA32_PRED= _CMD - /// MSR. They allow software to set IA32_SPEC_CTRL[0] (IBRS) and - /// IA32_PRED_CMD[0] (IBPB). - /// - UINT32 EnumeratesSupportForIBRSAndIBPB:1; - /// - /// [Bit 27] Enumerates support for single thread indirect branch - /// predictors (STIBP). Processors that set this bit support the - /// IA32_SPEC_CTRL MSR. They allow software to set IA32_SPEC_CTRL[1] - /// (STIBP). - /// - UINT32 EnumeratesSupportForSTIBP:1; - /// - /// [Bit 28] Enumerates support for L1D_FLUSH. Processors that set thi= s bit - /// support the IA32_FLUSH_CMD MSR. They allow software to set - /// IA32_FLUSH_CMD[0] (L1D_FLUSH). - /// - UINT32 EnumeratesSupportForL1D_FLUSH:1; - /// - /// [Bit 29] Enumerates support for the IA32_ARCH_CAPABILITIES MSR. - /// - UINT32 EnumeratesSupportForCapability:1; - /// - /// [Bit 30] Reserved. - /// - UINT32 Reserved3:1; - /// - /// [Bit 31] Enumerates support for Speculative Store Bypass Disable (= SSBD). - /// Processors that set this bit sup-port the IA32_SPEC_CTRL MSR. They= allow - /// software to set IA32_SPEC_CTRL[2] (SSBD). - /// - UINT32 EnumeratesSupportForSSBD:1; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EDX; - -/** - CPUID Direct Cache Access Information - - @param EAX CPUID_DIRECT_CACHE_ACCESS_INFO (0x09) - - @retval EAX Value of bits [31:0] of IA32_PLATFORM_DCA_CAP MSR (address= 1F8H). - @retval EBX Reserved. - @retval ECX Reserved. - @retval EDX Reserved. - - Example usage - @code - UINT32 Eax; - - AsmCpuid (CPUID_DIRECT_CACHE_ACCESS_INFO, &Eax, NULL, NULL, NULL); - @endcode -**/ -#define CPUID_DIRECT_CACHE_ACCESS_INFO 0x09 - - -/** - CPUID Architectural Performance Monitoring - - @param EAX CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING (0x0A) - - @retval EAX Architectural Performance Monitoring information described= by - the type CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EAX. - @retval EBX Architectural Performance Monitoring information described= by - the type CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EBX. - @retval ECX Reserved. - @retval EDX Architectural Performance Monitoring information described= by - the type CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EDX. - - Example usage - @code - CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EAX Eax; - CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EBX Ebx; - CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EDX Edx; - - AsmCpuid (CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING, &Eax.Uint32, &Ebx.= Uint32, NULL, &Edx.Uint32); - @endcode -**/ -#define CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING 0x0A - -/** - CPUID Architectural Performance Monitoring EAX for CPUID leaf - #CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 7:0] Version ID of architectural performance monitoring. - /// - UINT32 ArchPerfMonVerID:8; - /// - /// [Bits 15:8] Number of general-purpose performance monitoring count= er - /// per logical processor. - /// - /// IA32_PERFEVTSELx MSRs start at address 186H and occupy a contiguous - /// block of MSR address space. Each performance event select register= is - /// paired with a corresponding performance counter in the 0C1H address - /// block. - /// - UINT32 PerformanceMonitorCounters:8; - /// - /// [Bits 23:16] Bit width of general-purpose, performance monitoring = counter. - /// - /// The bit width of an IA32_PMCx MSR. This the number of valid bits f= or - /// read operation. On write operations, the lower-order 32 bits of th= e MSR - /// may be written with any value, and the high-order bits are sign-ex= tended - /// from the value of bit 31. - /// - UINT32 PerformanceMonitorCounterWidth:8; - /// - /// [Bits 31:24] Length of EBX bit vector to enumerate architectural - /// performance monitoring events. - /// - UINT32 EbxBitVectorLength:8; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EAX; - -/** - CPUID Architectural Performance Monitoring EBX for CPUID leaf - #CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Core cycle event not available if 1. - /// - UINT32 UnhaltedCoreCycles:1; - /// - /// [Bit 1] Instruction retired event not available if 1. - /// - UINT32 InstructionsRetired:1; - /// - /// [Bit 2] Reference cycles event not available if 1. - /// - UINT32 UnhaltedReferenceCycles:1; - /// - /// [Bit 3] Last-level cache reference event not available if 1. - /// - UINT32 LastLevelCacheReferences:1; - /// - /// [Bit 4] Last-level cache misses event not available if 1. - /// - UINT32 LastLevelCacheMisses:1; - /// - /// [Bit 5] Branch instruction retired event not available if 1. - /// - UINT32 BranchInstructionsRetired:1; - /// - /// [Bit 6] Branch mispredict retired event not available if 1. - /// - UINT32 AllBranchMispredictRetired:1; - UINT32 Reserved:25; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EBX; - -/** - CPUID Architectural Performance Monitoring EDX for CPUID leaf - #CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 4:0] Number of fixed-function performance counters - /// (if Version ID > 1). - /// - UINT32 FixedFunctionPerformanceCounters:5; - /// - /// [Bits 12:5] Bit width of fixed-function performance counters - /// (if Version ID > 1). - /// - UINT32 FixedFunctionPerformanceCounterWidth:8; - UINT32 Reserved1:2; - /// - /// [Bits 15] AnyThread deprecation. - /// - UINT32 AnyThreadDeprecation:1; - UINT32 Reserved2:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EDX; - - -/** - CPUID Extended Topology Information - - @note - CPUID leaf 1FH is a preferred superset to leaf 0BH. Intel recommends fir= st - checking for the existence of Leaf 1FH before using leaf 0BH. - Most of Leaf 0BH output depends on the initial value in ECX. The EDX ou= tput - of leaf 0BH is always valid and does not vary with input value in ECX. = Output - value in ECX[7:0] always equals input value in ECX[7:0]. - Sub-leaf index 0 enumerates SMT level. Each subsequent higher sub-leaf i= ndex - enumerates a higher-level topological entity in hierarchical order. - For sub-leaves that return an invalid level-type of 0 in ECX[15:8]; EAX = and - EBX will return 0. - If an input value n in ECX returns the invalid level-type of 0 in ECX[15= :8], - other input values with ECX > n also return 0 in ECX[15:8]. - - @param EAX CPUID_EXTENDED_TOPOLOGY (0x0B) - @param ECX Level number - - @retval EAX Extended topology information described by the type - CPUID_EXTENDED_TOPOLOGY_EAX. - @retval EBX Extended topology information described by the type - CPUID_EXTENDED_TOPOLOGY_EBX. - @retval ECX Extended topology information described by the type - CPUID_EXTENDED_TOPOLOGY_ECX. - @retval EDX x2APIC ID the current logical processor. - - Example usage - @code - CPUID_EXTENDED_TOPOLOGY_EAX Eax; - CPUID_EXTENDED_TOPOLOGY_EBX Ebx; - CPUID_EXTENDED_TOPOLOGY_ECX Ecx; - UINT32 Edx; - UINT32 LevelNumber; - - LevelNumber =3D 0; - do { - AsmCpuidEx ( - CPUID_EXTENDED_TOPOLOGY, LevelNumber, - &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx - ); - LevelNumber++; - } while (Eax.Bits.ApicIdShift !=3D 0); - @endcode -**/ -#define CPUID_EXTENDED_TOPOLOGY 0x0B - -/** - CPUID Extended Topology Information EAX for CPUID leaf #CPUID_EXTENDED_T= OPOLOGY. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 4:0] Number of bits to shift right on x2APIC ID to get a uni= que - /// topology ID of the next level type. All logical processors with t= he - /// same next level ID share current level. - /// - /// @note - /// Software should use this field (EAX[4:0]) to enumerate processor - /// topology of the system. - /// - UINT32 ApicIdShift:5; - UINT32 Reserved:27; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_TOPOLOGY_EAX; - -/** - CPUID Extended Topology Information EBX for CPUID leaf #CPUID_EXTENDED_T= OPOLOGY. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Number of logical processors at this level type. The n= umber - /// reflects configuration as shipped by Intel. - /// - /// @note - /// Software must not use EBX[15:0] to enumerate processor topology of= the - /// system. This value in this field (EBX[15:0]) is only intended for - /// display/diagnostic purposes. The actual number of logical processo= rs - /// available to BIOS/OS/Applications may be different from the value = of - /// EBX[15:0], depending on software and platform hardware configurati= ons. - /// - UINT32 LogicalProcessors:16; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_TOPOLOGY_EBX; - -/** - CPUID Extended Topology Information ECX for CPUID leaf #CPUID_EXTENDED_T= OPOLOGY. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Level number. Same value in ECX input. - /// - UINT32 LevelNumber:8; - /// - /// [Bits 15:8] Level type. - /// - /// @note - /// The value of the "level type" field is not related to level number= s in - /// any way, higher "level type" values do not mean higher levels. - /// - UINT32 LevelType:8; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_TOPOLOGY_ECX; - -/// -/// @{ Define value for CPUID_EXTENDED_TOPOLOGY_ECX.LevelType -/// -#define CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_INVALID 0x00 -#define CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_SMT 0x01 -#define CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_CORE 0x02 -/// -/// @} -/// - - -/** - CPUID Extended State Information - - @param EAX CPUID_EXTENDED_STATE (0x0D) - @param ECX CPUID_EXTENDED_STATE_MAIN_LEAF (0x00). - CPUID_EXTENDED_STATE_SUB_LEAF (0x01). - CPUID_EXTENDED_STATE_SIZE_OFFSET (0x02). - Sub leafs 2..n based on supported bits in XCR0 or IA32_XSS= _MSR. -**/ -#define CPUID_EXTENDED_STATE 0x0D - -/** - CPUID Extended State Information Main Leaf - - @param EAX CPUID_EXTENDED_STATE (0x0D) - @param ECX CPUID_EXTENDED_STATE_MAIN_LEAF (0x00) - - @retval EAX Reports the supported bits of the lower 32 bits of XCR0. X= CR0[n] - can be set to 1 only if EAX[n] is 1. The format of the ex= tended - state main leaf is described by the type - CPUID_EXTENDED_STATE_MAIN_LEAF_EAX. - @retval EBX Maximum size (bytes, from the beginning of the XSAVE/XRSTO= R save - area) required by enabled features in XCR0. May be differe= nt than - ECX if some features at the end of the XSAVE save area are= not - enabled. - @retval ECX Maximum size (bytes, from the beginning of the XSAVE/XRSTO= R save - area) of the XSAVE/XRSTOR save area required by all suppor= ted - features in the processor, i.e., all the valid bit fields = in XCR0. - @retval EDX Reports the supported bits of the upper 32 bits of XCR0. - XCR0[n+32] can be set to 1 only if EDX[n] is 1. - - Example usage - @code - CPUID_EXTENDED_STATE_MAIN_LEAF_EAX Eax; - UINT32 Ebx; - UINT32 Ecx; - UINT32 Edx; - - AsmCpuidEx ( - CPUID_EXTENDED_STATE, CPUID_EXTENDED_STATE_MAIN_LEAF, - &Eax.Uint32, &Ebx, &Ecx, &Edx - ); - @endcode -**/ -#define CPUID_EXTENDED_STATE_MAIN_LEAF 0x00 - -/** - CPUID Extended State Information EAX for CPUID leaf #CPUID_EXTENDED_STAT= E, - sub-leaf #CPUID_EXTENDED_STATE_MAIN_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] x87 state. - /// - UINT32 x87:1; - /// - /// [Bit 1] SSE state. - /// - UINT32 SSE:1; - /// - /// [Bit 2] AVX state. - /// - UINT32 AVX:1; - /// - /// [Bits 4:3] MPX state. - /// - UINT32 MPX:2; - /// - /// [Bits 7:5] AVX-512 state. - /// - UINT32 AVX_512:3; - /// - /// [Bit 8] Used for IA32_XSS. - /// - UINT32 IA32_XSS:1; - /// - /// [Bit 9] PKRU state. - /// - UINT32 PKRU:1; - UINT32 Reserved1:3; - /// - /// [Bit 13] Used for IA32_XSS, part 2. - /// - UINT32 IA32_XSS_2:1; - UINT32 Reserved2:18; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_STATE_MAIN_LEAF_EAX; - -/** - CPUID Extended State Information Sub Leaf - - @param EAX CPUID_EXTENDED_STATE (0x0D) - @param ECX CPUID_EXTENDED_STATE_SUB_LEAF (0x01) - - @retval EAX The format of the extended state sub-leaf is described by = the - type CPUID_EXTENDED_STATE_SUB_LEAF_EAX. - @retval EBX The size in bytes of the XSAVE area containing all states - enabled by XCRO | IA32_XSS. - @retval ECX The format of the extended state sub-leaf is described by = the - type CPUID_EXTENDED_STATE_SUB_LEAF_ECX. - @retval EDX Reports the supported bits of the upper 32 bits of the - IA32_XSS MSR. IA32_XSS[n+32] can be set to 1 only if EDX[n= ] is 1. - - Example usage - @code - CPUID_EXTENDED_STATE_SUB_LEAF_EAX Eax; - UINT32 Ebx; - CPUID_EXTENDED_STATE_SUB_LEAF_ECX Ecx; - UINT32 Edx; - - AsmCpuidEx ( - CPUID_EXTENDED_STATE, CPUID_EXTENDED_STATE_SUB_LEAF, - &Eax.Uint32, &Ebx, &Ecx.Uint32, &Edx - ); - @endcode -**/ -#define CPUID_EXTENDED_STATE_SUB_LEAF 0x01 - -/** - CPUID Extended State Information EAX for CPUID leaf #CPUID_EXTENDED_STAT= E, - sub-leaf #CPUID_EXTENDED_STATE_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] XSAVEOPT is available. - /// - UINT32 XSAVEOPT:1; - /// - /// [Bit 1] Supports XSAVEC and the compacted form of XRSTOR if set. - /// - UINT32 XSAVEC:1; - /// - /// [Bit 2] Supports XGETBV with ECX =3D 1 if set. - /// - UINT32 XGETBV:1; - /// - /// [Bit 3] Supports XSAVES/XRSTORS and IA32_XSS if set. - /// - UINT32 XSAVES:1; - UINT32 Reserved:28; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_STATE_SUB_LEAF_EAX; - -/** - CPUID Extended State Information ECX for CPUID leaf #CPUID_EXTENDED_STAT= E, - sub-leaf #CPUID_EXTENDED_STATE_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Used for XCR0. - /// - UINT32 XCR0:1; - /// - /// [Bit 8] PT STate. - /// - UINT32 PT:1; - /// - /// [Bit 9] Used for XCR0. - /// - UINT32 XCR0_1:1; - UINT32 Reserved1:3; - /// - /// [Bit 13] HWP state. - /// - UINT32 HWPState:1; - UINT32 Reserved8:18; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_STATE_SUB_LEAF_ECX; - -/** - CPUID Extended State Information Size and Offset Sub Leaf - - @note - Leaf 0DH output depends on the initial value in ECX. - Each sub-leaf index (starting at position 2) is supported if it correspo= nds to - a supported bit in either the XCR0 register or the IA32_XSS MSR. - If ECX contains an invalid sub-leaf index, EAX/EBX/ECX/EDX return 0. Sub= -leaf - n (0 <=3D n <=3D 31) is invalid if sub-leaf 0 returns 0 in EAX[n] and su= b-leaf 1 - returns 0 in ECX[n]. Sub-leaf n (32 <=3D n <=3D 63) is invalid if sub-le= af 0 - returns 0 in EDX[n-32] and sub-leaf 1 returns 0 in EDX[n-32]. - - @param EAX CPUID_EXTENDED_STATE (0x0D) - @param ECX CPUID_EXTENDED_STATE_SIZE_OFFSET (0x02). Sub leafs 2..n b= ased - on supported bits in XCR0 or IA32_XSS_MSR. - - @retval EAX The size in bytes (from the offset specified in EBX) of th= e save - area for an extended state feature associated with a valid - sub-leaf index, n. - @retval EBX The offset in bytes of this extended state component's sav= e area - from the beginning of the XSAVE/XRSTOR area. This field r= eports - 0 if the sub-leaf index, n, does not map to a valid bit in= the - XCR0 register. - @retval ECX The format of the extended state components's save area as - described by the type CPUID_EXTENDED_STATE_SIZE_OFFSET_ECX. - This field reports 0 if the sub-leaf index, n, is invalid. - @retval EDX This field reports 0 if the sub-leaf index, n, is invalid; - otherwise it is reserved. - - Example usage - @code - UINT32 Eax; - UINT32 Ebx; - CPUID_EXTENDED_STATE_SIZE_OFFSET_ECX Ecx; - UINT32 Edx; - UINTN SubLeaf; - - for (SubLeaf =3D CPUID_EXTENDED_STATE_SIZE_OFFSET; SubLeaf < 32; SubLeaf= ++) { - AsmCpuidEx ( - CPUID_EXTENDED_STATE, SubLeaf, - &Eax, &Ebx, &Ecx.Uint32, &Edx - ); - } - @endcode -**/ -#define CPUID_EXTENDED_STATE_SIZE_OFFSET 0x02 - -/** - CPUID Extended State Information ECX for CPUID leaf #CPUID_EXTENDED_STAT= E, - sub-leaf #CPUID_EXTENDED_STATE_SIZE_OFFSET. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Is set if the bit n (corresponding to the sub-leaf index) = is - /// supported in the IA32_XSS MSR; it is clear if bit n is instead sup= ported - /// in XCR0. - /// - UINT32 XSS:1; - /// - /// [Bit 1] is set if, when the compacted format of an XSAVE area is u= sed, - /// this extended state component located on the next 64-byte boundary - /// following the preceding state component (otherwise, it is located - /// immediately following the preceding state component). - /// - UINT32 Compacted:1; - UINT32 Reserved:30; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_STATE_SIZE_OFFSET_ECX; - - -/** - CPUID Intel Resource Director Technology (Intel RDT) Monitoring Informat= ion - - @param EAX CPUID_INTEL_RDT_MONITORING (0x0F) - @param ECX CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF (0x00). - CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF (0x01). - -**/ -#define CPUID_INTEL_RDT_MONITORING 0x0F - -/** - CPUID Intel Resource Director Technology (Intel RDT) Monitoring Informat= ion - Enumeration Sub-leaf - - @param EAX CPUID_INTEL_RDT_MONITORING (0x0F) - @param ECX CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF (0x00) - - @retval EAX Reserved. - @retval EBX Maximum range (zero-based) of RMID within this physical - processor of all types. - @retval ECX Reserved. - @retval EDX L3 Cache Intel RDT Monitoring Information Enumeration desc= ribed by - the type CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF_E= DX. - - Example usage - @code - UINT32 Ebx; - CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF_EDX Edx; - - AsmCpuidEx ( - CPUID_INTEL_RDT_MONITORING, CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB= _LEAF, - NULL, &Ebx, NULL, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF 0x00 - -/** - CPUID Intel RDT Monitoring Information EDX for CPUID leaf - #CPUID_INTEL_RDT_MONITORING, sub-leaf - #CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved1:1; - /// - /// [Bit 1] Supports L3 Cache Intel RDT Monitoring if 1. - /// - UINT32 L3CacheRDT_M:1; - UINT32 Reserved2:30; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_MONITORING_ENUMERATION_SUB_LEAF_EDX; - -/** - CPUID L3 Cache Intel RDT Monitoring Capability Enumeration Sub-leaf - - @param EAX CPUID_INTEL_RDT_MONITORING (0x0F) - @param ECX CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF (0x01) - - @retval EAX Reserved. - @retval EBX Conversion factor from reported IA32_QM_CTR value to occup= ancy metric (bytes). - @retval ECX Maximum range (zero-based) of RMID of this resource type. - @retval EDX L3 Cache Intel RDT Monitoring Capability information descr= ibed by the - type CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF_EDX. - - Example usage - @code - UINT32 Ebx; - UINT32 Ecx; - CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF_EDX Edx; - - AsmCpuidEx ( - CPUID_INTEL_RDT_MONITORING, CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LE= AF, - NULL, &Ebx, &Ecx, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF 0x01 - -/** - CPUID L3 Cache Intel RDT Monitoring Capability Information EDX for CPUID= leaf - #CPUID_INTEL_RDT_MONITORING, sub-leaf - #CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Supports L3 occupancy monitoring if 1. - /// - UINT32 L3CacheOccupancyMonitoring:1; - /// - /// [Bit 1] Supports L3 Total Bandwidth monitoring if 1. - /// - UINT32 L3CacheTotalBandwidthMonitoring:1; - /// - /// [Bit 2] Supports L3 Local Bandwidth monitoring if 1. - /// - UINT32 L3CacheLocalBandwidthMonitoring:1; - UINT32 Reserved:29; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_MONITORING_L3_CACHE_SUB_LEAF_EDX; - - -/** - CPUID Intel Resource Director Technology (Intel RDT) Allocation Informat= ion - - @param EAX CPUID_INTEL_RDT_ALLOCATION (0x10). - @param ECX CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF (0x00). - CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF (0x01). - CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF (0x02). -**/ -#define CPUID_INTEL_RDT_ALLOCATION 0x10 - -/** - Intel Resource Director Technology (Intel RDT) Allocation Enumeration Su= b-leaf - - @param EAX CPUID_INTEL_RDT_ALLOCATION (0x10) - @param ECX CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF (0x00). - - @retval EAX Reserved. - @retval EBX L3 and L2 Cache Allocation Technology information describe= d by - the type CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF_E= BX. - @retval ECX Reserved. - @retval EDX Reserved. - - Example usage - @code - CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF_EBX Ebx; - - AsmCpuidEx ( - CPUID_INTEL_RDT_ALLOCATION, CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB= _LEAF, - NULL, &Ebx.Uint32, NULL, NULL - ); - @endcode -**/ -#define CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF 0x00 - -/** - CPUID L3 and L2 Cache Allocation Support Information EBX for CPUID leaf - #CPUID_INTEL_RDT_ALLOCATION, sub-leaf - #CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved1:1; - /// - /// [Bit 1] Supports L3 Cache Allocation Technology if 1. - /// - UINT32 L3CacheAllocation:1; - /// - /// [Bit 2] Supports L2 Cache Allocation Technology if 1. - /// - UINT32 L2CacheAllocation:1; - /// - /// [Bit 3] Supports Memory Bandwidth Allocation if 1. - /// - UINT32 MemoryBandwidth:1; - UINT32 Reserved3:28; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_ALLOCATION_ENUMERATION_SUB_LEAF_EBX; - - -/** - L3 Cache Allocation Technology Enumeration Sub-leaf - - @param EAX CPUID_INTEL_RDT_ALLOCATION (0x10) - @param ECX CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF (0x01) - - @retval EAX RESID L3 Cache Allocation Technology information described= by - the type CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EAX. - @retval EBX Bit-granular map of isolation/contention of allocation uni= ts. - @retval ECX RESID L3 Cache Allocation Technology information described= by - the type CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_ECX. - @retval EDX RESID L3 Cache Allocation Technology information described= by - the type CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EDX. - - Example usage - @code - CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EAX Eax; - UINT32 Ebx; - CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_ECX Ecx; - CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EDX Edx; - - AsmCpuidEx ( - CPUID_INTEL_RDT_ALLOCATION, CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LE= AF, - &Eax.Uint32, &Ebx, &Ecx.Uint32, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF 0x01 - -/** - CPUID L3 Cache Allocation Technology Information EAX for CPUID leaf - #CPUID_INTEL_RDT_ALLOCATION, sub-leaf - #CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 4:0] Length of the capacity bit mask for the corresponding R= esID - /// using minus-one notation. - /// - UINT32 CapacityLength:5; - UINT32 Reserved:27; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EAX; - -/** - CPUID L3 Cache Allocation Technology Information ECX for CPUID leaf - #CPUID_INTEL_RDT_ALLOCATION, sub-leaf - #CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved3:2; - /// - /// [Bit 2] Code and Data Prioritization Technology supported if 1. - /// - UINT32 CodeDataPrioritization:1; - UINT32 Reserved2:29; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_ECX; - -/** - CPUID L3 Cache Allocation Technology Information EDX for CPUID leaf - #CPUID_INTEL_RDT_ALLOCATION, sub-leaf - #CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Highest COS number supported for this ResID. - /// - UINT32 HighestCosNumber:16; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_ALLOCATION_L3_CACHE_SUB_LEAF_EDX; - -/** - L2 Cache Allocation Technology Enumeration Sub-leaf - - @param EAX CPUID_INTEL_RDT_ALLOCATION (0x10) - @param ECX CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF (0x02) - - @retval EAX RESID L2 Cache Allocation Technology information described= by - the type CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EAX. - @retval EBX Bit-granular map of isolation/contention of allocation uni= ts. - @retval ECX Reserved. - @retval EDX RESID L2 Cache Allocation Technology information described= by - the type CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EDX. - - Example usage - @code - CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EAX Eax; - UINT32 Ebx; - CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EDX Edx; - - AsmCpuidEx ( - CPUID_INTEL_RDT_ALLOCATION, CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LE= AF, - &Eax.Uint32, &Ebx, NULL, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF 0x02 - -/** - CPUID L2 Cache Allocation Technology Information EAX for CPUID leaf - #CPUID_INTEL_RDT_ALLOCATION, sub-leaf - #CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 4:0] Length of the capacity bit mask for the corresponding R= esID - /// using minus-one notation. - /// - UINT32 CapacityLength:5; - UINT32 Reserved:27; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EAX; - -/** - CPUID L2 Cache Allocation Technology Information EDX for CPUID leaf - #CPUID_INTEL_RDT_ALLOCATION, sub-leaf - #CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Highest COS number supported for this ResID. - /// - UINT32 HighestCosNumber:16; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_ALLOCATION_L2_CACHE_SUB_LEAF_EDX; - -/** - Memory Bandwidth Allocation Enumeration Sub-leaf - - @param EAX CPUID_INTEL_RDT_ALLOCATION (0x10) - @param ECX CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF (0x03) - - @retval EAX RESID memory bandwidth Allocation Technology information - described by the type - CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EAX. - @retval EBX Reserved. - @retval ECX RESID memory bandwidth Allocation Technology information - described by the type - CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_ECX. - @retval EDX RESID memory bandwidth Allocation Technology information - described by the type - CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EDX. - - Example usage - @code - CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EAX Eax; - UINT32 Ebx; - CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_ECX Ecx; - CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EDX Edx; - - - AsmCpuidEx ( - CPUID_INTEL_RDT_ALLOCATION, CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDT= H_SUB_LEAF, - &Eax.Uint32, &Ebx, NULL, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF 0x03 - -/** - CPUID memory bandwidth Allocation Technology Information EAX for CPUID l= eaf - #CPUID_INTEL_RDT_ALLOCATION, sub-leaf - #CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 11:0] Reports the maximum MBA throttling value supported for - /// the corresponding ResID using minus-one notation. - /// - UINT32 MaximumMBAThrottling:12; - UINT32 Reserved:20; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EAX; - -/** - CPUID memory bandwidth Allocation Technology Information ECX for CPUID l= eaf - #CPUID_INTEL_RDT_ALLOCATION, sub-leaf - #CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 1:0] Reserved. - /// - UINT32 Reserved1:2; - /// - /// [Bits 3] Reports whether the response of the delay values is linea= r. - /// - UINT32 Liner:1; - UINT32 Reserved2:29; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_ECX; - -/** - CPUID memory bandwidth Allocation Technology Information EDX for CPUID l= eaf - #CPUID_INTEL_RDT_ALLOCATION, sub-leaf - #CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Highest COS number supported for this ResID. - /// - UINT32 HighestCosNumber:16; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_RDT_ALLOCATION_MEMORY_BANDWIDTH_SUB_LEAF_EDX; - -/** - Intel SGX resource capability and configuration. - See Section 37.7.2 "Intel(R) SGX Resource Enumeration Leaves". - - If CPUID.(EAX=3D07H, ECX=3D0H):EBX.SGX =3D 1, the processor also support= s querying - CPUID with EAX=3D12H on Intel SGX resource capability and configuration. - - @param EAX CPUID_INTEL_SGX (0x12) - @param ECX CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF (0x00). - CPUID_INTEL_SGX_CAPABILITIES_1_SUB_LEAF (0x01). - CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF (0x02). - Sub leafs 2..n based on the sub-leaf-type encoding (return= ed in EAX[3:0]) - until the sub-leaf type is invalid. - -**/ -#define CPUID_INTEL_SGX 0x12 - -/** - Sub-Leaf 0 Enumeration of Intel SGX Capabilities. - Enumerates Intel SGX capability, including enclave instruction opcode su= pport. - - @param EAX CPUID_INTEL_SGX (0x12) - @param ECX CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF (0x00) - - @retval EAX The format of Sub-Leaf 0 Enumeration of Intel SGX Capabili= ties is - described by the type CPUID_INTEL_SGX_CAPABILITIES_0_SUB_L= EAF_EAX. - @retval EBX MISCSELECT: Reports the bit vector of supported extended f= eatures - that can be written to the MISC region of the SSA. - @retval ECX Reserved. - @retval EDX The format of Sub-Leaf 0 Enumeration of Intel SGX Capabili= ties is - described by the type CPUID_INTEL_SGX_CAPABILITIES_0_SUB_L= EAF_EDX. - - Example usage - @code - CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF_EAX Eax; - UINT32 Ebx; - CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF_EDX Edx; - - AsmCpuidEx ( - CPUID_INTEL_SGX, CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF, - &Eax.Uint32, &Ebx, NULL, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF 0x00 - -/** - Sub-Leaf 0 Enumeration of Intel SGX Capabilities EAX for CPUID leaf #CPU= ID_INTEL_SGX, - sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] If 1, indicates leaf functions of SGX1 instruction are sup= ported. - /// - UINT32 SGX1:1; - /// - /// [Bit 1] If 1, indicates leaf functions of SGX2 instruction are sup= ported. - /// - UINT32 SGX2:1; - UINT32 Reserved1:3; - /// - /// [Bit 5] If 1, indicates Intel SGX supports ENCLV instruction leaves - /// EINCVIRTCHILD, EDECVIRTCHILD, and ESETCONTEXT. - /// - UINT32 ENCLV:1; - /// - /// [Bit 6] If 1, indicates Intel SGX supports ENCLS instruction leave= s ETRACKC, - /// ERDINFO, ELDBC, and ELDUC. - /// - UINT32 ENCLS:1; - UINT32 Reserved2:25; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF_EAX; - -/** - Sub-Leaf 0 Enumeration of Intel SGX Capabilities EDX for CPUID leaf #CPU= ID_INTEL_SGX, - sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 7:0] The maximum supported enclave size is 2^(EDX[7:0]) bytes - /// when not in 64-bit mode. - /// - UINT32 MaxEnclaveSize_Not64:8; - /// - /// [Bit 15:8] The maximum supported enclave size is 2^(EDX[15:8]) byt= es - /// when operating in 64-bit mode. - /// - UINT32 MaxEnclaveSize_64:8; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_SGX_CAPABILITIES_0_SUB_LEAF_EDX; - - -/** - Sub-Leaf 1 Enumeration of Intel SGX Capabilities. - Enumerates Intel SGX capability of processor state configuration and enc= lave - configuration in the SECS structure. - - @param EAX CPUID_INTEL_SGX (0x12) - @param ECX CPUID_INTEL_SGX_CAPABILITIES_1_SUB_LEAF (0x01) - - @retval EAX Report the valid bits of SECS.ATTRIBUTES[31:0] that softwa= re can - set with ECREATE. SECS.ATTRIBUTES[n] can be set to 1 using= ECREATE - only if EAX[n] is 1, where n < 32. - @retval EBX Report the valid bits of SECS.ATTRIBUTES[63:32] that softw= are can - set with ECREATE. SECS.ATTRIBUTES[n+32] can be set to 1 us= ing ECREATE - only if EBX[n] is 1, where n < 32. - @retval ECX Report the valid bits of SECS.ATTRIBUTES[95:64] that softw= are can - set with ECREATE. SECS.ATTRIBUTES[n+64] can be set to 1 us= ing ECREATE - only if ECX[n] is 1, where n < 32. - @retval EDX Report the valid bits of SECS.ATTRIBUTES[127:96] that soft= ware can - set with ECREATE. SECS.ATTRIBUTES[n+96] can be set to 1 us= ing ECREATE - only if EDX[n] is 1, where n < 32. - - Example usage - @code - UINT32 Eax; - UINT32 Ebx; - UINT32 Ecx; - UINT32 Edx; - - AsmCpuidEx ( - CPUID_INTEL_SGX, CPUID_INTEL_SGX_CAPABILITIES_1_SUB_LEAF, - &Eax, &Ebx, &Ecx, &Edx - ); - @endcode -**/ -#define CPUID_INTEL_SGX_CAPABILITIES_1_SUB_LEAF 0x01 - - -/** - Sub-Leaf Index 2 or Higher Enumeration of Intel SGX Resources. - Enumerates available EPC resources. - - @param EAX CPUID_INTEL_SGX (0x12) - @param ECX CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF (0x02) - - @retval EAX The format of Sub-Leaf Index 2 or Higher Enumeration of In= tel SGX - Resources is described by the type - CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EAX. - @retval EBX The format of Sub-Leaf Index 2 or Higher Enumeration of In= tel SGX - Resources is described by the type - CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EBX. - @retval EDX The format of Sub-Leaf Index 2 or Higher Enumeration of In= tel SGX - Resources is described by the type - CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_ECX. - @retval EDX The format of Sub-Leaf Index 2 or Higher Enumeration of In= tel SGX - Resources is described by the type - CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EDX. - - Example usage - @code - CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EAX Eax; - CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EBX Ebx; - CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_ECX Ecx; - CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EDX Edx; - - AsmCpuidEx ( - CPUID_INTEL_SGX, CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF, - &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF 0x02 - -/** - Sub-Leaf Index 2 or Higher Enumeration of Intel SGX Resources EAX for CP= UID - leaf #CPUID_INTEL_SGX, sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_= SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 3:0] Sub-leaf-type encoding. - /// 0000b: This sub-leaf is invalid, EBX:EAX and EDX:ECX report 0. - /// 0001b: This sub-leaf provides information on the Enclave Page Cach= e (EPC) - /// in EBX:EAX and EDX:ECX. - /// All other encoding are reserved. - /// - UINT32 SubLeafType:4; - UINT32 Reserved:8; - /// - /// [Bit 31:12] If EAX[3:0] =3D 0001b, these are bits 31:12 of the phy= sical address of - /// the base of the EPC section. - /// - UINT32 LowAddressOfEpcSection:20; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EAX; - -/** - Sub-Leaf Index 2 or Higher Enumeration of Intel SGX Resources EBX for CP= UID - leaf #CPUID_INTEL_SGX, sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_= SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 19:0] If EAX[3:0] =3D 0001b, these are bits 51:32 of the phys= ical address of - /// the base of the EPC section. - /// - UINT32 HighAddressOfEpcSection:20; - UINT32 Reserved:12; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EBX; - -/** - Sub-Leaf Index 2 or Higher Enumeration of Intel SGX Resources ECX for CP= UID - leaf #CPUID_INTEL_SGX, sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_= SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 3:0] The EPC section encoding. - /// 0000b: Not valid. - /// 0001b: The EPC section is confidentiality, integrity and replay pr= otected. - /// All other encoding are reserved. - /// - UINT32 EpcSection:4; - UINT32 Reserved:8; - /// - /// [Bit 31:12] If EAX[3:0] =3D 0001b, these are bits 31:12 of the siz= e of the - /// corresponding EPC section within the Processor Reserved Memory. - /// - UINT32 LowSizeOfEpcSection:20; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_ECX; - -/** - Sub-Leaf Index 2 or Higher Enumeration of Intel SGX Resources EDX for CP= UID - leaf #CPUID_INTEL_SGX, sub-leaf #CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_= SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 19:0] If EAX[3:0] =3D 0001b, these are bits 51:32 of the size= of the - /// corresponding EPC section within the Processor Reserved Memory. - /// - UINT32 HighSizeOfEpcSection:20; - UINT32 Reserved:12; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_SGX_CAPABILITIES_RESOURCES_SUB_LEAF_EDX; - - -/** - CPUID Intel Processor Trace Information - - @param EAX CPUID_INTEL_PROCESSOR_TRACE (0x14) - @param ECX CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF (0x00). - CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF (0x01). - -**/ -#define CPUID_INTEL_PROCESSOR_TRACE 0x14 - -/** - CPUID Intel Processor Trace Information Main Leaf - - @param EAX CPUID_INTEL_PROCEDSSOR_TRACE (0x14) - @param ECX CPUID_INTEL_PROCEDSSOR_TRACE_MAIN_LEAF (0x00) - - @retval EAX Reports the maximum sub-leaf supported in leaf 14H. - @retval EBX Returns Intel processor trace information described by the - type CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_EBX. - @retval ECX Returns Intel processor trace information described by the - type CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_ECX. - @retval EDX Reserved. - - Example usage - @code - UINT32 Eax; - CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_EBX Ebx; - CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_ECX Ecx; - - AsmCpuidEx ( - CPUID_INTEL_PROCESSOR_TRACE, CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF, - &Eax, &Ebx.Uint32, &Ecx.Uint32, NULL - ); - @endcode -**/ -#define CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF 0x00 - -/** - CPUID Intel Processor Trace EBX for CPUID leaf #CPUID_INTEL_PROCESSOR_TR= ACE, - sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] If 1, indicates that IA32_RTIT_CTL.CR3Filter can be set to= 1, - /// and that IA32_RTIT_CR3_MATCH MSR can be accessed. - /// - UINT32 Cr3Filter:1; - /// - /// [Bit 1] If 1, indicates support of Configurable PSB and Cycle-Accu= rate - /// Mode. - /// - UINT32 ConfigurablePsb:1; - /// - /// [Bit 2] If 1, indicates support of IP Filtering, TraceStop filteri= ng, - /// and preservation of Intel PT MSRs across warm reset. - /// - UINT32 IpTraceStopFiltering:1; - /// - /// [Bit 3] If 1, indicates support of MTC timing packet and suppressi= on of - /// COFI-based packets. - /// - UINT32 Mtc:1; - /// - /// [Bit 4] If 1, indicates support of PTWRITE. Writes can set - /// IA32_RTIT_CTL[12] (PTWEn) and IA32_RTIT_CTL[5] (FUPonPTW), and PTW= RITE - /// can generate packets. - /// - UINT32 PTWrite:1; - /// - /// [Bit 5] If 1, indicates support of Power Event Trace. Writes can s= et - /// IA32_RTIT_CTL[4] (PwrEvtEn), enabling Power Event Trace packet - /// generation. - /// - UINT32 PowerEventTrace:1; - UINT32 Reserved:26; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_EBX; - -/** - CPUID Intel Processor Trace ECX for CPUID leaf #CPUID_INTEL_PROCESSOR_TR= ACE, - sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] If 1, Tracing can be enabled with IA32_RTIT_CTL.ToPA =3D 1= , hence - /// utilizing the ToPA output scheme; IA32_RTIT_OUTPUT_BASE and - /// IA32_RTIT_OUTPUT_MASK_PTRS MSRs can be accessed. - /// - UINT32 RTIT:1; - /// - /// [Bit 1] If 1, ToPA tables can hold any number of output entries, u= p to - /// the maximum allowed by the MaskOrTableOffset field of - /// IA32_RTIT_OUTPUT_MASK_PTRS. - /// - UINT32 ToPA:1; - /// - /// [Bit 2] If 1, indicates support of Single-Range Output scheme. - /// - UINT32 SingleRangeOutput:1; - /// - /// [Bit 3] If 1, indicates support of output to Trace Transport subsy= stem. - /// - UINT32 TraceTransportSubsystem:1; - UINT32 Reserved:27; - /// - /// [Bit 31] If 1, generated packets which contain IP payloads have LIP - /// values, which include the CS base component. - /// - UINT32 LIP:1; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_ECX; - - -/** - CPUID Intel Processor Trace Information Sub-leaf - - @param EAX CPUID_INTEL_PROCEDSSOR_TRACE (0x14) - @param ECX CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF (0x01) - - @retval EAX Returns Intel processor trace information described by the - type CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EAX. - @retval EBX Returns Intel processor trace information described by the - type CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EBX. - @retval ECX Reserved. - @retval EDX Reserved. - - Example usage - @code - UINT32 MaximumSubLeaf; - UINT32 SubLeaf; - CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EAX Eax; - CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EBX Ebx; - - AsmCpuidEx ( - CPUID_INTEL_PROCESSOR_TRACE, CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF, - &MaximumSubLeaf, NULL, NULL, NULL - ); - - for (SubLeaf =3D CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF; SubLeaf <=3D Maxi= mumSubLeaf; SubLeaf++) { - AsmCpuidEx ( - CPUID_INTEL_PROCESSOR_TRACE, SubLeaf, - &Eax.Uint32, &Ebx.Uint32, NULL, NULL - ); - } - @endcode -**/ -#define CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF 0x01 - -/** - CPUID Intel Processor Trace EAX for CPUID leaf #CPUID_INTEL_PROCESSOR_TR= ACE, - sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 2:0] Number of configurable Address Ranges for filtering. - /// - UINT32 ConfigurableAddressRanges:3; - UINT32 Reserved:13; - /// - /// [Bits 31:16] Bitmap of supported MTC period encodings - /// - UINT32 MtcPeriodEncodings:16; - - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EAX; - -/** - CPUID Intel Processor Trace EBX for CPUID leaf #CPUID_INTEL_PROCESSOR_TR= ACE, - sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Bitmap of supported Cycle Threshold value encodings. - /// - UINT32 CycleThresholdEncodings:16; - /// - /// [Bits 31:16] Bitmap of supported Configurable PSB frequency encodi= ngs. - /// - UINT32 PsbFrequencyEncodings:16; - - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EBX; - - -/** - CPUID Time Stamp Counter and Nominal Core Crystal Clock Information - - @note - If EBX[31:0] is 0, the TSC/"core crystal clock" ratio is not enumerated. - EBX[31:0]/EAX[31:0] indicates the ratio of the TSC frequency and the core - crystal clock frequency. - If ECX is 0, the nominal core crystal clock frequency is not enumerated. - "TSC frequency" =3D "core crystal clock frequency" * EBX/EAX. - The core crystal clock may differ from the reference clock, bus clock, o= r core - clock frequencies. - - @param EAX CPUID_TIME_STAMP_COUNTER (0x15) - - @retval EAX An unsigned integer which is the denominator of the - TSC/"core crystal clock" ratio - @retval EBX An unsigned integer which is the numerator of the - TSC/"core crystal clock" ratio. - @retval ECX An unsigned integer which is the nominal frequency - of the core crystal clock in Hz. - @retval EDX Reserved. - - Example usage - @code - UINT32 Eax; - UINT32 Ebx; - UINT32 Ecx; - - AsmCpuid (CPUID_TIME_STAMP_COUNTER, &Eax, &Ebx, &Ecx, NULL); - @endcode -**/ -#define CPUID_TIME_STAMP_COUNTER 0x15 - - -/** - CPUID Processor Frequency Information - - @note - Data is returned from this interface in accordance with the processor's - specification and does not reflect actual values. Suitable use of this d= ata - includes the display of processor information in like manner to the proc= essor - brand string and for determining the appropriate range to use when displ= aying - processor information e.g. frequency history graphs. The returned inform= ation - should not be used for any other purpose as the returned information doe= s not - accurately correlate to information / counters returned by other process= or - interfaces. While a processor may support the Processor Frequency Infor= mation - leaf, fields that return a value of zero are not supported. - - @param EAX CPUID_TIME_STAMP_COUNTER (0x16) - - @retval EAX Returns processor base frequency information described by = the - type CPUID_PROCESSOR_FREQUENCY_EAX. - @retval EBX Returns maximum frequency information described by the type - CPUID_PROCESSOR_FREQUENCY_EBX. - @retval ECX Returns bus frequency information described by the type - CPUID_PROCESSOR_FREQUENCY_ECX. - @retval EDX Reserved. - - Example usage - @code - CPUID_PROCESSOR_FREQUENCY_EAX Eax; - CPUID_PROCESSOR_FREQUENCY_EBX Ebx; - CPUID_PROCESSOR_FREQUENCY_ECX Ecx; - - AsmCpuid (CPUID_PROCESSOR_FREQUENCY, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint= 32, NULL); - @endcode -**/ -#define CPUID_PROCESSOR_FREQUENCY 0x16 - -/** - CPUID Processor Frequency Information EAX for CPUID leaf - #CPUID_PROCESSOR_FREQUENCY. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Processor Base Frequency (in MHz). - /// - UINT32 ProcessorBaseFrequency:16; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_PROCESSOR_FREQUENCY_EAX; - -/** - CPUID Processor Frequency Information EBX for CPUID leaf - #CPUID_PROCESSOR_FREQUENCY. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Maximum Frequency (in MHz). - /// - UINT32 MaximumFrequency:16; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_PROCESSOR_FREQUENCY_EBX; - -/** - CPUID Processor Frequency Information ECX for CPUID leaf - #CPUID_PROCESSOR_FREQUENCY. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Bus (Reference) Frequency (in MHz). - /// - UINT32 BusFrequency:16; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_PROCESSOR_FREQUENCY_ECX; - - -/** - CPUID SoC Vendor Information - - @param EAX CPUID_SOC_VENDOR (0x17) - @param ECX CPUID_SOC_VENDOR_MAIN_LEAF (0x00) - CPUID_SOC_VENDOR_BRAND_STRING1 (0x01) - CPUID_SOC_VENDOR_BRAND_STRING1 (0x02) - CPUID_SOC_VENDOR_BRAND_STRING1 (0x03) - - @note - Leaf 17H output depends on the initial value in ECX. SOC Vendor Brand S= tring - is a UTF-8 encoded string padded with trailing bytes of 00H. The comple= te SOC - Vendor Brand String is constructed by concatenating in ascending order of - EAX:EBX:ECX:EDX and from the sub-leaf 1 fragment towards sub-leaf 3. - -**/ -#define CPUID_SOC_VENDOR 0x17 - -/** - CPUID SoC Vendor Information - - @param EAX CPUID_SOC_VENDOR (0x17) - @param ECX CPUID_SOC_VENDOR_MAIN_LEAF (0x00) - - @retval EAX MaxSOCID_Index. Reports the maximum input value of support= ed - sub-leaf in leaf 17H. - @retval EBX Returns SoC Vendor information described by the type - CPUID_SOC_VENDOR_MAIN_LEAF_EBX. - @retval ECX Project ID. A unique number an SOC vendor assigns to its S= OC - projects. - @retval EDX Stepping ID. A unique number within an SOC project that an= SOC - vendor assigns. - - Example usage - @code - UINT32 Eax; - CPUID_SOC_VENDOR_MAIN_LEAF_EBX Ebx; - UINT32 Ecx; - UINT32 Edx; - - AsmCpuidEx ( - CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_MAIN_LEAF, - &Eax, &Ebx.Uint32, &Ecx, &Edx - ); - @endcode -**/ -#define CPUID_SOC_VENDOR_MAIN_LEAF 0x00 - -/** - CPUID SoC Vendor Information EBX for CPUID leaf #CPUID_SOC_VENDOR sub-le= af - #CPUID_SOC_VENDOR_MAIN_LEAF. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] SOC Vendor ID. - /// - UINT32 SocVendorId:16; - /// - /// [Bit 16] If 1, the SOC Vendor ID field is assigned via an industry - /// standard enumeration scheme. Otherwise, the SOC Vendor ID field is - /// assigned by Intel. - /// - UINT32 IsVendorScheme:1; - UINT32 Reserved:15; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_SOC_VENDOR_MAIN_LEAF_EBX; - -/** - CPUID SoC Vendor Information - - @param EAX CPUID_SOC_VENDOR (0x17) - @param ECX CPUID_SOC_VENDOR_BRAND_STRING1 (0x01) - - @retval EAX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - @retval EBX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - @retval ECX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - @retval EDX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - - Example usage - @code - CPUID_SOC_VENDOR_BRAND_STRING_DATA Eax; - CPUID_SOC_VENDOR_BRAND_STRING_DATA Ebx; - CPUID_SOC_VENDOR_BRAND_STRING_DATA Ecx; - CPUID_SOC_VENDOR_BRAND_STRING_DATA Edx; - - AsmCpuidEx ( - CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING1, - &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_SOC_VENDOR_BRAND_STRING1 0x01 - -/** - CPUID SoC Vendor Brand String for CPUID leafs #CPUID_SOC_VENDOR_BRAND_ST= RING1, - #CPUID_SOC_VENDOR_BRAND_STRING2, and #CPUID_SOC_VENDOR_BRAND_STRING3. -**/ -typedef union { - /// - /// 4 UTF-8 characters of Soc Vendor Brand String - /// - CHAR8 BrandString[4]; - /// - /// All fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_SOC_VENDOR_BRAND_STRING_DATA; - -/** - CPUID SoC Vendor Information - - @param EAX CPUID_SOC_VENDOR (0x17) - @param ECX CPUID_SOC_VENDOR_BRAND_STRING2 (0x02) - - @retval EAX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - @retval EBX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - @retval ECX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - @retval EDX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - - Example usage - @code - CPUID_SOC_VENDOR_BRAND_STRING_DATA Eax; - CPUID_SOC_VENDOR_BRAND_STRING_DATA Ebx; - CPUID_SOC_VENDOR_BRAND_STRING_DATA Ecx; - CPUID_SOC_VENDOR_BRAND_STRING_DATA Edx; - - AsmCpuidEx ( - CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING2, - &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_SOC_VENDOR_BRAND_STRING2 0x02 - -/** - CPUID SoC Vendor Information - - @param EAX CPUID_SOC_VENDOR (0x17) - @param ECX CPUID_SOC_VENDOR_BRAND_STRING3 (0x03) - - @retval EAX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - @retval EBX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - @retval ECX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - @retval EDX SOC Vendor Brand String. UTF-8 encoded string of type - CPUID_SOC_VENDOR_BRAND_STRING_DATA. - - Example usage - @code - CPUID_SOC_VENDOR_BRAND_STRING_DATA Eax; - CPUID_SOC_VENDOR_BRAND_STRING_DATA Ebx; - CPUID_SOC_VENDOR_BRAND_STRING_DATA Ecx; - CPUID_SOC_VENDOR_BRAND_STRING_DATA Edx; - - AsmCpuidEx ( - CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING3, - &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_SOC_VENDOR_BRAND_STRING3 0x03 - -/** - CPUID Deterministic Address Translation Parameters - - @note - Each sub-leaf enumerates a different address translation structure. - If ECX contains an invalid sub-leaf index, EAX/EBX/ECX/EDX return 0. Sub= -leaf - index n is invalid if n exceeds the value that sub-leaf 0 returns in EAX= . A - sub-leaf index is also invalid if EDX[4:0] returns 0. - Valid sub-leaves do not need to be contiguous or in any particular order= . A - valid sub-leaf may be in a higher input ECX value than an invalid sub-le= af or - than a valid sub-leaf of a higher or lower-level structure. - * Some unified TLBs will allow a single TLB entry to satisfy data read/w= rite - and instruction fetches. Others will require separate entries (e.g., one - loaded on data read/write and another loaded on an instruction fetch). - Please see the Intel 64 and IA-32 Architectures Optimization Reference M= anual - for details of a particular product. - ** Add one to the return value to get the result. - - @param EAX CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS (0x18) - @param ECX CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_MAIN_LE= AF (0x00) - CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_SUB_LEA= F (0x*) - -**/ -#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS 0x18 - -/** - CPUID Deterministic Address Translation Parameters - - @param EAX CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS (0x18) - @param ECX CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_MAIN_LE= AF (0x00) - - @retval EAX Reports the maximum input value of supported sub-leaf in l= eaf 18H. - @retval EBX Returns Deterministic Address Translation Parameters descr= ibed by - the type CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETER= S_EBX. - @retval ECX Number of Sets. - @retval EDX Returns Deterministic Address Translation Parameters descr= ibed by - the type CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETER= S_EDX. - - Example usage - @code - UINT32 Eax; - CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_EBX Ebx; - UINT32 Ecx; - CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_EDX Edx; - - AsmCpuidEx ( - CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS, - CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_MAIN_LEAF, - &Eax, &Ebx.Uint32, &Ecx, &Edx.Uint32 - ); - @endcode -**/ -#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_MAIN_LEAF 0x00 - -/** - CPUID Deterministic Address Translation Parameters EBX for CPUID leafs. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 0] 4K page size entries supported by this structure. - /// - UINT32 Page4K:1; - /// - /// [Bits 1] 2MB page size entries supported by this structure. - /// - UINT32 Page2M:1; - /// - /// [Bits 2] 4MB page size entries supported by this structure. - /// - UINT32 Page4M:1; - /// - /// [Bits 3] 1 GB page size entries supported by this structure. - /// - UINT32 Page1G:1; - /// - /// [Bits 7:4] Reserved. - /// - UINT32 Reserved1:4; - /// - /// [Bits 10:8] Partitioning (0: Soft partitioning between the logical - /// processors sharing this structure) - /// - UINT32 Partitioning:3; - /// - /// [Bits 15:11] Reserved. - /// - UINT32 Reserved2:5; - /// - /// [Bits 31:16] W =3D Ways of associativity. - /// - UINT32 Way:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_EBX; - -/** - CPUID Deterministic Address Translation Parameters EDX for CPUID leafs. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 4:0] Translation cache type field. - /// - UINT32 TranslationCacheType:5; - /// - /// [Bits 7:5] Translation cache level (starts at 1). - /// - UINT32 TranslationCacheLevel:3; - /// - /// [Bits 8] Fully associative structure. - /// - UINT32 FullyAssociative:1; - /// - /// [Bits 13:9] Reserved. - /// - UINT32 Reserved1:5; - /// - /// [Bits 25:14] Maximum number of addressable IDs for logical - /// processors sharing this translation cache. - /// - UINT32 MaximumNum:12; - /// - /// [Bits 31:26] Reserved. - /// - UINT32 Reserved2:6; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_EDX; - -/// -/// @{ Define value for CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS= _EDX.TranslationCacheType -/// -#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_TRANSLATION_C= ACHE_TYPE_INVALID 0x00 -#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_TRANSLATION_C= ACHE_TYPE_DATA_TLB 0x01 -#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_TRANSLATION_C= ACHE_TYPE_INSTRUCTION_TLB 0x02 -#define CPUID_DETERMINISTIC_ADDRESS_TRANSLATION_PARAMETERS_TRANSLATION_C= ACHE_TYPE_UNIFIED_TLB 0x03 -/// -/// @} -/// - - -/** - CPUID V2 Extended Topology Enumeration Leaf - - @note - CPUID leaf 1FH is a preferred superset to leaf 0BH. Intel recommends fir= st checking - for the existence of Leaf 1FH and using this if available. - Most of Leaf 1FH output depends on the initial value in ECX. The EDX out= put of leaf - 1FH is always valid and does not vary with input value in ECX. Output va= lue in ECX[7:0] - always equals input value in ECX[7:0]. Sub-leaf index 0 enumerates SMT l= evel. Each - subsequent higher sub-leaf index enumerates a higher-level topological e= ntity in - hierarchical order. For sub-leaves that return an invalid level-type of = 0 in ECX[15:8]; - EAX and EBX will return 0. If an input value n in ECX returns the invali= d level-type of - 0 in ECX[15:8], other input values with ECX > n also return 0 in ECX[15:= 8]. - - Software should use this field (EAX[4:0]) to enumerate processor topolog= y of the system. - Software must not use EBX[15:0] to enumerate processor topology of the s= ystem. This value - in this field (EBX[15:0]) is only intended for display/diagnostic purpos= es. The actual - number of logical processors available to BIOS/OS/Applications may be di= fferent from the - value of EBX[15:0], depending on software and platform hardware configur= ations. - - @param EAX CPUID_V2_EXTENDED_TOPOLOGY (0x1F) - @param ECX Level number - -**/ -#define CPUID_V2_EXTENDED_TOPOLOGY 0x1F - -/// -/// @{ Define value for CPUID_EXTENDED_TOPOLOGY_ECX.LevelType -/// The value of the "level type" field is not related to level numbers in -/// any way, higher "level type" values do not mean higher levels. -/// -#define CPUID_V2_EXTENDED_TOPOLOGY_LEVEL_TYPE_MODULE 0x= 03 -#define CPUID_V2_EXTENDED_TOPOLOGY_LEVEL_TYPE_TILE 0x= 04 -#define CPUID_V2_EXTENDED_TOPOLOGY_LEVEL_TYPE_DIE 0x= 05 -/// -/// @} -/// - -/** - CPUID Extended Function - - @param EAX CPUID_EXTENDED_FUNCTION (0x80000000) - - @retval EAX Maximum Input Value for Extended Function CPUID Informatio= n. - @retval EBX Reserved. - @retval ECX Reserved. - @retval EDX Reserved. - - Example usage - @code - UINT32 Eax; - - AsmCpuid (CPUID_EXTENDED_FUNCTION, &Eax, NULL, NULL, NULL); - @endcode -**/ -#define CPUID_EXTENDED_FUNCTION 0x80000000 - - -/** - CPUID Extended Processor Signature and Feature Bits - - @param EAX CPUID_EXTENDED_CPU_SIG (0x80000001) - - @retval EAX CPUID_EXTENDED_CPU_SIG. - @retval EBX Reserved. - @retval ECX Extended Processor Signature and Feature Bits information - described by the type CPUID_EXTENDED_CPU_SIG_ECX. - @retval EDX Extended Processor Signature and Feature Bits information - described by the type CPUID_EXTENDED_CPU_SIG_EDX. - - Example usage - @code - UINT32 Eax; - CPUID_EXTENDED_CPU_SIG_ECX Ecx; - CPUID_EXTENDED_CPU_SIG_EDX Edx; - - AsmCpuid (CPUID_EXTENDED_CPU_SIG, &Eax, NULL, &Ecx.Uint32, &Edx.Uint32); - @endcode -**/ -#define CPUID_EXTENDED_CPU_SIG 0x80000001 - -/** - CPUID Extended Processor Signature and Feature Bits ECX for CPUID leaf - #CPUID_EXTENDED_CPU_SIG. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] LAHF/SAHF available in 64-bit mode. - /// - UINT32 LAHF_SAHF:1; - UINT32 Reserved1:4; - /// - /// [Bit 5] LZCNT. - /// - UINT32 LZCNT:1; - UINT32 Reserved2:2; - /// - /// [Bit 8] PREFETCHW. - /// - UINT32 PREFETCHW:1; - UINT32 Reserved3:23; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_CPU_SIG_ECX; - -/** - CPUID Extended Processor Signature and Feature Bits EDX for CPUID leaf - #CPUID_EXTENDED_CPU_SIG. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved1:11; - /// - /// [Bit 11] SYSCALL/SYSRET available in 64-bit mode. - /// - UINT32 SYSCALL_SYSRET:1; - UINT32 Reserved2:8; - /// - /// [Bit 20] Execute Disable Bit available. - /// - UINT32 NX:1; - UINT32 Reserved3:5; - /// - /// [Bit 26] 1-GByte pages are available if 1. - /// - UINT32 Page1GB:1; - /// - /// [Bit 27] RDTSCP and IA32_TSC_AUX are available if 1. - /// - UINT32 RDTSCP:1; - UINT32 Reserved4:1; - /// - /// [Bit 29] Intel(R) 64 Architecture available if 1. - /// - UINT32 LM:1; - UINT32 Reserved5:2; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_CPU_SIG_EDX; - - -/** - CPUID Processor Brand String - - @param EAX CPUID_BRAND_STRING1 (0x80000002) - - @retval EAX Processor Brand String in type CPUID_BRAND_STRING_DATA. - @retval EBX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - @retval ECX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - @retval EDX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - - Example usage - @code - CPUID_BRAND_STRING_DATA Eax; - CPUID_BRAND_STRING_DATA Ebx; - CPUID_BRAND_STRING_DATA Ecx; - CPUID_BRAND_STRING_DATA Edx; - - AsmCpuid (CPUID_BRAND_STRING1, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &E= dx.Uint32); - @endcode -**/ -#define CPUID_BRAND_STRING1 0x80000002 - -/** - CPUID Processor Brand String for CPUID leafs #CPUID_BRAND_STRING1, - #CPUID_BRAND_STRING2, and #CPUID_BRAND_STRING3. -**/ -typedef union { - /// - /// 4 ASCII characters of Processor Brand String - /// - CHAR8 BrandString[4]; - /// - /// All fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_BRAND_STRING_DATA; - -/** - CPUID Processor Brand String - - @param EAX CPUID_BRAND_STRING2 (0x80000003) - - @retval EAX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - @retval EBX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - @retval ECX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - @retval EDX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - - Example usage - @code - CPUID_BRAND_STRING_DATA Eax; - CPUID_BRAND_STRING_DATA Ebx; - CPUID_BRAND_STRING_DATA Ecx; - CPUID_BRAND_STRING_DATA Edx; - - AsmCpuid (CPUID_BRAND_STRING2, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &E= dx.Uint32); - @endcode -**/ -#define CPUID_BRAND_STRING2 0x80000003 - -/** - CPUID Processor Brand String - - @param EAX CPUID_BRAND_STRING3 (0x80000004) - - @retval EAX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - @retval EBX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - @retval ECX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - @retval EDX Processor Brand String Continued in type CPUID_BRAND_STRIN= G_DATA. - - Example usage - @code - CPUID_BRAND_STRING_DATA Eax; - CPUID_BRAND_STRING_DATA Ebx; - CPUID_BRAND_STRING_DATA Ecx; - CPUID_BRAND_STRING_DATA Edx; - - AsmCpuid (CPUID_BRAND_STRING3, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &E= dx.Uint32); - @endcode -**/ -#define CPUID_BRAND_STRING3 0x80000004 - - -/** - CPUID Extended Cache information - - @param EAX CPUID_EXTENDED_CACHE_INFO (0x80000006) - - @retval EAX Reserved. - @retval EBX Reserved. - @retval ECX Extended cache information described by the type - CPUID_EXTENDED_CACHE_INFO_ECX. - @retval EDX Reserved. - - Example usage - @code - CPUID_EXTENDED_CACHE_INFO_ECX Ecx; - - AsmCpuid (CPUID_EXTENDED_CACHE_INFO, NULL, NULL, &Ecx.Uint32, NULL); - @endcode -**/ -#define CPUID_EXTENDED_CACHE_INFO 0x80000006 - -/** - CPUID Extended Cache information ECX for CPUID leaf #CPUID_EXTENDED_CACH= E_INFO. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Cache line size in bytes. - /// - UINT32 CacheLineSize:8; - UINT32 Reserved:4; - /// - /// [Bits 15:12] L2 Associativity field. Supported values are in the = range - /// #CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_DISABLED to - /// #CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_FULL - /// - UINT32 L2Associativity:4; - /// - /// [Bits 31:16] Cache size in 1K units. - /// - UINT32 CacheSize:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_CACHE_INFO_ECX; - -/// -/// @{ Define value for bit field CPUID_EXTENDED_CACHE_INFO_ECX.L2Associat= ivity -/// -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_DISABLED 0x00 -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_DIRECT_MAPPED 0x01 -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_2_WAY 0x02 -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_4_WAY 0x04 -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_8_WAY 0x06 -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_16_WAY 0x08 -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_32_WAY 0x0A -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_48_WAY 0x0B -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_64_WAY 0x0C -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_96_WAY 0x0D -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_128_WAY 0x0E -#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_FULL 0x0F -/// -/// @} -/// - -/** - CPUID Extended Time Stamp Counter information - - @param EAX CPUID_EXTENDED_TIME_STAMP_COUNTER (0x80000007) - - @retval EAX Reserved. - @retval EBX Reserved. - @retval ECX Reserved. - @retval EDX Extended time stamp counter (TSC) information described by= the - type CPUID_EXTENDED_TIME_STAMP_COUNTER_EDX. - - Example usage - @code - CPUID_EXTENDED_TIME_STAMP_COUNTER_EDX Edx; - - AsmCpuid (CPUID_EXTENDED_TIME_STAMP_COUNTER, NULL, NULL, NULL, &Edx.Uint= 32); - @endcode -**/ -#define CPUID_EXTENDED_TIME_STAMP_COUNTER 0x80000007 - -/** - CPUID Extended Time Stamp Counter information EDX for CPUID leaf - #CPUID_EXTENDED_TIME_STAMP_COUNTER. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved1:8; - /// - /// [Bit 8] Invariant TSC available if 1. - /// - UINT32 InvariantTsc:1; - UINT32 Reserved2:23; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_EXTENDED_TIME_STAMP_COUNTER_EDX; - - -/** - CPUID Linear Physical Address Size - - @param EAX CPUID_VIR_PHY_ADDRESS_SIZE (0x80000008) - - @retval EAX Linear/Physical Address Size described by the type - CPUID_VIR_PHY_ADDRESS_SIZE_EAX. - @retval EBX Reserved. - @retval ECX Reserved. - @retval EDX Reserved. - - Example usage - @code - CPUID_VIR_PHY_ADDRESS_SIZE_EAX Eax; - - AsmCpuid (CPUID_VIR_PHY_ADDRESS_SIZE, &Eax.Uint32, NULL, NULL, NULL); - @endcode -**/ -#define CPUID_VIR_PHY_ADDRESS_SIZE 0x80000008 - -/** - CPUID Linear Physical Address Size EAX for CPUID leaf - #CPUID_VIR_PHY_ADDRESS_SIZE. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Number of physical address bits. - /// - /// @note - /// If CPUID.80000008H:EAX[7:0] is supported, the maximum physical add= ress - /// number supported should come from this field. - /// - UINT32 PhysicalAddressBits:8; - /// - /// [Bits 15:8] Number of linear address bits. - /// - UINT32 LinearAddressBits:8; - UINT32 Reserved:16; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; -} CPUID_VIR_PHY_ADDRESS_SIZE_EAX; +#include =20 #endif --=20 2.21.0.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#45140): https://edk2.groups.io/g/devel/message/45140 Mute This Topic: https://groups.io/mt/32796065/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- From nobody Sun Apr 28 22:42:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+45141+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45141+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1565245518; cv=none; d=zoho.com; s=zohoarc; b=JWaH94ZbwDkXDH1MSYXN0kKHDxeWnTrmYsy4zRN3fWnK/2fOygQ7NQrw3T3Uo1cVNgDP3paJNCpAbDmQOo/KTWnZG4Q1eqGfF3bH6HhePa3/BnrNDeHA8oPfQqLbSRjNWDD3BZHlD9cZn6ABAfxtAY2bmz5yM1hh2fMwwKx4Sh8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1565245518; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To:ARC-Authentication-Results; bh=TJ9AzLzKHvu8yp0qh1hYW7VE7NH5T9MSR1YULK/G+YM=; b=cyOXKRQ2iOu6YuN52BA+pQ3J9GY7sqRfk3WVqMlXeGah+rc33YWVVQeFBYANNNlU5L2ezd35FzlhlPZvIVcX4V9fmWrpZzlu+YUyPjw7D45D7td5JPXLADaI+vISM4wtJuZ2g0lPu2qy4j40yyJtpVrAV9Y9wIYv/BbMueVd2g0= ARC-Authentication-Results: i=1; mx.zoho.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45141+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1565245518641284.5717223644609; Wed, 7 Aug 2019 23:25:18 -0700 (PDT) Return-Path: X-Received: from mga14.intel.com (mga14.intel.com []) by groups.io with SMTP; Wed, 07 Aug 2019 23:25:17 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Aug 2019 23:25:17 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.64,360,1559545200"; d="scan'208";a="198923437" X-Received: from ydong10-win10.ccr.corp.intel.com ([10.239.158.133]) by fmsmga004.fm.intel.com with ESMTP; 07 Aug 2019 23:25:16 -0700 From: "Dong, Eric" To: devel@edk2.groups.io Cc: "Ni, Ray" , Laszlo Ersek , Hao A Wu Subject: [edk2-devel] [Patch v6 7/9] MdeModulePkg/DxeIpl: Create 5-level page table for long mode Date: Thu, 8 Aug 2019 14:24:58 +0800 Message-Id: <20190808062500.26996-8-eric.dong@intel.com> In-Reply-To: <20190808062500.26996-1-eric.dong@intel.com> References: <20190808062500.26996-1-eric.dong@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,eric.dong@intel.com Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1565245518; bh=gp/Wv53m9isyeuwHEK0/C9VUKl9SvP7zYlZGwrxaxdE=; h=Cc:Date:From:Reply-To:Subject:To; b=RF4p0Ohrr03BEqB4/9pIRSL6PpMjMQPUTQs3ZPL0MUXvQY55rJqBL2EAlS2VuIqrJmW zDnwExfbX+NrWvh0jX2rSMrLcD4k/yqEW3/5kAIv7/grLIDxnsYY6S1GI2G8qSwexPfv/ FKSqJ4W11HhMTQVIECAH4vEaJIo69ykAHOs= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: "Ni, Ray" REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D2008 DxeIpl is responsible to create page table for DXE phase running either in long mode or in 32bit mode with certain protection mechanism enabled (refer to ToBuildPageTable()). The patch updates DxeIpl to create 5-level page table for DXE phase running in long mode when PcdUse5LevelPageTable is TRUE and CPU supports 5-level page table. Signed-off-by: Ray Ni Reviewed-by: Eric Dong Regression-tested-by: Laszlo Ersek Reviewed-by: Hao A Wu --- MdeModulePkg/Core/DxeIplPeim/DxeIpl.inf | 1 + .../Core/DxeIplPeim/X64/VirtualMemory.c | 229 ++++++++++++------ 2 files changed, 153 insertions(+), 77 deletions(-) diff --git a/MdeModulePkg/Core/DxeIplPeim/DxeIpl.inf b/MdeModulePkg/Core/Dx= eIplPeim/DxeIpl.inf index abc3217b01..98bc17fc9d 100644 --- a/MdeModulePkg/Core/DxeIplPeim/DxeIpl.inf +++ b/MdeModulePkg/Core/DxeIplPeim/DxeIpl.inf @@ -110,6 +110,7 @@ gEfiMdeModulePkgTokenSpaceGuid.PcdNullPointerDetectionPropertyMask ##= CONSUMES gEfiMdeModulePkgTokenSpaceGuid.PcdHeapGuardPropertyMask ##= CONSUMES gEfiMdeModulePkgTokenSpaceGuid.PcdCpuStackGuard ##= CONSUMES + gEfiMdeModulePkgTokenSpaceGuid.PcdUse5LevelPageTable ##= SOMETIMES_CONSUMES =20 [Pcd.IA32,Pcd.X64,Pcd.ARM,Pcd.AARCH64] gEfiMdeModulePkgTokenSpaceGuid.PcdSetNxForStack ## SOMETIM= ES_CONSUMES diff --git a/MdeModulePkg/Core/DxeIplPeim/X64/VirtualMemory.c b/MdeModulePk= g/Core/DxeIplPeim/X64/VirtualMemory.c index edc38e4525..b40b7e0c98 100644 --- a/MdeModulePkg/Core/DxeIplPeim/X64/VirtualMemory.c +++ b/MdeModulePkg/Core/DxeIplPeim/X64/VirtualMemory.c @@ -15,13 +15,14 @@ 2) IA-32 Intel(R) Architecture Software Developer's Manual Volume 2:In= struction Set Reference, Intel 3) IA-32 Intel(R) Architecture Software Developer's Manual Volume 3:Sy= stem Programmer's Guide, Intel =20 -Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.
Copyright (c) 2017, AMD Incorporated. All rights reserved.
=20 SPDX-License-Identifier: BSD-2-Clause-Patent =20 **/ =20 +#include #include "DxeIpl.h" #include "VirtualMemory.h" =20 @@ -626,14 +627,18 @@ CreateIdentityMappingPageTables ( ) { UINT32 RegEax; + CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX EcxFlags; UINT32 RegEdx; UINT8 PhysicalAddressBits; EFI_PHYSICAL_ADDRESS PageAddress; + UINTN IndexOfPml5Entries; UINTN IndexOfPml4Entries; UINTN IndexOfPdpEntries; UINTN IndexOfPageDirectoryEntrie= s; + UINT32 NumberOfPml5EntriesNeeded; UINT32 NumberOfPml4EntriesNeeded; UINT32 NumberOfPdpEntriesNeeded; + PAGE_MAP_AND_DIRECTORY_POINTER *PageMapLevel5Entry; PAGE_MAP_AND_DIRECTORY_POINTER *PageMapLevel4Entry; PAGE_MAP_AND_DIRECTORY_POINTER *PageMap; PAGE_MAP_AND_DIRECTORY_POINTER *PageDirectoryPointerEntry; @@ -641,9 +646,11 @@ CreateIdentityMappingPageTables ( UINTN TotalPagesNum; UINTN BigPageAddress; VOID *Hob; + BOOLEAN Page5LevelSupport; BOOLEAN Page1GSupport; PAGE_TABLE_1G_ENTRY *PageDirectory1GEntry; UINT64 AddressEncMask; + IA32_CR4 Cr4; =20 // // Make sure AddressEncMask is contained to smallest supported address f= ield @@ -677,33 +684,68 @@ CreateIdentityMappingPageTables ( } } =20 + Page5LevelSupport =3D FALSE; + if (PcdGetBool (PcdUse5LevelPageTable)) { + AsmCpuidEx ( + CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS, CPUID_STRUCTURED_EXTENDED_F= EATURE_FLAGS_SUB_LEAF_INFO, NULL, + &EcxFlags.Uint32, NULL, NULL + ); + if (EcxFlags.Bits.FiveLevelPage !=3D 0) { + Page5LevelSupport =3D TRUE; + } + } + + DEBUG ((DEBUG_INFO, "AddressBits=3D%u 5LevelPaging=3D%u 1GPage=3D%u\n", = PhysicalAddressBits, Page5LevelSupport, Page1GSupport)); + // - // IA-32e paging translates 48-bit linear addresses to 52-bit physical a= ddresses. + // IA-32e paging translates 48-bit linear addresses to 52-bit physical a= ddresses + // when 5-Level Paging is disabled, + // due to either unsupported by HW, or disabled by PCD. // ASSERT (PhysicalAddressBits <=3D 52); - if (PhysicalAddressBits > 48) { + if (!Page5LevelSupport && PhysicalAddressBits > 48) { PhysicalAddressBits =3D 48; } =20 // // Calculate the table entries needed. // - if (PhysicalAddressBits <=3D 39 ) { - NumberOfPml4EntriesNeeded =3D 1; - NumberOfPdpEntriesNeeded =3D (UINT32)LShiftU64 (1, (PhysicalAddressBit= s - 30)); - } else { - NumberOfPml4EntriesNeeded =3D (UINT32)LShiftU64 (1, (PhysicalAddressBi= ts - 39)); - NumberOfPdpEntriesNeeded =3D 512; + NumberOfPml5EntriesNeeded =3D 1; + if (PhysicalAddressBits > 48) { + NumberOfPml5EntriesNeeded =3D (UINT32) LShiftU64 (1, PhysicalAddressBi= ts - 48); + PhysicalAddressBits =3D 48; + } + + NumberOfPml4EntriesNeeded =3D 1; + if (PhysicalAddressBits > 39) { + NumberOfPml4EntriesNeeded =3D (UINT32) LShiftU64 (1, PhysicalAddressBi= ts - 39); + PhysicalAddressBits =3D 39; } =20 + NumberOfPdpEntriesNeeded =3D 1; + ASSERT (PhysicalAddressBits > 30); + NumberOfPdpEntriesNeeded =3D (UINT32) LShiftU64 (1, PhysicalAddressBits = - 30); + // // Pre-allocate big pages to avoid later allocations. // if (!Page1GSupport) { - TotalPagesNum =3D (NumberOfPdpEntriesNeeded + 1) * NumberOfPml4Entries= Needed + 1; + TotalPagesNum =3D ((NumberOfPdpEntriesNeeded + 1) * NumberOfPml4Entrie= sNeeded + 1) * NumberOfPml5EntriesNeeded + 1; } else { - TotalPagesNum =3D NumberOfPml4EntriesNeeded + 1; + TotalPagesNum =3D (NumberOfPml4EntriesNeeded + 1) * NumberOfPml5Entrie= sNeeded + 1; + } + + // + // Substract the one page occupied by PML5 entries if 5-Level Paging is = disabled. + // + if (!Page5LevelSupport) { + TotalPagesNum--; } + + DEBUG ((DEBUG_INFO, "Pml5=3D%u Pml4=3D%u Pdp=3D%u TotalPage=3D%Lu\n", + NumberOfPml5EntriesNeeded, NumberOfPml4EntriesNeeded, + NumberOfPdpEntriesNeeded, (UINT64)TotalPagesNum)); + BigPageAddress =3D (UINTN) AllocatePageTableMemory (TotalPagesNum); ASSERT (BigPageAddress !=3D 0); =20 @@ -711,92 +753,125 @@ CreateIdentityMappingPageTables ( // By architecture only one PageMapLevel4 exists - so lets allocate stor= age for it. // PageMap =3D (VOID *) BigPageAddress; - BigPageAddress +=3D SIZE_4KB; - - PageMapLevel4Entry =3D PageMap; - PageAddress =3D 0; - for (IndexOfPml4Entries =3D 0; IndexOfPml4Entries < NumberOfPml4EntriesN= eeded; IndexOfPml4Entries++, PageMapLevel4Entry++) { + if (Page5LevelSupport) { // - // Each PML4 entry points to a page of Page Directory Pointer entires. - // So lets allocate space for them and fill them in in the IndexOfPdpE= ntries loop. + // By architecture only one PageMapLevel5 exists - so lets allocate st= orage for it. // - PageDirectoryPointerEntry =3D (VOID *) BigPageAddress; - BigPageAddress +=3D SIZE_4KB; + PageMapLevel5Entry =3D PageMap; + BigPageAddress +=3D SIZE_4KB; + } + PageAddress =3D 0; =20 + for ( IndexOfPml5Entries =3D 0 + ; IndexOfPml5Entries < NumberOfPml5EntriesNeeded + ; IndexOfPml5Entries++, PageMapLevel5Entry++) { // - // Make a PML4 Entry + // Each PML5 entry points to a page of PML4 entires. + // So lets allocate space for them and fill them in in the IndexOfPml4= Entries loop. + // When 5-Level Paging is disabled, below allocation happens only once. // - PageMapLevel4Entry->Uint64 =3D (UINT64)(UINTN)PageDirectoryPointerEntr= y | AddressEncMask; - PageMapLevel4Entry->Bits.ReadWrite =3D 1; - PageMapLevel4Entry->Bits.Present =3D 1; + PageMapLevel4Entry =3D (VOID *) BigPageAddress; + BigPageAddress +=3D SIZE_4KB; =20 - if (Page1GSupport) { - PageDirectory1GEntry =3D (VOID *) PageDirectoryPointerEntry; + if (Page5LevelSupport) { + // + // Make a PML5 Entry + // + PageMapLevel5Entry->Uint64 =3D (UINT64) (UINTN) PageMapLevel4Entry |= AddressEncMask; + PageMapLevel5Entry->Bits.ReadWrite =3D 1; + PageMapLevel5Entry->Bits.Present =3D 1; + } =20 - for (IndexOfPageDirectoryEntries =3D 0; IndexOfPageDirectoryEntries = < 512; IndexOfPageDirectoryEntries++, PageDirectory1GEntry++, PageAddress += =3D SIZE_1GB) { - if (ToSplitPageTable (PageAddress, SIZE_1GB, StackBase, StackSize)= ) { - Split1GPageTo2M (PageAddress, (UINT64 *) PageDirectory1GEntry, S= tackBase, StackSize); - } else { - // - // Fill in the Page Directory entries - // - PageDirectory1GEntry->Uint64 =3D (UINT64)PageAddress | AddressEn= cMask; - PageDirectory1GEntry->Bits.ReadWrite =3D 1; - PageDirectory1GEntry->Bits.Present =3D 1; - PageDirectory1GEntry->Bits.MustBe1 =3D 1; - } - } - } else { - for (IndexOfPdpEntries =3D 0; IndexOfPdpEntries < NumberOfPdpEntries= Needed; IndexOfPdpEntries++, PageDirectoryPointerEntry++) { - // - // Each Directory Pointer entries points to a page of Page Directo= ry entires. - // So allocate space for them and fill them in in the IndexOfPageD= irectoryEntries loop. - // - PageDirectoryEntry =3D (VOID *) BigPageAddress; - BigPageAddress +=3D SIZE_4KB; + for ( IndexOfPml4Entries =3D 0 + ; IndexOfPml4Entries < (NumberOfPml5EntriesNeeded =3D=3D 1 ? Numbe= rOfPml4EntriesNeeded : 512) + ; IndexOfPml4Entries++, PageMapLevel4Entry++) { + // + // Each PML4 entry points to a page of Page Directory Pointer entire= s. + // So lets allocate space for them and fill them in in the IndexOfPd= pEntries loop. + // + PageDirectoryPointerEntry =3D (VOID *) BigPageAddress; + BigPageAddress +=3D SIZE_4KB; =20 - // - // Fill in a Page Directory Pointer Entries - // - PageDirectoryPointerEntry->Uint64 =3D (UINT64)(UINTN)PageDirectory= Entry | AddressEncMask; - PageDirectoryPointerEntry->Bits.ReadWrite =3D 1; - PageDirectoryPointerEntry->Bits.Present =3D 1; + // + // Make a PML4 Entry + // + PageMapLevel4Entry->Uint64 =3D (UINT64)(UINTN)PageDirectoryPointerEn= try | AddressEncMask; + PageMapLevel4Entry->Bits.ReadWrite =3D 1; + PageMapLevel4Entry->Bits.Present =3D 1; =20 - for (IndexOfPageDirectoryEntries =3D 0; IndexOfPageDirectoryEntrie= s < 512; IndexOfPageDirectoryEntries++, PageDirectoryEntry++, PageAddress += =3D SIZE_2MB) { - if (ToSplitPageTable (PageAddress, SIZE_2MB, StackBase, StackSiz= e)) { - // - // Need to split this 2M page that covers NULL or stack range. - // - Split2MPageTo4K (PageAddress, (UINT64 *) PageDirectoryEntry, S= tackBase, StackSize); + if (Page1GSupport) { + PageDirectory1GEntry =3D (VOID *) PageDirectoryPointerEntry; + + for (IndexOfPageDirectoryEntries =3D 0; IndexOfPageDirectoryEntrie= s < 512; IndexOfPageDirectoryEntries++, PageDirectory1GEntry++, PageAddress= +=3D SIZE_1GB) { + if (ToSplitPageTable (PageAddress, SIZE_1GB, StackBase, StackSiz= e)) { + Split1GPageTo2M (PageAddress, (UINT64 *) PageDirectory1GEntry,= StackBase, StackSize); } else { // // Fill in the Page Directory entries // - PageDirectoryEntry->Uint64 =3D (UINT64)PageAddress | AddressEn= cMask; - PageDirectoryEntry->Bits.ReadWrite =3D 1; - PageDirectoryEntry->Bits.Present =3D 1; - PageDirectoryEntry->Bits.MustBe1 =3D 1; + PageDirectory1GEntry->Uint64 =3D (UINT64)PageAddress | Address= EncMask; + PageDirectory1GEntry->Bits.ReadWrite =3D 1; + PageDirectory1GEntry->Bits.Present =3D 1; + PageDirectory1GEntry->Bits.MustBe1 =3D 1; } } - } + } else { + for ( IndexOfPdpEntries =3D 0 + ; IndexOfPdpEntries < (NumberOfPml4EntriesNeeded =3D=3D 1 ? Nu= mberOfPdpEntriesNeeded : 512) + ; IndexOfPdpEntries++, PageDirectoryPointerEntry++) { + // + // Each Directory Pointer entries points to a page of Page Direc= tory entires. + // So allocate space for them and fill them in in the IndexOfPag= eDirectoryEntries loop. + // + PageDirectoryEntry =3D (VOID *) BigPageAddress; + BigPageAddress +=3D SIZE_4KB; =20 - for (; IndexOfPdpEntries < 512; IndexOfPdpEntries++, PageDirectoryPo= interEntry++) { - ZeroMem ( - PageDirectoryPointerEntry, - sizeof(PAGE_MAP_AND_DIRECTORY_POINTER) - ); + // + // Fill in a Page Directory Pointer Entries + // + PageDirectoryPointerEntry->Uint64 =3D (UINT64)(UINTN)PageDirecto= ryEntry | AddressEncMask; + PageDirectoryPointerEntry->Bits.ReadWrite =3D 1; + PageDirectoryPointerEntry->Bits.Present =3D 1; + + for (IndexOfPageDirectoryEntries =3D 0; IndexOfPageDirectoryEntr= ies < 512; IndexOfPageDirectoryEntries++, PageDirectoryEntry++, PageAddress= +=3D SIZE_2MB) { + if (ToSplitPageTable (PageAddress, SIZE_2MB, StackBase, StackS= ize)) { + // + // Need to split this 2M page that covers NULL or stack rang= e. + // + Split2MPageTo4K (PageAddress, (UINT64 *) PageDirectoryEntry,= StackBase, StackSize); + } else { + // + // Fill in the Page Directory entries + // + PageDirectoryEntry->Uint64 =3D (UINT64)PageAddress | Address= EncMask; + PageDirectoryEntry->Bits.ReadWrite =3D 1; + PageDirectoryEntry->Bits.Present =3D 1; + PageDirectoryEntry->Bits.MustBe1 =3D 1; + } + } + } + + // + // Fill with null entry for unused PDPTE + // + ZeroMem (PageDirectoryPointerEntry, (512 - IndexOfPdpEntries) * si= zeof(PAGE_MAP_AND_DIRECTORY_POINTER)); } } + + // + // For the PML4 entries we are not using fill in a null entry. + // + ZeroMem (PageMapLevel4Entry, (512 - IndexOfPml4Entries) * sizeof (PAGE= _MAP_AND_DIRECTORY_POINTER)); } =20 - // - // For the PML4 entries we are not using fill in a null entry. - // - for (; IndexOfPml4Entries < 512; IndexOfPml4Entries++, PageMapLevel4Entr= y++) { - ZeroMem ( - PageMapLevel4Entry, - sizeof (PAGE_MAP_AND_DIRECTORY_POINTER) - ); + if (Page5LevelSupport) { + Cr4.UintN =3D AsmReadCr4 (); + Cr4.Bits.LA57 =3D 1; + AsmWriteCr4 (Cr4.UintN); + // + // For the PML5 entries we are not using fill in a null entry. + // + ZeroMem (PageMapLevel5Entry, (512 - IndexOfPml5Entries) * sizeof (PAGE= _MAP_AND_DIRECTORY_POINTER)); } =20 // --=20 2.21.0.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#45141): https://edk2.groups.io/g/devel/message/45141 Mute This Topic: https://groups.io/mt/32796066/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- From nobody Sun Apr 28 22:42:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+45142+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45142+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1565245524; cv=none; d=zoho.com; s=zohoarc; b=d68HqfV2qeepYe10k5fvA0vpV/Vh97DmnIk0wPLeuI02sex+EpUNApO2W7DEpfNq2Q1cyL8+MMw+CHnwFZ8ttSWSoWPhOfj6yLeg1PUhAK8r4CxvIod8hnIMNF4pUWK9tcZw2Zv4QCum3ce1JsGsZPMiT5njIEY3c5lbMS+0lVE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1565245524; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To:ARC-Authentication-Results; bh=PK5TbT77VlNa8yLLsHbxNGedZBpiVkC4BmMgE4zoSj8=; b=P75rjLZhdyIOwev487AR+AmjIakHJeXa5vLLbTkl3W39UNRlVwvXacScp5u6aQ5iaNOtcdw+KAYS6+atDXySvBZxTjX/3iqHh9jb4PXvtX4nYRKa3egruKYCR2DRery9c/MTQK7AnOL39Tfv5y1XbAyvIzUFQetWPxs9+PJ+2DE= ARC-Authentication-Results: i=1; mx.zoho.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45142+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1565245524245159.66406321168233; Wed, 7 Aug 2019 23:25:24 -0700 (PDT) Return-Path: X-Received: from mga14.intel.com (mga14.intel.com []) by groups.io with SMTP; Wed, 07 Aug 2019 23:25:22 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Aug 2019 23:25:21 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.64,360,1559545200"; d="scan'208";a="198923459" X-Received: from ydong10-win10.ccr.corp.intel.com ([10.239.158.133]) by fmsmga004.fm.intel.com with ESMTP; 07 Aug 2019 23:25:17 -0700 From: "Dong, Eric" To: devel@edk2.groups.io Cc: "Ni, Ray" , Laszlo Ersek , Liming Gao Subject: [edk2-devel] [Patch v6 8/9] UefiCpuPkg|MdePkg: Move Register/ folder to MdePkg/Include/ Date: Thu, 8 Aug 2019 14:24:59 +0800 Message-Id: <20190808062500.26996-9-eric.dong@intel.com> In-Reply-To: <20190808062500.26996-1-eric.dong@intel.com> References: <20190808062500.26996-1-eric.dong@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,eric.dong@intel.com Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1565245523; bh=UyesuPpTDiqGpDfZO0h9YergAPz600cXS6lJ4IszS+M=; h=Cc:Date:From:Reply-To:Subject:To; b=RhziQdzECZPx8E85AxhpBQPx18nuKw+gtPsk1bYGNikz1ooaQDUdT8RRf/FCzL3mQ1+ qvU7QAq47VSLjaw7Vo+rKsqim7fn1Oa7HwRNMQcNYjb40p5295+7jwS9f1/spwDJ5gJMg O0JZ0qUrx4P1IN4lUjvu+tCwalEpDuAyK1g= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: "Ni, Ray" The patch moves all files under UefiCpuPkg/Include/Register/ to MdePkg/Include/Register using following detailed approaches: 1. Move UefiCpuPkg/Include/Register/Amd/ to MdePkg/Include/Register/Amd folder. 2. Move remaining in UefiCpuPkg/Include/Register/ to MdePkg/Include/Register/Intel folder. 3. Create wrapper header files under UefiCpuPkg/Include/Register/ to include the accordingly files in MdePkg/Include/Register/Intel. This is to avoid build break because code in other repos like edk2-platform includes the file from UefiCpuPkg. The wrapper header files will be removed after all consumers code is updated. Signed-off-by: Ray Ni Reviewed-by: Eric Dong Regression-tested-by: Laszlo Ersek Reviewed-by: Liming Gao --- .../Include/Register/Amd/Cpuid.h | 0 .../Include/Register/Amd/Fam17Msr.h | 0 .../Include/Register/Amd/Msr.h | 4 +- .../Include/Register/Intel/ArchitecturalMsr.h | 6572 +++++++++++++++++ MdePkg/Include/Register/Intel/LocalApic.h | 183 + MdePkg/Include/Register/Intel/Microcode.h | 194 + MdePkg/Include/Register/Intel/Msr.h | 44 + .../Include/Register/Intel}/Msr/AtomMsr.h | 4 +- .../Register/Intel}/Msr/BroadwellMsr.h | 4 +- .../Include/Register/Intel}/Msr/Core2Msr.h | 4 +- .../Include/Register/Intel}/Msr/CoreMsr.h | 4 +- .../Include/Register/Intel}/Msr/GoldmontMsr.h | 4 +- .../Register/Intel}/Msr/GoldmontPlusMsr.h | 4 +- .../Include/Register/Intel}/Msr/HaswellEMsr.h | 4 +- .../Include/Register/Intel}/Msr/HaswellMsr.h | 4 +- .../Register/Intel}/Msr/IvyBridgeMsr.h | 4 +- .../Include/Register/Intel}/Msr/NehalemMsr.h | 4 +- .../Include/Register/Intel}/Msr/P6Msr.h | 4 +- .../Include/Register/Intel}/Msr/Pentium4Msr.h | 4 +- .../Include/Register/Intel}/Msr/PentiumMMsr.h | 4 +- .../Include/Register/Intel}/Msr/PentiumMsr.h | 4 +- .../Register/Intel}/Msr/SandyBridgeMsr.h | 4 +- .../Register/Intel}/Msr/SilvermontMsr.h | 4 +- .../Include/Register/Intel}/Msr/SkylakeMsr.h | 4 +- .../Include/Register/Intel}/Msr/Xeon5600Msr.h | 4 +- .../Include/Register/Intel}/Msr/XeonDMsr.h | 4 +- .../Include/Register/Intel}/Msr/XeonE7Msr.h | 4 +- .../Include/Register/Intel}/Msr/XeonPhiMsr.h | 4 +- .../Register/Intel/SmramSaveStateMap.h | 184 + MdePkg/Include/Register/Intel/StmApi.h | 948 +++ .../Register/Intel}/StmResourceDescriptor.h | 6 +- .../Include/Register/Intel}/StmStatusCode.h | 6 +- .../Include/Register/ArchitecturalMsr.h | 6565 +--------------- UefiCpuPkg/Include/Register/Cpuid.h | 5 - UefiCpuPkg/Include/Register/LocalApic.h | 175 +- UefiCpuPkg/Include/Register/Microcode.h | 187 +- UefiCpuPkg/Include/Register/Msr.h | 36 +- .../Include/Register/SmramSaveStateMap.h | 179 +- UefiCpuPkg/Include/Register/StmApi.h | 941 +-- 39 files changed, 8194 insertions(+), 8119 deletions(-) rename {UefiCpuPkg =3D> MdePkg}/Include/Register/Amd/Cpuid.h (100%) rename {UefiCpuPkg =3D> MdePkg}/Include/Register/Amd/Fam17Msr.h (100%) rename {UefiCpuPkg =3D> MdePkg}/Include/Register/Amd/Msr.h (78%) create mode 100644 MdePkg/Include/Register/Intel/ArchitecturalMsr.h create mode 100644 MdePkg/Include/Register/Intel/LocalApic.h create mode 100644 MdePkg/Include/Register/Intel/Microcode.h create mode 100644 MdePkg/Include/Register/Intel/Msr.h rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/AtomMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/BroadwellMsr.h (95%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/Core2Msr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/CoreMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/GoldmontMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/GoldmontPlusMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/HaswellEMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/HaswellMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/IvyBridgeMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/NehalemMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/P6Msr.h (95%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/Pentium4Msr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/PentiumMMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/PentiumMsr.h (93%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/SandyBridgeMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/SilvermontMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/SkylakeMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/Xeon5600Msr.h (94%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/XeonDMsr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/XeonE7Msr.h (96%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/Ms= r/XeonPhiMsr.h (96%) create mode 100644 MdePkg/Include/Register/Intel/SmramSaveStateMap.h create mode 100644 MdePkg/Include/Register/Intel/StmApi.h rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/St= mResourceDescriptor.h (92%) rename {UefiCpuPkg/Include/Register =3D> MdePkg/Include/Register/Intel}/St= mStatusCode.h (94%) diff --git a/UefiCpuPkg/Include/Register/Amd/Cpuid.h b/MdePkg/Include/Regis= ter/Amd/Cpuid.h similarity index 100% rename from UefiCpuPkg/Include/Register/Amd/Cpuid.h rename to MdePkg/Include/Register/Amd/Cpuid.h diff --git a/UefiCpuPkg/Include/Register/Amd/Fam17Msr.h b/MdePkg/Include/Re= gister/Amd/Fam17Msr.h similarity index 100% rename from UefiCpuPkg/Include/Register/Amd/Fam17Msr.h rename to MdePkg/Include/Register/Amd/Fam17Msr.h diff --git a/UefiCpuPkg/Include/Register/Amd/Msr.h b/MdePkg/Include/Registe= r/Amd/Msr.h similarity index 78% rename from UefiCpuPkg/Include/Register/Amd/Msr.h rename to MdePkg/Include/Register/Amd/Msr.h index b7db0ae042..e74de7a1df 100644 --- a/UefiCpuPkg/Include/Register/Amd/Msr.h +++ b/MdePkg/Include/Register/Amd/Msr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2017, Advanced Micro Devices. All rights reserved.
+ Copyright (c) 2017 - 2019, Advanced Micro Devices. All rights reserved.<= BR> SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -17,7 +17,7 @@ #ifndef __AMD_MSR_H__ #define __AMD_MSR_H__ =20 -#include +#include #include =20 #endif diff --git a/MdePkg/Include/Register/Intel/ArchitecturalMsr.h b/MdePkg/Incl= ude/Register/Intel/ArchitecturalMsr.h new file mode 100644 index 0000000000..28e71cf713 --- /dev/null +++ b/MdePkg/Include/Register/Intel/ArchitecturalMsr.h @@ -0,0 +1,6572 @@ +/** @file + Intel Architectural MSR Definitions. + + Provides defines for Machine Specific Registers(MSR) indexes. Data struc= tures + are provided for MSRs that contain one or more bit fields. If the MSR v= alue + returned is a single 32-bit or 64-bit value, then a data structure is not + provided for that MSR. + + Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent + + @par Specification Reference: + Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume = 4, + May 2018, Volume 4: Model-Specific-Registers (MSR) + +**/ + +#ifndef __INTEL_ARCHITECTURAL_MSR_H__ +#define __INTEL_ARCHITECTURAL_MSR_H__ + +/** + See Section 2.22, "MSRs in Pentium Processors.". Pentium Processor (05_0= 1H). + + @param ECX MSR_IA32_P5_MC_ADDR (0x00000000) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_P5_MC_ADDR); + AsmWriteMsr64 (MSR_IA32_P5_MC_ADDR, Msr); + @endcode + @note MSR_IA32_P5_MC_ADDR is defined as IA32_P5_MC_ADDR in SDM. +**/ +#define MSR_IA32_P5_MC_ADDR 0x00000000 + + +/** + See Section 2.22, "MSRs in Pentium Processors.". DF_DM =3D 05_01H. + + @param ECX MSR_IA32_P5_MC_TYPE (0x00000001) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_P5_MC_TYPE); + AsmWriteMsr64 (MSR_IA32_P5_MC_TYPE, Msr); + @endcode + @note MSR_IA32_P5_MC_TYPE is defined as IA32_P5_MC_TYPE in SDM. +**/ +#define MSR_IA32_P5_MC_TYPE 0x00000001 + + +/** + See Section 8.10.5, "Monitor/Mwait Address Range Determination.". Introd= uced + at Display Family / Display Model 0F_03H. + + @param ECX MSR_IA32_MONITOR_FILTER_SIZE (0x00000006) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MONITOR_FILTER_SIZE); + AsmWriteMsr64 (MSR_IA32_MONITOR_FILTER_SIZE, Msr); + @endcode + @note MSR_IA32_MONITOR_FILTER_SIZE is defined as IA32_MONITOR_FILTER_SIZ= E in SDM. +**/ +#define MSR_IA32_MONITOR_FILTER_SIZE 0x00000006 + + +/** + See Section 17.17, "Time-Stamp Counter.". Introduced at Display Family / + Display Model 05_01H. + + @param ECX MSR_IA32_TIME_STAMP_COUNTER (0x00000010) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_TIME_STAMP_COUNTER); + AsmWriteMsr64 (MSR_IA32_TIME_STAMP_COUNTER, Msr); + @endcode + @note MSR_IA32_TIME_STAMP_COUNTER is defined as IA32_TIME_STAMP_COUNTER = in SDM. +**/ +#define MSR_IA32_TIME_STAMP_COUNTER 0x00000010 + + +/** + Platform ID (RO) The operating system can use this MSR to determine "sl= ot" + information for the processor and the proper microcode update to load. + Introduced at Display Family / Display Model 06_01H. + + @param ECX MSR_IA32_PLATFORM_ID (0x00000017) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PLATFORM_ID_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PLATFORM_ID_REGISTER. + + Example usage + @code + MSR_IA32_PLATFORM_ID_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PLATFORM_ID); + @endcode + @note MSR_IA32_PLATFORM_ID is defined as IA32_PLATFORM_ID in SDM. +**/ +#define MSR_IA32_PLATFORM_ID 0x00000017 + +/** + MSR information returned for MSR index #MSR_IA32_PLATFORM_ID +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved1:32; + UINT32 Reserved2:18; + /// + /// [Bits 52:50] Platform Id (RO) Contains information concerning the + /// intended platform for the processor. + /// 52 51 50 + /// -- -- -- + /// 0 0 0 Processor Flag 0. + /// 0 0 1 Processor Flag 1 + /// 0 1 0 Processor Flag 2 + /// 0 1 1 Processor Flag 3 + /// 1 0 0 Processor Flag 4 + /// 1 0 1 Processor Flag 5 + /// 1 1 0 Processor Flag 6 + /// 1 1 1 Processor Flag 7 + /// + UINT32 PlatformId:3; + UINT32 Reserved3:11; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PLATFORM_ID_REGISTER; + + +/** + 06_01H. + + @param ECX MSR_IA32_APIC_BASE (0x0000001B) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_APIC_BASE_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_APIC_BASE_REGISTER. + + Example usage + @code + MSR_IA32_APIC_BASE_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_APIC_BASE); + AsmWriteMsr64 (MSR_IA32_APIC_BASE, Msr.Uint64); + @endcode + @note MSR_IA32_APIC_BASE is defined as IA32_APIC_BASE in SDM. +**/ +#define MSR_IA32_APIC_BASE 0x0000001B + +/** + MSR information returned for MSR index #MSR_IA32_APIC_BASE +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved1:8; + /// + /// [Bit 8] BSP flag (R/W). + /// + UINT32 BSP:1; + UINT32 Reserved2:1; + /// + /// [Bit 10] Enable x2APIC mode. Introduced at Display Family / Display + /// Model 06_1AH. + /// + UINT32 EXTD:1; + /// + /// [Bit 11] APIC Global Enable (R/W). + /// + UINT32 EN:1; + /// + /// [Bits 31:12] APIC Base (R/W). + /// + UINT32 ApicBase:20; + /// + /// [Bits 63:32] APIC Base (R/W). + /// + UINT32 ApicBaseHi:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_APIC_BASE_REGISTER; + + +/** + Control Features in Intel 64 Processor (R/W). If any one enumeration + condition for defined bit field holds. + + @param ECX MSR_IA32_FEATURE_CONTROL (0x0000003A) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_FEATURE_CONTROL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_FEATURE_CONTROL_REGISTER. + + Example usage + @code + MSR_IA32_FEATURE_CONTROL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_FEATURE_CONTROL); + AsmWriteMsr64 (MSR_IA32_FEATURE_CONTROL, Msr.Uint64); + @endcode + @note MSR_IA32_FEATURE_CONTROL is defined as IA32_FEATURE_CONTROL in SDM. +**/ +#define MSR_IA32_FEATURE_CONTROL 0x0000003A + +/** + MSR information returned for MSR index #MSR_IA32_FEATURE_CONTROL +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Lock bit (R/WO): (1 =3D locked). When set, locks this MSR = from + /// being written, writes to this bit will result in GP(0). Note: Once= the + /// Lock bit is set, the contents of this register cannot be modified. + /// Therefore the lock bit must be set after configuring support for I= ntel + /// Virtualization Technology and prior to transferring control to an + /// option ROM or the OS. Hence, once the Lock bit is set, the entire + /// IA32_FEATURE_CONTROL contents are preserved across RESET when PWRG= OOD + /// is not deasserted. If any one enumeration condition for defined bit + /// field position greater than bit 0 holds. + /// + UINT32 Lock:1; + /// + /// [Bit 1] Enable VMX inside SMX operation (R/WL): This bit enables a + /// system executive to use VMX in conjunction with SMX to support + /// Intel(R) Trusted Execution Technology. BIOS must set this bit only + /// when the CPUID function 1 returns VMX feature flag and SMX feature + /// flag set (ECX bits 5 and 6 respectively). If CPUID.01H:ECX[5] =3D = 1 && + /// CPUID.01H:ECX[6] =3D 1. + /// + UINT32 EnableVmxInsideSmx:1; + /// + /// [Bit 2] Enable VMX outside SMX operation (R/WL): This bit enables = VMX + /// for system executive that do not require SMX. BIOS must set this b= it + /// only when the CPUID function 1 returns VMX feature flag set (ECX b= it + /// 5). If CPUID.01H:ECX[5] =3D 1. + /// + UINT32 EnableVmxOutsideSmx:1; + UINT32 Reserved1:5; + /// + /// [Bits 14:8] SENTER Local Function Enables (R/WL): When set, each b= it + /// in the field represents an enable control for a corresponding SENT= ER + /// function. This bit is supported only if CPUID.1:ECX.[bit 6] is set= . If + /// CPUID.01H:ECX[6] =3D 1. + /// + UINT32 SenterLocalFunctionEnables:7; + /// + /// [Bit 15] SENTER Global Enable (R/WL): This bit must be set to enab= le + /// SENTER leaf functions. This bit is supported only if CPUID.1:ECX.[= bit + /// 6] is set. If CPUID.01H:ECX[6] =3D 1. + /// + UINT32 SenterGlobalEnable:1; + UINT32 Reserved2:1; + /// + /// [Bit 17] SGX Launch Control Enable (R/WL): This bit must be set to + /// enable runtime reconfiguration of SGX Launch Control via + /// IA32_SGXLEPUBKEYHASHn MSR. If CPUID.(EAX=3D07H, ECX=3D0H): ECX[30]= =3D 1. + /// + UINT32 SgxLaunchControlEnable:1; + /// + /// [Bit 18] SGX Global Enable (R/WL): This bit must be set to enable = SGX + /// leaf functions. If CPUID.(EAX=3D07H, ECX=3D0H): EBX[2] =3D 1. + /// + UINT32 SgxEnable:1; + UINT32 Reserved3:1; + /// + /// [Bit 20] LMCE On (R/WL): When set, system software can program the + /// MSRs associated with LMCE to configure delivery of some machine ch= eck + /// exceptions to a single logical processor. If IA32_MCG_CAP[27] =3D = 1. + /// + UINT32 LmceOn:1; + UINT32 Reserved4:11; + UINT32 Reserved5:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_FEATURE_CONTROL_REGISTER; + + +/** + Per Logical Processor TSC Adjust (R/Write to clear). If CPUID.(EAX=3D07H, + ECX=3D0H): EBX[1] =3D 1. THREAD_ADJUST: Local offset value of the IA32_= TSC for + a logical processor. Reset value is Zero. A write to IA32_TSC will modify + the local offset in IA32_TSC_ADJUST and the content of IA32_TSC, but does + not affect the internal invariant TSC hardware. + + @param ECX MSR_IA32_TSC_ADJUST (0x0000003B) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_TSC_ADJUST); + AsmWriteMsr64 (MSR_IA32_TSC_ADJUST, Msr); + @endcode + @note MSR_IA32_TSC_ADJUST is defined as IA32_TSC_ADJUST in SDM. +**/ +#define MSR_IA32_TSC_ADJUST 0x0000003B + + +/** + BIOS Update Trigger (W) Executing a WRMSR instruction to this MSR causes= a + microcode update to be loaded into the processor. See Section 9.11.6, + "Microcode Update Loader." A processor may prevent writing to this MSR w= hen + loading guest states on VM entries or saving guest states on VM exits. + Introduced at Display Family / Display Model 06_01H. + + @param ECX MSR_IA32_BIOS_UPDT_TRIG (0x00000079) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D 0; + AsmWriteMsr64 (MSR_IA32_BIOS_UPDT_TRIG, Msr); + @endcode + @note MSR_IA32_BIOS_UPDT_TRIG is defined as IA32_BIOS_UPDT_TRIG in SDM. +**/ +#define MSR_IA32_BIOS_UPDT_TRIG 0x00000079 + + +/** + BIOS Update Signature (RO) Returns the microcode update signature follow= ing + the execution of CPUID.01H. A processor may prevent writing to this MSR = when + loading guest states on VM entries or saving guest states on VM exits. + Introduced at Display Family / Display Model 06_01H. + + @param ECX MSR_IA32_BIOS_SIGN_ID (0x0000008B) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_BIOS_SIGN_ID_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_BIOS_SIGN_ID_REGISTER. + + Example usage + @code + MSR_IA32_BIOS_SIGN_ID_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_BIOS_SIGN_ID); + @endcode + @note MSR_IA32_BIOS_SIGN_ID is defined as IA32_BIOS_SIGN_ID in SDM. +**/ +#define MSR_IA32_BIOS_SIGN_ID 0x0000008B + +/** + MSR information returned for MSR index #MSR_IA32_BIOS_SIGN_ID +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved:32; + /// + /// [Bits 63:32] Microcode update signature. This field contains the + /// signature of the currently loaded microcode update when read follo= wing + /// the execution of the CPUID instruction, function 1. It is required + /// that this register field be pre-loaded with zero prior to executing + /// the CPUID, function 1. If the field remains equal to zero, then th= ere + /// is no microcode update loaded. Another nonzero value will be the + /// signature. + /// + UINT32 MicrocodeUpdateSignature:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_BIOS_SIGN_ID_REGISTER; + + +/** + IA32_SGXLEPUBKEYHASH[(64*n+63):(64*n)] (R/W) Bits (64*n+63):(64*n) of the + SHA256 digest of the SIGSTRUCT.MODULUS for SGX Launch Enclave. On reset,= the + default value is the digest of Intel's signing key. Read permitted If + CPUID.(EAX=3D12H,ECX=3D0H):EAX[0]=3D1, Write permitted if CPUID.(EAX=3D1= 2H,ECX=3D0H): + EAX[0]=3D1 && IA32_FEATURE_CONTROL[17] =3D 1 && IA32_FEATURE_CONTROL[0] = =3D 1. + + @param ECX MSR_IA32_SGXLEPUBKEYHASHn + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_SGXLEPUBKEYHASHn); + AsmWriteMsr64 (MSR_IA32_SGXLEPUBKEYHASHn, Msr); + @endcode + @note MSR_IA32_SGXLEPUBKEYHASH0 is defined as IA32_SGXLEPUBKEYHASH0 in S= DM. + MSR_IA32_SGXLEPUBKEYHASH1 is defined as IA32_SGXLEPUBKEYHASH1 in S= DM. + MSR_IA32_SGXLEPUBKEYHASH2 is defined as IA32_SGXLEPUBKEYHASH2 in S= DM. + MSR_IA32_SGXLEPUBKEYHASH3 is defined as IA32_SGXLEPUBKEYHASH3 in S= DM. + @{ +**/ +#define MSR_IA32_SGXLEPUBKEYHASH0 0x0000008C +#define MSR_IA32_SGXLEPUBKEYHASH1 0x0000008D +#define MSR_IA32_SGXLEPUBKEYHASH2 0x0000008E +#define MSR_IA32_SGXLEPUBKEYHASH3 0x0000008F +/// @} + + +/** + SMM Monitor Configuration (R/W). If CPUID.01H: ECX[5]=3D1 or CPUID.01H: = ECX[6] =3D + 1. + + @param ECX MSR_IA32_SMM_MONITOR_CTL (0x0000009B) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_SMM_MONITOR_CTL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_SMM_MONITOR_CTL_REGISTER. + + Example usage + @code + MSR_IA32_SMM_MONITOR_CTL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_SMM_MONITOR_CTL); + AsmWriteMsr64 (MSR_IA32_SMM_MONITOR_CTL, Msr.Uint64); + @endcode + @note MSR_IA32_SMM_MONITOR_CTL is defined as IA32_SMM_MONITOR_CTL in SDM. +**/ +#define MSR_IA32_SMM_MONITOR_CTL 0x0000009B + +/** + MSR information returned for MSR index #MSR_IA32_SMM_MONITOR_CTL +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Valid (R/W). The STM may be invoked using VMCALL only if = this + /// bit is 1. Because VMCALL is used to activate the dual-monitor trea= tment + /// (see Section 34.15.6), the dual-monitor treatment cannot be activa= ted + /// if the bit is 0. This bit is cleared when the logical processor is + /// reset. + /// + UINT32 Valid:1; + UINT32 Reserved1:1; + /// + /// [Bit 2] Controls SMI unblocking by VMXOFF (see Section 34.14.4). If + /// IA32_VMX_MISC[28]. + /// + UINT32 BlockSmi:1; + UINT32 Reserved2:9; + /// + /// [Bits 31:12] MSEG Base (R/W). + /// + UINT32 MsegBase:20; + UINT32 Reserved3:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_SMM_MONITOR_CTL_REGISTER; + +/** + MSEG header that is located at the physical address specified by the Mse= gBase + field of #MSR_IA32_SMM_MONITOR_CTL_REGISTER. +**/ +typedef struct { + /// + /// Different processors may use different MSEG revision identifiers. Th= ese + /// identifiers enable software to avoid using an MSEG header formatted = for + /// one processor on a processor that uses a different format. Software = can + /// discover the MSEG revision identifier that a processor uses by readi= ng + /// the VMX capability MSR IA32_VMX_MISC. + // + UINT32 MsegHeaderRevision; + /// + /// Bits 31:1 of this field are reserved and must be zero. Bit 0 of the = field + /// is the IA-32e mode SMM feature bit. It indicates whether the logical + /// processor will be in IA-32e mode after the STM is activated. + /// + UINT32 MonitorFeatures; + UINT32 GdtrLimit; + UINT32 GdtrBaseOffset; + UINT32 CsSelector; + UINT32 EipOffset; + UINT32 EspOffset; + UINT32 Cr3Offset; + /// + /// Pad header so total size is 2KB + /// + UINT8 Reserved[SIZE_2KB - 8 * sizeof (UINT32)]; +} MSEG_HEADER; + +/// +/// @{ Define values for the MonitorFeatures field of #MSEG_HEADER +/// +#define STM_FEATURES_IA32E 0x1 +/// +/// @} +/// + +/** + Base address of the logical processor's SMRAM image (RO, SMM only). If + IA32_VMX_MISC[15]. + + @param ECX MSR_IA32_SMBASE (0x0000009E) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_SMBASE); + @endcode + @note MSR_IA32_SMBASE is defined as IA32_SMBASE in SDM. +**/ +#define MSR_IA32_SMBASE 0x0000009E + + +/** + General Performance Counters (R/W). + MSR_IA32_PMCn is supported if CPUID.0AH: EAX[15:8] > n. + + @param ECX MSR_IA32_PMCn + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_PMC0); + AsmWriteMsr64 (MSR_IA32_PMC0, Msr); + @endcode + @note MSR_IA32_PMC0 is defined as IA32_PMC0 in SDM. + MSR_IA32_PMC1 is defined as IA32_PMC1 in SDM. + MSR_IA32_PMC2 is defined as IA32_PMC2 in SDM. + MSR_IA32_PMC3 is defined as IA32_PMC3 in SDM. + MSR_IA32_PMC4 is defined as IA32_PMC4 in SDM. + MSR_IA32_PMC5 is defined as IA32_PMC5 in SDM. + MSR_IA32_PMC6 is defined as IA32_PMC6 in SDM. + MSR_IA32_PMC7 is defined as IA32_PMC7 in SDM. + @{ +**/ +#define MSR_IA32_PMC0 0x000000C1 +#define MSR_IA32_PMC1 0x000000C2 +#define MSR_IA32_PMC2 0x000000C3 +#define MSR_IA32_PMC3 0x000000C4 +#define MSR_IA32_PMC4 0x000000C5 +#define MSR_IA32_PMC5 0x000000C6 +#define MSR_IA32_PMC6 0x000000C7 +#define MSR_IA32_PMC7 0x000000C8 +/// @} + + +/** + TSC Frequency Clock Counter (R/Write to clear). If CPUID.06H: ECX[0] =3D= 1. + C0_MCNT: C0 TSC Frequency Clock Count Increments at fixed interval (rela= tive + to TSC freq.) when the logical processor is in C0. Cleared upon overflow= / + wrap-around of IA32_APERF. + + @param ECX MSR_IA32_MPERF (0x000000E7) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MPERF); + AsmWriteMsr64 (MSR_IA32_MPERF, Msr); + @endcode + @note MSR_IA32_MPERF is defined as IA32_MPERF in SDM. +**/ +#define MSR_IA32_MPERF 0x000000E7 + + +/** + Actual Performance Clock Counter (R/Write to clear). If CPUID.06H: ECX[0= ] =3D + 1. C0_ACNT: C0 Actual Frequency Clock Count Accumulates core clock count= s at + the coordinated clock frequency, when the logical processor is in C0. + Cleared upon overflow / wrap-around of IA32_MPERF. + + @param ECX MSR_IA32_APERF (0x000000E8) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_APERF); + AsmWriteMsr64 (MSR_IA32_APERF, Msr); + @endcode + @note MSR_IA32_APERF is defined as IA32_APERF in SDM. +**/ +#define MSR_IA32_APERF 0x000000E8 + + +/** + MTRR Capability (RO) Section 11.11.2.1, "IA32_MTRR_DEF_TYPE MSR.". + Introduced at Display Family / Display Model 06_01H. + + @param ECX MSR_IA32_MTRRCAP (0x000000FE) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_MTRRCAP_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_MTRRCAP_REGISTER. + + Example usage + @code + MSR_IA32_MTRRCAP_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MTRRCAP); + @endcode + @note MSR_IA32_MTRRCAP is defined as IA32_MTRRCAP in SDM. +**/ +#define MSR_IA32_MTRRCAP 0x000000FE + +/** + MSR information returned for MSR index #MSR_IA32_MTRRCAP +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] VCNT: The number of variable memory type ranges in the + /// processor. + /// + UINT32 VCNT:8; + /// + /// [Bit 8] Fixed range MTRRs are supported when set. + /// + UINT32 FIX:1; + UINT32 Reserved1:1; + /// + /// [Bit 10] WC Supported when set. + /// + UINT32 WC:1; + /// + /// [Bit 11] SMRR Supported when set. + /// + UINT32 SMRR:1; + UINT32 Reserved2:20; + UINT32 Reserved3:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_MTRRCAP_REGISTER; + + +/** + SYSENTER_CS_MSR (R/W). Introduced at Display Family / Display Model 06_0= 1H. + + @param ECX MSR_IA32_SYSENTER_CS (0x00000174) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_SYSENTER_CS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_SYSENTER_CS_REGISTER. + + Example usage + @code + MSR_IA32_SYSENTER_CS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_SYSENTER_CS); + AsmWriteMsr64 (MSR_IA32_SYSENTER_CS, Msr.Uint64); + @endcode + @note MSR_IA32_SYSENTER_CS is defined as IA32_SYSENTER_CS in SDM. +**/ +#define MSR_IA32_SYSENTER_CS 0x00000174 + +/** + MSR information returned for MSR index #MSR_IA32_SYSENTER_CS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] CS Selector. + /// + UINT32 CS:16; + UINT32 Reserved1:16; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_SYSENTER_CS_REGISTER; + + +/** + SYSENTER_ESP_MSR (R/W). Introduced at Display Family / Display Model 06_= 01H. + + @param ECX MSR_IA32_SYSENTER_ESP (0x00000175) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_SYSENTER_ESP); + AsmWriteMsr64 (MSR_IA32_SYSENTER_ESP, Msr); + @endcode + @note MSR_IA32_SYSENTER_ESP is defined as IA32_SYSENTER_ESP in SDM. +**/ +#define MSR_IA32_SYSENTER_ESP 0x00000175 + + +/** + SYSENTER_EIP_MSR (R/W). Introduced at Display Family / Display Model 06_= 01H. + + @param ECX MSR_IA32_SYSENTER_EIP (0x00000176) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_SYSENTER_EIP); + AsmWriteMsr64 (MSR_IA32_SYSENTER_EIP, Msr); + @endcode + @note MSR_IA32_SYSENTER_EIP is defined as IA32_SYSENTER_EIP in SDM. +**/ +#define MSR_IA32_SYSENTER_EIP 0x00000176 + + +/** + Global Machine Check Capability (RO). Introduced at Display Family / Dis= play + Model 06_01H. + + @param ECX MSR_IA32_MCG_CAP (0x00000179) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_MCG_CAP_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_MCG_CAP_REGISTER. + + Example usage + @code + MSR_IA32_MCG_CAP_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MCG_CAP); + @endcode + @note MSR_IA32_MCG_CAP is defined as IA32_MCG_CAP in SDM. +**/ +#define MSR_IA32_MCG_CAP 0x00000179 + +/** + MSR information returned for MSR index #MSR_IA32_MCG_CAP +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Count: Number of reporting banks. + /// + UINT32 Count:8; + /// + /// [Bit 8] MCG_CTL_P: IA32_MCG_CTL is present if this bit is set. + /// + UINT32 MCG_CTL_P:1; + /// + /// [Bit 9] MCG_EXT_P: Extended machine check state registers are pres= ent + /// if this bit is set. + /// + UINT32 MCG_EXT_P:1; + /// + /// [Bit 10] MCP_CMCI_P: Support for corrected MC error event is prese= nt. + /// Introduced at Display Family / Display Model 06_01H. + /// + UINT32 MCP_CMCI_P:1; + /// + /// [Bit 11] MCG_TES_P: Threshold-based error status register are pres= ent + /// if this bit is set. + /// + UINT32 MCG_TES_P:1; + UINT32 Reserved1:4; + /// + /// [Bits 23:16] MCG_EXT_CNT: Number of extended machine check state + /// registers present. + /// + UINT32 MCG_EXT_CNT:8; + /// + /// [Bit 24] MCG_SER_P: The processor supports software error recovery= if + /// this bit is set. + /// + UINT32 MCG_SER_P:1; + UINT32 Reserved2:1; + /// + /// [Bit 26] MCG_ELOG_P: Indicates that the processor allows platform + /// firmware to be invoked when an error is detected so that it may + /// provide additional platform specific information in an ACPI format + /// "Generic Error Data Entry" that augments the data included in mach= ine + /// check bank registers. Introduced at Display Family / Display Model + /// 06_3EH. + /// + UINT32 MCG_ELOG_P:1; + /// + /// [Bit 27] MCG_LMCE_P: Indicates that the processor support extended + /// state in IA32_MCG_STATUS and associated MSR necessary to configure + /// Local Machine Check Exception (LMCE). Introduced at Display Family= / + /// Display Model 06_3EH. + /// + UINT32 MCG_LMCE_P:1; + UINT32 Reserved3:4; + UINT32 Reserved4:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_MCG_CAP_REGISTER; + + +/** + Global Machine Check Status (R/W0). Introduced at Display Family / Displ= ay + Model 06_01H. + + @param ECX MSR_IA32_MCG_STATUS (0x0000017A) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_MCG_STATUS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_MCG_STATUS_REGISTER. + + Example usage + @code + MSR_IA32_MCG_STATUS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MCG_STATUS); + AsmWriteMsr64 (MSR_IA32_MCG_STATUS, Msr.Uint64); + @endcode + @note MSR_IA32_MCG_STATUS is defined as IA32_MCG_STATUS in SDM. +**/ +#define MSR_IA32_MCG_STATUS 0x0000017A + +/** + MSR information returned for MSR index #MSR_IA32_MCG_STATUS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] RIPV. Restart IP valid. Introduced at Display Family / Dis= play + /// Model 06_01H. + /// + UINT32 RIPV:1; + /// + /// [Bit 1] EIPV. Error IP valid. Introduced at Display Family / Displ= ay + /// Model 06_01H. + /// + UINT32 EIPV:1; + /// + /// [Bit 2] MCIP. Machine check in progress. Introduced at Display Fam= ily + /// / Display Model 06_01H. + /// + UINT32 MCIP:1; + /// + /// [Bit 3] LMCE_S. If IA32_MCG_CAP.LMCE_P[2 7] =3D1. + /// + UINT32 LMCE_S:1; + UINT32 Reserved1:28; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_MCG_STATUS_REGISTER; + + +/** + Global Machine Check Control (R/W). If IA32_MCG_CAP.CTL_P[8] =3D1. + + @param ECX MSR_IA32_MCG_CTL (0x0000017B) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MCG_CTL); + AsmWriteMsr64 (MSR_IA32_MCG_CTL, Msr); + @endcode + @note MSR_IA32_MCG_CTL is defined as IA32_MCG_CTL in SDM. +**/ +#define MSR_IA32_MCG_CTL 0x0000017B + + +/** + Performance Event Select Register n (R/W). If CPUID.0AH: EAX[15:8] > n. + + @param ECX MSR_IA32_PERFEVTSELn + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PERFEVTSEL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PERFEVTSEL_REGISTER. + + Example usage + @code + MSR_IA32_PERFEVTSEL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERFEVTSEL0); + AsmWriteMsr64 (MSR_IA32_PERFEVTSEL0, Msr.Uint64); + @endcode + @note MSR_IA32_PERFEVTSEL0 is defined as IA32_PERFEVTSEL0 in SDM. + MSR_IA32_PERFEVTSEL1 is defined as IA32_PERFEVTSEL1 in SDM. + MSR_IA32_PERFEVTSEL2 is defined as IA32_PERFEVTSEL2 in SDM. + MSR_IA32_PERFEVTSEL3 is defined as IA32_PERFEVTSEL3 in SDM. + @{ +**/ +#define MSR_IA32_PERFEVTSEL0 0x00000186 +#define MSR_IA32_PERFEVTSEL1 0x00000187 +#define MSR_IA32_PERFEVTSEL2 0x00000188 +#define MSR_IA32_PERFEVTSEL3 0x00000189 +/// @} + +/** + MSR information returned for MSR indexes #MSR_IA32_PERFEVTSEL0 to + #MSR_IA32_PERFEVTSEL3 +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Event Select: Selects a performance event logic unit. + /// + UINT32 EventSelect:8; + /// + /// [Bits 15:8] UMask: Qualifies the microarchitectural condition to + /// detect on the selected event logic. + /// + UINT32 UMASK:8; + /// + /// [Bit 16] USR: Counts while in privilege level is not ring 0. + /// + UINT32 USR:1; + /// + /// [Bit 17] OS: Counts while in privilege level is ring 0. + /// + UINT32 OS:1; + /// + /// [Bit 18] Edge: Enables edge detection if set. + /// + UINT32 E:1; + /// + /// [Bit 19] PC: enables pin control. + /// + UINT32 PC:1; + /// + /// [Bit 20] INT: enables interrupt on counter overflow. + /// + UINT32 INT:1; + /// + /// [Bit 21] AnyThread: When set to 1, it enables counting the associa= ted + /// event conditions occurring across all logical processors sharing a + /// processor core. When set to 0, the counter only increments the + /// associated event conditions occurring in the logical processor whi= ch + /// programmed the MSR. + /// + UINT32 ANY:1; + /// + /// [Bit 22] EN: enables the corresponding performance counter to comm= ence + /// counting when this bit is set. + /// + UINT32 EN:1; + /// + /// [Bit 23] INV: invert the CMASK. + /// + UINT32 INV:1; + /// + /// [Bits 31:24] CMASK: When CMASK is not zero, the corresponding + /// performance counter increments each cycle if the event count is + /// greater than or equal to the CMASK. + /// + UINT32 CMASK:8; + UINT32 Reserved:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PERFEVTSEL_REGISTER; + + +/** + Current performance state(P-State) operating point (RO). Introduced at + Display Family / Display Model 0F_03H. + + @param ECX MSR_IA32_PERF_STATUS (0x00000198) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PERF_STATUS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PERF_STATUS_REGISTER. + + Example usage + @code + MSR_IA32_PERF_STATUS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_STATUS); + @endcode + @note MSR_IA32_PERF_STATUS is defined as IA32_PERF_STATUS in SDM. +**/ +#define MSR_IA32_PERF_STATUS 0x00000198 + +/** + MSR information returned for MSR index #MSR_IA32_PERF_STATUS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Current performance State Value. + /// + UINT32 State:16; + UINT32 Reserved1:16; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PERF_STATUS_REGISTER; + + +/** + (R/W). Introduced at Display Family / Display Model 0F_03H. + + @param ECX MSR_IA32_PERF_CTL (0x00000199) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PERF_CTL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PERF_CTL_REGISTER. + + Example usage + @code + MSR_IA32_PERF_CTL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_CTL); + AsmWriteMsr64 (MSR_IA32_PERF_CTL, Msr.Uint64); + @endcode + @note MSR_IA32_PERF_CTL is defined as IA32_PERF_CTL in SDM. +**/ +#define MSR_IA32_PERF_CTL 0x00000199 + +/** + MSR information returned for MSR index #MSR_IA32_PERF_CTL +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 15:0] Target performance State Value. + /// + UINT32 TargetState:16; + UINT32 Reserved1:16; + /// + /// [Bit 32] IDA Engage. (R/W) When set to 1: disengages IDA. 06_0FH + /// (Mobile only). + /// + UINT32 IDA:1; + UINT32 Reserved2:31; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PERF_CTL_REGISTER; + + +/** + Clock Modulation Control (R/W) See Section 14.7.3, "Software Controlled + Clock Modulation.". If CPUID.01H:EDX[22] =3D 1. + + @param ECX MSR_IA32_CLOCK_MODULATION (0x0000019A) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_CLOCK_MODULATION_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_CLOCK_MODULATION_REGISTER. + + Example usage + @code + MSR_IA32_CLOCK_MODULATION_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_CLOCK_MODULATION); + AsmWriteMsr64 (MSR_IA32_CLOCK_MODULATION, Msr.Uint64); + @endcode + @note MSR_IA32_CLOCK_MODULATION is defined as IA32_CLOCK_MODULATION in S= DM. +**/ +#define MSR_IA32_CLOCK_MODULATION 0x0000019A + +/** + MSR information returned for MSR index #MSR_IA32_CLOCK_MODULATION +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Extended On-Demand Clock Modulation Duty Cycle:. If + /// CPUID.06H:EAX[5] =3D 1. + /// + UINT32 ExtendedOnDemandClockModulationDutyCycle:1; + /// + /// [Bits 3:1] On-Demand Clock Modulation Duty Cycle: Specific encoded + /// values for target duty cycle modulation. If CPUID.01H:EDX[22] =3D = 1. + /// + UINT32 OnDemandClockModulationDutyCycle:3; + /// + /// [Bit 4] On-Demand Clock Modulation Enable: Set 1 to enable modulat= ion. + /// If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 OnDemandClockModulationEnable:1; + UINT32 Reserved1:27; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_CLOCK_MODULATION_REGISTER; + + +/** + Thermal Interrupt Control (R/W) Enables and disables the generation of an + interrupt on temperature transitions detected with the processor's therm= al + sensors and thermal monitor. See Section 14.7.2, "Thermal Monitor.". + If CPUID.01H:EDX[22] =3D 1 + + @param ECX MSR_IA32_THERM_INTERRUPT (0x0000019B) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_THERM_INTERRUPT_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_THERM_INTERRUPT_REGISTER. + + Example usage + @code + MSR_IA32_THERM_INTERRUPT_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_THERM_INTERRUPT); + AsmWriteMsr64 (MSR_IA32_THERM_INTERRUPT, Msr.Uint64); + @endcode + @note MSR_IA32_THERM_INTERRUPT is defined as IA32_THERM_INTERRUPT in SDM. +**/ +#define MSR_IA32_THERM_INTERRUPT 0x0000019B + +/** + MSR information returned for MSR index #MSR_IA32_THERM_INTERRUPT +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] High-Temperature Interrupt Enable. If CPUID.01H:EDX[22] = =3D 1. + /// + UINT32 HighTempEnable:1; + /// + /// [Bit 1] Low-Temperature Interrupt Enable. If CPUID.01H:EDX[22] =3D= 1. + /// + UINT32 LowTempEnable:1; + /// + /// [Bit 2] PROCHOT# Interrupt Enable. If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 PROCHOT_Enable:1; + /// + /// [Bit 3] FORCEPR# Interrupt Enable. If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 FORCEPR_Enable:1; + /// + /// [Bit 4] Critical Temperature Interrupt Enable. + /// If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 CriticalTempEnable:1; + UINT32 Reserved1:3; + /// + /// [Bits 14:8] Threshold #1 Value. If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 Threshold1:7; + /// + /// [Bit 15] Threshold #1 Interrupt Enable. If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 Threshold1Enable:1; + /// + /// [Bits 22:16] Threshold #2 Value. If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 Threshold2:7; + /// + /// [Bit 23] Threshold #2 Interrupt Enable. If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 Threshold2Enable:1; + /// + /// [Bit 24] Power Limit Notification Enable. If CPUID.06H:EAX[4] =3D = 1. + /// + UINT32 PowerLimitNotificationEnable:1; + UINT32 Reserved2:7; + UINT32 Reserved3:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_THERM_INTERRUPT_REGISTER; + + +/** + Thermal Status Information (RO) Contains status information about the + processor's thermal sensor and automatic thermal monitoring facilities. = See + Section 14.7.2, "Thermal Monitor". If CPUID.01H:EDX[22] =3D 1. + + @param ECX MSR_IA32_THERM_STATUS (0x0000019C) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_THERM_STATUS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_THERM_STATUS_REGISTER. + + Example usage + @code + MSR_IA32_THERM_STATUS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_THERM_STATUS); + @endcode + @note MSR_IA32_THERM_STATUS is defined as IA32_THERM_STATUS in SDM. +**/ +#define MSR_IA32_THERM_STATUS 0x0000019C + +/** + MSR information returned for MSR index #MSR_IA32_THERM_STATUS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Thermal Status (RO):. If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 ThermalStatus:1; + /// + /// [Bit 1] Thermal Status Log (R/W):. If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 ThermalStatusLog:1; + /// + /// [Bit 2] PROCHOT # or FORCEPR# event (RO). If CPUID.01H:EDX[22] =3D= 1. + /// + UINT32 PROCHOT_FORCEPR_Event:1; + /// + /// [Bit 3] PROCHOT # or FORCEPR# log (R/WC0). If CPUID.01H:EDX[22] = =3D 1. + /// + UINT32 PROCHOT_FORCEPR_Log:1; + /// + /// [Bit 4] Critical Temperature Status (RO). If CPUID.01H:EDX[22] =3D= 1. + /// + UINT32 CriticalTempStatus:1; + /// + /// [Bit 5] Critical Temperature Status log (R/WC0). + /// If CPUID.01H:EDX[22] =3D 1. + /// + UINT32 CriticalTempStatusLog:1; + /// + /// [Bit 6] Thermal Threshold #1 Status (RO). If CPUID.01H:ECX[8] =3D = 1. + /// + UINT32 ThermalThreshold1Status:1; + /// + /// [Bit 7] Thermal Threshold #1 log (R/WC0). If CPUID.01H:ECX[8] =3D = 1. + /// + UINT32 ThermalThreshold1Log:1; + /// + /// [Bit 8] Thermal Threshold #2 Status (RO). If CPUID.01H:ECX[8] =3D = 1. + /// + UINT32 ThermalThreshold2Status:1; + /// + /// [Bit 9] Thermal Threshold #2 log (R/WC0). If CPUID.01H:ECX[8] =3D = 1. + /// + UINT32 ThermalThreshold2Log:1; + /// + /// [Bit 10] Power Limitation Status (RO). If CPUID.06H:EAX[4] =3D 1. + /// + UINT32 PowerLimitStatus:1; + /// + /// [Bit 11] Power Limitation log (R/WC0). If CPUID.06H:EAX[4] =3D 1. + /// + UINT32 PowerLimitLog:1; + /// + /// [Bit 12] Current Limit Status (RO). If CPUID.06H:EAX[7] =3D 1. + /// + UINT32 CurrentLimitStatus:1; + /// + /// [Bit 13] Current Limit log (R/WC0). If CPUID.06H:EAX[7] =3D 1. + /// + UINT32 CurrentLimitLog:1; + /// + /// [Bit 14] Cross Domain Limit Status (RO). If CPUID.06H:EAX[7] =3D 1. + /// + UINT32 CrossDomainLimitStatus:1; + /// + /// [Bit 15] Cross Domain Limit log (R/WC0). If CPUID.06H:EAX[7] =3D 1. + /// + UINT32 CrossDomainLimitLog:1; + /// + /// [Bits 22:16] Digital Readout (RO). If CPUID.06H:EAX[0] =3D 1. + /// + UINT32 DigitalReadout:7; + UINT32 Reserved1:4; + /// + /// [Bits 30:27] Resolution in Degrees Celsius (RO). If CPUID.06H:EAX[= 0] =3D + /// 1. + /// + UINT32 ResolutionInDegreesCelsius:4; + /// + /// [Bit 31] Reading Valid (RO). If CPUID.06H:EAX[0] =3D 1. + /// + UINT32 ReadingValid:1; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_THERM_STATUS_REGISTER; + + +/** + Enable Misc. Processor Features (R/W) Allows a variety of processor + functions to be enabled and disabled. + + @param ECX MSR_IA32_MISC_ENABLE (0x000001A0) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_MISC_ENABLE_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_MISC_ENABLE_REGISTER. + + Example usage + @code + MSR_IA32_MISC_ENABLE_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MISC_ENABLE); + AsmWriteMsr64 (MSR_IA32_MISC_ENABLE, Msr.Uint64); + @endcode + @note MSR_IA32_MISC_ENABLE is defined as IA32_MISC_ENABLE in SDM. +**/ +#define MSR_IA32_MISC_ENABLE 0x000001A0 + +/** + MSR information returned for MSR index #MSR_IA32_MISC_ENABLE +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Fast-Strings Enable When set, the fast-strings feature (for + /// REP MOVS and REP STORS) is enabled (default); when clear, fast-str= ings + /// are disabled. Introduced at Display Family / Display Model 0F_0H. + /// + UINT32 FastStrings:1; + UINT32 Reserved1:2; + /// + /// [Bit 3] Automatic Thermal Control Circuit Enable (R/W) 1 =3D Sett= ing + /// this bit enables the thermal control circuit (TCC) portion of the + /// Intel Thermal Monitor feature. This allows the processor to + /// automatically reduce power consumption in response to TCC activati= on. + /// 0 =3D Disabled. Note: In some products clearing this bit might be + /// ignored in critical thermal conditions, and TM1, TM2 and adaptive + /// thermal throttling will still be activated. The default value of t= his + /// field varies with product. See respective tables where default val= ue is + /// listed. Introduced at Display Family / Display Model 0F_0H. + /// + UINT32 AutomaticThermalControlCircuit:1; + UINT32 Reserved2:3; + /// + /// [Bit 7] Performance Monitoring Available (R) 1 =3D Performance + /// monitoring enabled 0 =3D Performance monitoring disabled. Introduc= ed at + /// Display Family / Display Model 0F_0H. + /// + UINT32 PerformanceMonitoring:1; + UINT32 Reserved3:3; + /// + /// [Bit 11] Branch Trace Storage Unavailable (RO) 1 =3D Processor doe= sn't + /// support branch trace storage (BTS) 0 =3D BTS is supported. Introdu= ced at + /// Display Family / Display Model 0F_0H. + /// + UINT32 BTS:1; + /// + /// [Bit 12] Processor Event Based Sampling (PEBS) Unavailable (RO) = 1 =3D + /// PEBS is not supported; 0 =3D PEBS is supported. Introduced at Disp= lay + /// Family / Display Model 06_0FH. + /// + UINT32 PEBS:1; + UINT32 Reserved4:3; + /// + /// [Bit 16] Enhanced Intel SpeedStep Technology Enable (R/W) 0=3D En= hanced + /// Intel SpeedStep Technology disabled 1 =3D Enhanced Intel SpeedStep + /// Technology enabled. If CPUID.01H: ECX[7] =3D1. + /// + UINT32 EIST:1; + UINT32 Reserved5:1; + /// + /// [Bit 18] ENABLE MONITOR FSM (R/W) When this bit is set to 0, the + /// MONITOR feature flag is not set (CPUID.01H:ECX[bit 3] =3D 0). This + /// indicates that MONITOR/MWAIT are not supported. Software attempts = to + /// execute MONITOR/MWAIT will cause #UD when this bit is 0. When this= bit + /// is set to 1 (default), MONITOR/MWAIT are supported (CPUID.01H:ECX[= bit + /// 3] =3D 1). If the SSE3 feature flag ECX[0] is not set (CPUID.01H:E= CX[bit + /// 0] =3D 0), the OS must not attempt to alter this bit. BIOS must le= ave it + /// in the default state. Writing this bit when the SSE3 feature flag = is + /// set to 0 may generate a #GP exception. Introduced at Display Famil= y / + /// Display Model 0F_03H. + /// + UINT32 MONITOR:1; + UINT32 Reserved6:3; + /// + /// [Bit 22] Limit CPUID Maxval (R/W) When this bit is set to 1, CPUID= .00H + /// returns a maximum value in EAX[7:0] of 2. BIOS should contain a se= tup + /// question that allows users to specify when the installed OS does n= ot + /// support CPUID functions greater than 2. Before setting this bit, B= IOS + /// must execute the CPUID.0H and examine the maximum value returned in + /// EAX[7:0]. If the maximum value is greater than 2, this bit is + /// supported. Otherwise, this bit is not supported. Setting this bit = when + /// the maximum value is not greater than 2 may generate a #GP excepti= on. + /// Setting this bit may cause unexpected behavior in software that + /// depends on the availability of CPUID leaves greater than 2. Introd= uced + /// at Display Family / Display Model 0F_03H. + /// + UINT32 LimitCpuidMaxval:1; + /// + /// [Bit 23] xTPR Message Disable (R/W) When set to 1, xTPR messages a= re + /// disabled. xTPR messages are optional messages that allow the proce= ssor + /// to inform the chipset of its priority. if CPUID.01H:ECX[14] =3D 1. + /// + UINT32 xTPR_Message_Disable:1; + UINT32 Reserved7:8; + UINT32 Reserved8:2; + /// + /// [Bit 34] XD Bit Disable (R/W) When set to 1, the Execute Disable B= it + /// feature (XD Bit) is disabled and the XD Bit extended feature flag = will + /// be clear (CPUID.80000001H: EDX[20]=3D0). When set to a 0 (default)= , the + /// Execute Disable Bit feature (if available) allows the OS to enable= PAE + /// paging and take advantage of data only pages. BIOS must not alter = the + /// contents of this bit location, if XD bit is not supported. Writing + /// this bit to 1 when the XD Bit extended feature flag is set to 0 may + /// generate a #GP exception. if CPUID.80000001H:EDX[2 0] =3D 1. + /// + UINT32 XD:1; + UINT32 Reserved9:29; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_MISC_ENABLE_REGISTER; + + +/** + Performance Energy Bias Hint (R/W). if CPUID.6H:ECX[3] =3D 1. + + @param ECX MSR_IA32_ENERGY_PERF_BIAS (0x000001B0) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_ENERGY_PERF_BIAS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_ENERGY_PERF_BIAS_REGISTER. + + Example usage + @code + MSR_IA32_ENERGY_PERF_BIAS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_ENERGY_PERF_BIAS); + AsmWriteMsr64 (MSR_IA32_ENERGY_PERF_BIAS, Msr.Uint64); + @endcode + @note MSR_IA32_ENERGY_PERF_BIAS is defined as IA32_ENERGY_PERF_BIAS in S= DM. +**/ +#define MSR_IA32_ENERGY_PERF_BIAS 0x000001B0 + +/** + MSR information returned for MSR index #MSR_IA32_ENERGY_PERF_BIAS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 3:0] Power Policy Preference: 0 indicates preference to high= est + /// performance. 15 indicates preference to maximize energy saving. + /// + UINT32 PowerPolicyPreference:4; + UINT32 Reserved1:28; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_ENERGY_PERF_BIAS_REGISTER; + + +/** + Package Thermal Status Information (RO) Contains status information about + the package's thermal sensor. See Section 14.8, "Package Level Thermal + Management.". If CPUID.06H: EAX[6] =3D 1. + + @param ECX MSR_IA32_PACKAGE_THERM_STATUS (0x000001B1) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PACKAGE_THERM_STATUS_REGISTE= R. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PACKAGE_THERM_STATUS_REGISTE= R. + + Example usage + @code + MSR_IA32_PACKAGE_THERM_STATUS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PACKAGE_THERM_STATUS); + @endcode + @note MSR_IA32_PACKAGE_THERM_STATUS is defined as IA32_PACKAGE_THERM_STA= TUS in SDM. +**/ +#define MSR_IA32_PACKAGE_THERM_STATUS 0x000001B1 + +/** + MSR information returned for MSR index #MSR_IA32_PACKAGE_THERM_STATUS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Pkg Thermal Status (RO):. + /// + UINT32 ThermalStatus:1; + /// + /// [Bit 1] Pkg Thermal Status Log (R/W):. + /// + UINT32 ThermalStatusLog:1; + /// + /// [Bit 2] Pkg PROCHOT # event (RO). + /// + UINT32 PROCHOT_Event:1; + /// + /// [Bit 3] Pkg PROCHOT # log (R/WC0). + /// + UINT32 PROCHOT_Log:1; + /// + /// [Bit 4] Pkg Critical Temperature Status (RO). + /// + UINT32 CriticalTempStatus:1; + /// + /// [Bit 5] Pkg Critical Temperature Status log (R/WC0). + /// + UINT32 CriticalTempStatusLog:1; + /// + /// [Bit 6] Pkg Thermal Threshold #1 Status (RO). + /// + UINT32 ThermalThreshold1Status:1; + /// + /// [Bit 7] Pkg Thermal Threshold #1 log (R/WC0). + /// + UINT32 ThermalThreshold1Log:1; + /// + /// [Bit 8] Pkg Thermal Threshold #2 Status (RO). + /// + UINT32 ThermalThreshold2Status:1; + /// + /// [Bit 9] Pkg Thermal Threshold #1 log (R/WC0). + /// + UINT32 ThermalThreshold2Log:1; + /// + /// [Bit 10] Pkg Power Limitation Status (RO). + /// + UINT32 PowerLimitStatus:1; + /// + /// [Bit 11] Pkg Power Limitation log (R/WC0). + /// + UINT32 PowerLimitLog:1; + UINT32 Reserved1:4; + /// + /// [Bits 22:16] Pkg Digital Readout (RO). + /// + UINT32 DigitalReadout:7; + UINT32 Reserved2:9; + UINT32 Reserved3:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PACKAGE_THERM_STATUS_REGISTER; + + +/** + Pkg Thermal Interrupt Control (R/W) Enables and disables the generation = of + an interrupt on temperature transitions detected with the package's ther= mal + sensor. See Section 14.8, "Package Level Thermal Management.". If CPUID.= 06H: + EAX[6] =3D 1. + + @param ECX MSR_IA32_PACKAGE_THERM_INTERRUPT (0x000001B2) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PACKAGE_THERM_INTERRUPT_REGI= STER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PACKAGE_THERM_INTERRUPT_REGI= STER. + + Example usage + @code + MSR_IA32_PACKAGE_THERM_INTERRUPT_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PACKAGE_THERM_INTERRUPT); + AsmWriteMsr64 (MSR_IA32_PACKAGE_THERM_INTERRUPT, Msr.Uint64); + @endcode + @note MSR_IA32_PACKAGE_THERM_INTERRUPT is defined as IA32_PACKAGE_THERM_= INTERRUPT in SDM. +**/ +#define MSR_IA32_PACKAGE_THERM_INTERRUPT 0x000001B2 + +/** + MSR information returned for MSR index #MSR_IA32_PACKAGE_THERM_INTERRUPT +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Pkg High-Temperature Interrupt Enable. + /// + UINT32 HighTempEnable:1; + /// + /// [Bit 1] Pkg Low-Temperature Interrupt Enable. + /// + UINT32 LowTempEnable:1; + /// + /// [Bit 2] Pkg PROCHOT# Interrupt Enable. + /// + UINT32 PROCHOT_Enable:1; + UINT32 Reserved1:1; + /// + /// [Bit 4] Pkg Overheat Interrupt Enable. + /// + UINT32 OverheatEnable:1; + UINT32 Reserved2:3; + /// + /// [Bits 14:8] Pkg Threshold #1 Value. + /// + UINT32 Threshold1:7; + /// + /// [Bit 15] Pkg Threshold #1 Interrupt Enable. + /// + UINT32 Threshold1Enable:1; + /// + /// [Bits 22:16] Pkg Threshold #2 Value. + /// + UINT32 Threshold2:7; + /// + /// [Bit 23] Pkg Threshold #2 Interrupt Enable. + /// + UINT32 Threshold2Enable:1; + /// + /// [Bit 24] Pkg Power Limit Notification Enable. + /// + UINT32 PowerLimitNotificationEnable:1; + UINT32 Reserved3:7; + UINT32 Reserved4:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PACKAGE_THERM_INTERRUPT_REGISTER; + + +/** + Trace/Profile Resource Control (R/W). Introduced at Display Family / Dis= play + Model 06_0EH. + + @param ECX MSR_IA32_DEBUGCTL (0x000001D9) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_DEBUGCTL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_DEBUGCTL_REGISTER. + + Example usage + @code + MSR_IA32_DEBUGCTL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_DEBUGCTL); + AsmWriteMsr64 (MSR_IA32_DEBUGCTL, Msr.Uint64); + @endcode + @note MSR_IA32_DEBUGCTL is defined as IA32_DEBUGCTL in SDM. +**/ +#define MSR_IA32_DEBUGCTL 0x000001D9 + +/** + MSR information returned for MSR index #MSR_IA32_DEBUGCTL +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] LBR: Setting this bit to 1 enables the processor to record= a + /// running trace of the most recent branches taken by the processor in + /// the LBR stack. Introduced at Display Family / Display Model 06_01H. + /// + UINT32 LBR:1; + /// + /// [Bit 1] BTF: Setting this bit to 1 enables the processor to treat + /// EFLAGS.TF as single-step on branches instead of single-step on + /// instructions. Introduced at Display Family / Display Model 06_01H. + /// + UINT32 BTF:1; + UINT32 Reserved1:4; + /// + /// [Bit 6] TR: Setting this bit to 1 enables branch trace messages to= be + /// sent. Introduced at Display Family / Display Model 06_0EH. + /// + UINT32 TR:1; + /// + /// [Bit 7] BTS: Setting this bit enables branch trace messages (BTMs)= to + /// be logged in a BTS buffer. Introduced at Display Family / Display + /// Model 06_0EH. + /// + UINT32 BTS:1; + /// + /// [Bit 8] BTINT: When clear, BTMs are logged in a BTS buffer in circ= ular + /// fashion. When this bit is set, an interrupt is generated by the BTS + /// facility when the BTS buffer is full. Introduced at Display Family= / + /// Display Model 06_0EH. + /// + UINT32 BTINT:1; + /// + /// [Bit 9] BTS_OFF_OS: When set, BTS or BTM is skipped if CPL =3D 0. + /// Introduced at Display Family / Display Model 06_0FH. + /// + UINT32 BTS_OFF_OS:1; + /// + /// [Bit 10] BTS_OFF_USR: When set, BTS or BTM is skipped if CPL > 0. + /// Introduced at Display Family / Display Model 06_0FH. + /// + UINT32 BTS_OFF_USR:1; + /// + /// [Bit 11] FREEZE_LBRS_ON_PMI: When set, the LBR stack is frozen on a + /// PMI request. If CPUID.01H: ECX[15] =3D 1 && CPUID.0AH: EAX[7:0] > = 1. + /// + UINT32 FREEZE_LBRS_ON_PMI:1; + /// + /// [Bit 12] FREEZE_PERFMON_ON_PMI: When set, each ENABLE bit of the + /// global counter control MSR are frozen (address 38FH) on a PMI requ= est. + /// If CPUID.01H: ECX[15] =3D 1 && CPUID.0AH: EAX[7:0] > 1. + /// + UINT32 FREEZE_PERFMON_ON_PMI:1; + /// + /// [Bit 13] ENABLE_UNCORE_PMI: When set, enables the logical processo= r to + /// receive and generate PMI on behalf of the uncore. Introduced at + /// Display Family / Display Model 06_1AH. + /// + UINT32 ENABLE_UNCORE_PMI:1; + /// + /// [Bit 14] FREEZE_WHILE_SMM: When set, freezes perfmon and trace + /// messages while in SMM. If IA32_PERF_CAPABILITIES[ 12] =3D 1. + /// + UINT32 FREEZE_WHILE_SMM:1; + /// + /// [Bit 15] RTM_DEBUG: When set, enables DR7 debug bit on XBEGIN. If + /// (CPUID.(EAX=3D07H, ECX=3D0):EBX[11] =3D 1). + /// + UINT32 RTM_DEBUG:1; + UINT32 Reserved2:16; + UINT32 Reserved3:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_DEBUGCTL_REGISTER; + + +/** + SMRR Base Address (Writeable only in SMM) Base address of SMM memory ra= nge. + If IA32_MTRRCAP.SMRR[11] =3D 1. + + @param ECX MSR_IA32_SMRR_PHYSBASE (0x000001F2) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_SMRR_PHYSBASE_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_SMRR_PHYSBASE_REGISTER. + + Example usage + @code + MSR_IA32_SMRR_PHYSBASE_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_SMRR_PHYSBASE); + AsmWriteMsr64 (MSR_IA32_SMRR_PHYSBASE, Msr.Uint64); + @endcode + @note MSR_IA32_SMRR_PHYSBASE is defined as IA32_SMRR_PHYSBASE in SDM. +**/ +#define MSR_IA32_SMRR_PHYSBASE 0x000001F2 + +/** + MSR information returned for MSR index #MSR_IA32_SMRR_PHYSBASE +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Type. Specifies memory type of the range. + /// + UINT32 Type:8; + UINT32 Reserved1:4; + /// + /// [Bits 31:12] PhysBase. SMRR physical Base Address. + /// + UINT32 PhysBase:20; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_SMRR_PHYSBASE_REGISTER; + + +/** + SMRR Range Mask (Writeable only in SMM) Range Mask of SMM memory range. = If + IA32_MTRRCAP[SMRR] =3D 1. + + @param ECX MSR_IA32_SMRR_PHYSMASK (0x000001F3) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_SMRR_PHYSMASK_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_SMRR_PHYSMASK_REGISTER. + + Example usage + @code + MSR_IA32_SMRR_PHYSMASK_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_SMRR_PHYSMASK); + AsmWriteMsr64 (MSR_IA32_SMRR_PHYSMASK, Msr.Uint64); + @endcode + @note MSR_IA32_SMRR_PHYSMASK is defined as IA32_SMRR_PHYSMASK in SDM. +**/ +#define MSR_IA32_SMRR_PHYSMASK 0x000001F3 + +/** + MSR information returned for MSR index #MSR_IA32_SMRR_PHYSMASK +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved1:11; + /// + /// [Bit 11] Valid Enable range mask. + /// + UINT32 Valid:1; + /// + /// [Bits 31:12] PhysMask SMRR address range mask. + /// + UINT32 PhysMask:20; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_SMRR_PHYSMASK_REGISTER; + + +/** + DCA Capability (R). If CPUID.01H: ECX[18] =3D 1. + + @param ECX MSR_IA32_PLATFORM_DCA_CAP (0x000001F8) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_PLATFORM_DCA_CAP); + @endcode + @note MSR_IA32_PLATFORM_DCA_CAP is defined as IA32_PLATFORM_DCA_CAP in S= DM. +**/ +#define MSR_IA32_PLATFORM_DCA_CAP 0x000001F8 + + +/** + If set, CPU supports Prefetch-Hint type. If CPUID.01H: ECX[18] =3D 1. + + @param ECX MSR_IA32_CPU_DCA_CAP (0x000001F9) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_CPU_DCA_CAP); + AsmWriteMsr64 (MSR_IA32_CPU_DCA_CAP, Msr); + @endcode + @note MSR_IA32_CPU_DCA_CAP is defined as IA32_CPU_DCA_CAP in SDM. +**/ +#define MSR_IA32_CPU_DCA_CAP 0x000001F9 + + +/** + DCA type 0 Status and Control register. If CPUID.01H: ECX[18] =3D 1. + + @param ECX MSR_IA32_DCA_0_CAP (0x000001FA) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_DCA_0_CAP_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_DCA_0_CAP_REGISTER. + + Example usage + @code + MSR_IA32_DCA_0_CAP_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_DCA_0_CAP); + AsmWriteMsr64 (MSR_IA32_DCA_0_CAP, Msr.Uint64); + @endcode + @note MSR_IA32_DCA_0_CAP is defined as IA32_DCA_0_CAP in SDM. +**/ +#define MSR_IA32_DCA_0_CAP 0x000001FA + +/** + MSR information returned for MSR index #MSR_IA32_DCA_0_CAP +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] DCA_ACTIVE: Set by HW when DCA is fuseenabled and no + /// defeatures are set. + /// + UINT32 DCA_ACTIVE:1; + /// + /// [Bits 2:1] TRANSACTION. + /// + UINT32 TRANSACTION:2; + /// + /// [Bits 6:3] DCA_TYPE. + /// + UINT32 DCA_TYPE:4; + /// + /// [Bits 10:7] DCA_QUEUE_SIZE. + /// + UINT32 DCA_QUEUE_SIZE:4; + UINT32 Reserved1:2; + /// + /// [Bits 16:13] DCA_DELAY: Writes will update the register but have n= o HW + /// side-effect. + /// + UINT32 DCA_DELAY:4; + UINT32 Reserved2:7; + /// + /// [Bit 24] SW_BLOCK: SW can request DCA block by setting this bit. + /// + UINT32 SW_BLOCK:1; + UINT32 Reserved3:1; + /// + /// [Bit 26] HW_BLOCK: Set when DCA is blocked by HW (e.g. CR0.CD =3D = 1). + /// + UINT32 HW_BLOCK:1; + UINT32 Reserved4:5; + UINT32 Reserved5:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_DCA_0_CAP_REGISTER; + + +/** + MTRRphysBasen. See Section 11.11.2.3, "Variable Range MTRRs". + If CPUID.01H: EDX.MTRR[12] =3D 1 and IA32_MTRRCAP[7:0] > n. + + @param ECX MSR_IA32_MTRR_PHYSBASEn + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_MTRR_PHYSBASE_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_MTRR_PHYSBASE_REGISTER. + + Example usage + @code + MSR_IA32_MTRR_PHYSBASE_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MTRR_PHYSBASE0); + AsmWriteMsr64 (MSR_IA32_MTRR_PHYSBASE0, Msr.Uint64); + @endcode + @note MSR_IA32_MTRR_PHYSBASE0 is defined as IA32_MTRR_PHYSBASE0 in SDM. + MSR_IA32_MTRR_PHYSBASE1 is defined as IA32_MTRR_PHYSBASE1 in SDM. + MSR_IA32_MTRR_PHYSBASE2 is defined as IA32_MTRR_PHYSBASE2 in SDM. + MSR_IA32_MTRR_PHYSBASE3 is defined as IA32_MTRR_PHYSBASE3 in SDM. + MSR_IA32_MTRR_PHYSBASE4 is defined as IA32_MTRR_PHYSBASE4 in SDM. + MSR_IA32_MTRR_PHYSBASE5 is defined as IA32_MTRR_PHYSBASE5 in SDM. + MSR_IA32_MTRR_PHYSBASE6 is defined as IA32_MTRR_PHYSBASE6 in SDM. + MSR_IA32_MTRR_PHYSBASE7 is defined as IA32_MTRR_PHYSBASE7 in SDM. + MSR_IA32_MTRR_PHYSBASE8 is defined as IA32_MTRR_PHYSBASE8 in SDM. + MSR_IA32_MTRR_PHYSBASE9 is defined as IA32_MTRR_PHYSBASE9 in SDM. + @{ +**/ +#define MSR_IA32_MTRR_PHYSBASE0 0x00000200 +#define MSR_IA32_MTRR_PHYSBASE1 0x00000202 +#define MSR_IA32_MTRR_PHYSBASE2 0x00000204 +#define MSR_IA32_MTRR_PHYSBASE3 0x00000206 +#define MSR_IA32_MTRR_PHYSBASE4 0x00000208 +#define MSR_IA32_MTRR_PHYSBASE5 0x0000020A +#define MSR_IA32_MTRR_PHYSBASE6 0x0000020C +#define MSR_IA32_MTRR_PHYSBASE7 0x0000020E +#define MSR_IA32_MTRR_PHYSBASE8 0x00000210 +#define MSR_IA32_MTRR_PHYSBASE9 0x00000212 +/// @} + +/** + MSR information returned for MSR indexes #MSR_IA32_MTRR_PHYSBASE0 to + #MSR_IA32_MTRR_PHYSBASE9 +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Type. Specifies memory type of the range. + /// + UINT32 Type:8; + UINT32 Reserved1:4; + /// + /// [Bits 31:12] PhysBase. MTRR physical Base Address. + /// + UINT32 PhysBase:20; + /// + /// [Bits MAXPHYSADDR:32] PhysBase. Upper bits of MTRR physical Base = Address. + /// MAXPHYADDR: The bit position indicated by MAXPHYADDR depends on the + /// maximum physical address range supported by the processor. It is + /// reported by CPUID leaf function 80000008H. If CPUID does not suppo= rt + /// leaf 80000008H, the processor supports 36-bit physical address siz= e, + /// then bit PhysMask consists of bits 35:12, and bits 63:36 are reser= ved. + /// + UINT32 PhysBaseHi:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_MTRR_PHYSBASE_REGISTER; + + +/** + MTRRphysMaskn. See Section 11.11.2.3, "Variable Range MTRRs". + If CPUID.01H: EDX.MTRR[12] =3D 1 and IA32_MTRRCAP[7:0] > n. + + @param ECX MSR_IA32_MTRR_PHYSMASKn + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_MTRR_PHYSMASK_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_MTRR_PHYSMASK_REGISTER. + + Example usage + @code + MSR_IA32_MTRR_PHYSMASK_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MTRR_PHYSMASK0); + AsmWriteMsr64 (MSR_IA32_MTRR_PHYSMASK0, Msr.Uint64); + @endcode + @note MSR_IA32_MTRR_PHYSMASK0 is defined as IA32_MTRR_PHYSMASK0 in SDM. + MSR_IA32_MTRR_PHYSMASK1 is defined as IA32_MTRR_PHYSMASK1 in SDM. + MSR_IA32_MTRR_PHYSMASK2 is defined as IA32_MTRR_PHYSMASK2 in SDM. + MSR_IA32_MTRR_PHYSMASK3 is defined as IA32_MTRR_PHYSMASK3 in SDM. + MSR_IA32_MTRR_PHYSMASK4 is defined as IA32_MTRR_PHYSMASK4 in SDM. + MSR_IA32_MTRR_PHYSMASK5 is defined as IA32_MTRR_PHYSMASK5 in SDM. + MSR_IA32_MTRR_PHYSMASK6 is defined as IA32_MTRR_PHYSMASK6 in SDM. + MSR_IA32_MTRR_PHYSMASK7 is defined as IA32_MTRR_PHYSMASK7 in SDM. + MSR_IA32_MTRR_PHYSMASK8 is defined as IA32_MTRR_PHYSMASK8 in SDM. + MSR_IA32_MTRR_PHYSMASK9 is defined as IA32_MTRR_PHYSMASK9 in SDM. + @{ +**/ +#define MSR_IA32_MTRR_PHYSMASK0 0x00000201 +#define MSR_IA32_MTRR_PHYSMASK1 0x00000203 +#define MSR_IA32_MTRR_PHYSMASK2 0x00000205 +#define MSR_IA32_MTRR_PHYSMASK3 0x00000207 +#define MSR_IA32_MTRR_PHYSMASK4 0x00000209 +#define MSR_IA32_MTRR_PHYSMASK5 0x0000020B +#define MSR_IA32_MTRR_PHYSMASK6 0x0000020D +#define MSR_IA32_MTRR_PHYSMASK7 0x0000020F +#define MSR_IA32_MTRR_PHYSMASK8 0x00000211 +#define MSR_IA32_MTRR_PHYSMASK9 0x00000213 +/// @} + +/** + MSR information returned for MSR indexes #MSR_IA32_MTRR_PHYSMASK0 to + #MSR_IA32_MTRR_PHYSMASK9 +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved1:11; + /// + /// [Bit 11] Valid Enable range mask. + /// + UINT32 V:1; + /// + /// [Bits 31:12] PhysMask. MTRR address range mask. + /// + UINT32 PhysMask:20; + /// + /// [Bits MAXPHYSADDR:32] PhysMask. Upper bits of MTRR address range = mask. + /// MAXPHYADDR: The bit position indicated by MAXPHYADDR depends on the + /// maximum physical address range supported by the processor. It is + /// reported by CPUID leaf function 80000008H. If CPUID does not suppo= rt + /// leaf 80000008H, the processor supports 36-bit physical address siz= e, + /// then bit PhysMask consists of bits 35:12, and bits 63:36 are reser= ved. + /// + UINT32 PhysMaskHi:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_MTRR_PHYSMASK_REGISTER; + + +/** + MTRRfix64K_00000. If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_FIX64K_00000 (0x00000250) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX64K_00000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX64K_00000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX64K_00000 is defined as IA32_MTRR_FIX64K_00000 in= SDM. +**/ +#define MSR_IA32_MTRR_FIX64K_00000 0x00000250 + + +/** + MTRRfix16K_80000. If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_FIX16K_80000 (0x00000258) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX16K_80000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX16K_80000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX16K_80000 is defined as IA32_MTRR_FIX16K_80000 in= SDM. +**/ +#define MSR_IA32_MTRR_FIX16K_80000 0x00000258 + + +/** + MTRRfix16K_A0000. If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_FIX16K_A0000 (0x00000259) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX16K_A0000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX16K_A0000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX16K_A0000 is defined as IA32_MTRR_FIX16K_A0000 in= SDM. +**/ +#define MSR_IA32_MTRR_FIX16K_A0000 0x00000259 + + +/** + See Section 11.11.2.2, "Fixed Range MTRRs.". If CPUID.01H: EDX.MTRR[12] = =3D1. + + @param ECX MSR_IA32_MTRR_FIX4K_C0000 (0x00000268) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_C0000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_C0000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX4K_C0000 is defined as IA32_MTRR_FIX4K_C0000 in S= DM. +**/ +#define MSR_IA32_MTRR_FIX4K_C0000 0x00000268 + + +/** + MTRRfix4K_C8000. If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_FIX4K_C8000 (0x00000269) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_C8000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_C8000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX4K_C8000 is defined as IA32_MTRR_FIX4K_C8000 in S= DM. +**/ +#define MSR_IA32_MTRR_FIX4K_C8000 0x00000269 + + +/** + MTRRfix4K_D0000. If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_FIX4K_D0000 (0x0000026A) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_D0000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_D0000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX4K_D0000 is defined as IA32_MTRR_FIX4K_D0000 in S= DM. +**/ +#define MSR_IA32_MTRR_FIX4K_D0000 0x0000026A + + +/** + MTRRfix4K_D8000. If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_FIX4K_D8000 (0x0000026B) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_D8000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_D8000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX4K_D8000 is defined as IA32_MTRR_FIX4K_D8000 in S= DM. +**/ +#define MSR_IA32_MTRR_FIX4K_D8000 0x0000026B + + +/** + MTRRfix4K_E0000. If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_FIX4K_E0000 (0x0000026C) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_E0000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_E0000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX4K_E0000 is defined as IA32_MTRR_FIX4K_E0000 in S= DM. +**/ +#define MSR_IA32_MTRR_FIX4K_E0000 0x0000026C + + +/** + MTRRfix4K_E8000. If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_FIX4K_E8000 (0x0000026D) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_E8000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_E8000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX4K_E8000 is defined as IA32_MTRR_FIX4K_E8000 in S= DM. +**/ +#define MSR_IA32_MTRR_FIX4K_E8000 0x0000026D + + +/** + MTRRfix4K_F0000. If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_FIX4K_F0000 (0x0000026E) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_F0000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_F0000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX4K_F0000 is defined as IA32_MTRR_FIX4K_F0000 in S= DM. +**/ +#define MSR_IA32_MTRR_FIX4K_F0000 0x0000026E + + +/** + MTRRfix4K_F8000. If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_FIX4K_F8000 (0x0000026F) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_F8000); + AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_F8000, Msr); + @endcode + @note MSR_IA32_MTRR_FIX4K_F8000 is defined as IA32_MTRR_FIX4K_F8000 in S= DM. +**/ +#define MSR_IA32_MTRR_FIX4K_F8000 0x0000026F + + +/** + IA32_PAT (R/W). If CPUID.01H: EDX.MTRR[16] =3D1. + + @param ECX MSR_IA32_PAT (0x00000277) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PAT_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PAT_REGISTER. + + Example usage + @code + MSR_IA32_PAT_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PAT); + AsmWriteMsr64 (MSR_IA32_PAT, Msr.Uint64); + @endcode + @note MSR_IA32_PAT is defined as IA32_PAT in SDM. +**/ +#define MSR_IA32_PAT 0x00000277 + +/** + MSR information returned for MSR index #MSR_IA32_PAT +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 2:0] PA0. + /// + UINT32 PA0:3; + UINT32 Reserved1:5; + /// + /// [Bits 10:8] PA1. + /// + UINT32 PA1:3; + UINT32 Reserved2:5; + /// + /// [Bits 18:16] PA2. + /// + UINT32 PA2:3; + UINT32 Reserved3:5; + /// + /// [Bits 26:24] PA3. + /// + UINT32 PA3:3; + UINT32 Reserved4:5; + /// + /// [Bits 34:32] PA4. + /// + UINT32 PA4:3; + UINT32 Reserved5:5; + /// + /// [Bits 42:40] PA5. + /// + UINT32 PA5:3; + UINT32 Reserved6:5; + /// + /// [Bits 50:48] PA6. + /// + UINT32 PA6:3; + UINT32 Reserved7:5; + /// + /// [Bits 58:56] PA7. + /// + UINT32 PA7:3; + UINT32 Reserved8:5; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PAT_REGISTER; + + +/** + Provides the programming interface to use corrected MC error signaling + capability (R/W). If IA32_MCG_CAP[10] =3D 1 && IA32_MCG_CAP[7:0] > n. + + @param ECX MSR_IA32_MCn_CTL2 + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_MC_CTL2_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_MC_CTL2_REGISTER. + + Example usage + @code + MSR_IA32_MC_CTL2_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MC0_CTL2); + AsmWriteMsr64 (MSR_IA32_MC0_CTL2, Msr.Uint64); + @endcode + @note MSR_IA32_MC0_CTL2 is defined as IA32_MC0_CTL2 in SDM. + MSR_IA32_MC1_CTL2 is defined as IA32_MC1_CTL2 in SDM. + MSR_IA32_MC2_CTL2 is defined as IA32_MC2_CTL2 in SDM. + MSR_IA32_MC3_CTL2 is defined as IA32_MC3_CTL2 in SDM. + MSR_IA32_MC4_CTL2 is defined as IA32_MC4_CTL2 in SDM. + MSR_IA32_MC5_CTL2 is defined as IA32_MC5_CTL2 in SDM. + MSR_IA32_MC6_CTL2 is defined as IA32_MC6_CTL2 in SDM. + MSR_IA32_MC7_CTL2 is defined as IA32_MC7_CTL2 in SDM. + MSR_IA32_MC8_CTL2 is defined as IA32_MC8_CTL2 in SDM. + MSR_IA32_MC9_CTL2 is defined as IA32_MC9_CTL2 in SDM. + MSR_IA32_MC10_CTL2 is defined as IA32_MC10_CTL2 in SDM. + MSR_IA32_MC11_CTL2 is defined as IA32_MC11_CTL2 in SDM. + MSR_IA32_MC12_CTL2 is defined as IA32_MC12_CTL2 in SDM. + MSR_IA32_MC13_CTL2 is defined as IA32_MC13_CTL2 in SDM. + MSR_IA32_MC14_CTL2 is defined as IA32_MC14_CTL2 in SDM. + MSR_IA32_MC15_CTL2 is defined as IA32_MC15_CTL2 in SDM. + MSR_IA32_MC16_CTL2 is defined as IA32_MC16_CTL2 in SDM. + MSR_IA32_MC17_CTL2 is defined as IA32_MC17_CTL2 in SDM. + MSR_IA32_MC18_CTL2 is defined as IA32_MC18_CTL2 in SDM. + MSR_IA32_MC19_CTL2 is defined as IA32_MC19_CTL2 in SDM. + MSR_IA32_MC20_CTL2 is defined as IA32_MC20_CTL2 in SDM. + MSR_IA32_MC21_CTL2 is defined as IA32_MC21_CTL2 in SDM. + MSR_IA32_MC22_CTL2 is defined as IA32_MC22_CTL2 in SDM. + MSR_IA32_MC23_CTL2 is defined as IA32_MC23_CTL2 in SDM. + MSR_IA32_MC24_CTL2 is defined as IA32_MC24_CTL2 in SDM. + MSR_IA32_MC25_CTL2 is defined as IA32_MC25_CTL2 in SDM. + MSR_IA32_MC26_CTL2 is defined as IA32_MC26_CTL2 in SDM. + MSR_IA32_MC27_CTL2 is defined as IA32_MC27_CTL2 in SDM. + MSR_IA32_MC28_CTL2 is defined as IA32_MC28_CTL2 in SDM. + MSR_IA32_MC29_CTL2 is defined as IA32_MC29_CTL2 in SDM. + MSR_IA32_MC30_CTL2 is defined as IA32_MC30_CTL2 in SDM. + MSR_IA32_MC31_CTL2 is defined as IA32_MC31_CTL2 in SDM. + @{ +**/ +#define MSR_IA32_MC0_CTL2 0x00000280 +#define MSR_IA32_MC1_CTL2 0x00000281 +#define MSR_IA32_MC2_CTL2 0x00000282 +#define MSR_IA32_MC3_CTL2 0x00000283 +#define MSR_IA32_MC4_CTL2 0x00000284 +#define MSR_IA32_MC5_CTL2 0x00000285 +#define MSR_IA32_MC6_CTL2 0x00000286 +#define MSR_IA32_MC7_CTL2 0x00000287 +#define MSR_IA32_MC8_CTL2 0x00000288 +#define MSR_IA32_MC9_CTL2 0x00000289 +#define MSR_IA32_MC10_CTL2 0x0000028A +#define MSR_IA32_MC11_CTL2 0x0000028B +#define MSR_IA32_MC12_CTL2 0x0000028C +#define MSR_IA32_MC13_CTL2 0x0000028D +#define MSR_IA32_MC14_CTL2 0x0000028E +#define MSR_IA32_MC15_CTL2 0x0000028F +#define MSR_IA32_MC16_CTL2 0x00000290 +#define MSR_IA32_MC17_CTL2 0x00000291 +#define MSR_IA32_MC18_CTL2 0x00000292 +#define MSR_IA32_MC19_CTL2 0x00000293 +#define MSR_IA32_MC20_CTL2 0x00000294 +#define MSR_IA32_MC21_CTL2 0x00000295 +#define MSR_IA32_MC22_CTL2 0x00000296 +#define MSR_IA32_MC23_CTL2 0x00000297 +#define MSR_IA32_MC24_CTL2 0x00000298 +#define MSR_IA32_MC25_CTL2 0x00000299 +#define MSR_IA32_MC26_CTL2 0x0000029A +#define MSR_IA32_MC27_CTL2 0x0000029B +#define MSR_IA32_MC28_CTL2 0x0000029C +#define MSR_IA32_MC29_CTL2 0x0000029D +#define MSR_IA32_MC30_CTL2 0x0000029E +#define MSR_IA32_MC31_CTL2 0x0000029F +/// @} + +/** + MSR information returned for MSR indexes #MSR_IA32_MC0_CTL2 + to #MSR_IA32_MC31_CTL2 +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 14:0] Corrected error count threshold. + /// + UINT32 CorrectedErrorCountThreshold:15; + UINT32 Reserved1:15; + /// + /// [Bit 30] CMCI_EN. + /// + UINT32 CMCI_EN:1; + UINT32 Reserved2:1; + UINT32 Reserved3:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_MC_CTL2_REGISTER; + + +/** + MTRRdefType (R/W). If CPUID.01H: EDX.MTRR[12] =3D1. + + @param ECX MSR_IA32_MTRR_DEF_TYPE (0x000002FF) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_MTRR_DEF_TYPE_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_MTRR_DEF_TYPE_REGISTER. + + Example usage + @code + MSR_IA32_MTRR_DEF_TYPE_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MTRR_DEF_TYPE); + AsmWriteMsr64 (MSR_IA32_MTRR_DEF_TYPE, Msr.Uint64); + @endcode + @note MSR_IA32_MTRR_DEF_TYPE is defined as IA32_MTRR_DEF_TYPE in SDM. +**/ +#define MSR_IA32_MTRR_DEF_TYPE 0x000002FF + +/** + MSR information returned for MSR index #MSR_IA32_MTRR_DEF_TYPE +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 2:0] Default Memory Type. + /// + UINT32 Type:3; + UINT32 Reserved1:7; + /// + /// [Bit 10] Fixed Range MTRR Enable. + /// + UINT32 FE:1; + /// + /// [Bit 11] MTRR Enable. + /// + UINT32 E:1; + UINT32 Reserved2:20; + UINT32 Reserved3:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_MTRR_DEF_TYPE_REGISTER; + + +/** + Fixed-Function Performance Counter 0 (R/W): Counts Instr_Retired.Any. If + CPUID.0AH: EDX[4:0] > 0. + + @param ECX MSR_IA32_FIXED_CTR0 (0x00000309) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_FIXED_CTR0); + AsmWriteMsr64 (MSR_IA32_FIXED_CTR0, Msr); + @endcode + @note MSR_IA32_FIXED_CTR0 is defined as IA32_FIXED_CTR0 in SDM. +**/ +#define MSR_IA32_FIXED_CTR0 0x00000309 + + +/** + Fixed-Function Performance Counter 1 (R/W): Counts CPU_CLK_Unhalted.Core= . If + CPUID.0AH: EDX[4:0] > 1. + + @param ECX MSR_IA32_FIXED_CTR1 (0x0000030A) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_FIXED_CTR1); + AsmWriteMsr64 (MSR_IA32_FIXED_CTR1, Msr); + @endcode + @note MSR_IA32_FIXED_CTR1 is defined as IA32_FIXED_CTR1 in SDM. +**/ +#define MSR_IA32_FIXED_CTR1 0x0000030A + + +/** + Fixed-Function Performance Counter 2 (R/W): Counts CPU_CLK_Unhalted.Ref.= If + CPUID.0AH: EDX[4:0] > 2. + + @param ECX MSR_IA32_FIXED_CTR2 (0x0000030B) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_FIXED_CTR2); + AsmWriteMsr64 (MSR_IA32_FIXED_CTR2, Msr); + @endcode + @note MSR_IA32_FIXED_CTR2 is defined as IA32_FIXED_CTR2 in SDM. +**/ +#define MSR_IA32_FIXED_CTR2 0x0000030B + + +/** + RO. If CPUID.01H: ECX[15] =3D 1. + + @param ECX MSR_IA32_PERF_CAPABILITIES (0x00000345) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PERF_CAPABILITIES_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PERF_CAPABILITIES_REGISTER. + + Example usage + @code + MSR_IA32_PERF_CAPABILITIES_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_CAPABILITIES); + AsmWriteMsr64 (MSR_IA32_PERF_CAPABILITIES, Msr.Uint64); + @endcode + @note MSR_IA32_PERF_CAPABILITIES is defined as IA32_PERF_CAPABILITIES in= SDM. +**/ +#define MSR_IA32_PERF_CAPABILITIES 0x00000345 + +/** + MSR information returned for MSR index #MSR_IA32_PERF_CAPABILITIES +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 5:0] LBR format. + /// + UINT32 LBR_FMT:6; + /// + /// [Bit 6] PEBS Trap. + /// + UINT32 PEBS_TRAP:1; + /// + /// [Bit 7] PEBSSaveArchRegs. + /// + UINT32 PEBS_ARCH_REG:1; + /// + /// [Bits 11:8] PEBS Record Format. + /// + UINT32 PEBS_REC_FMT:4; + /// + /// [Bit 12] 1: Freeze while SMM is supported. + /// + UINT32 SMM_FREEZE:1; + /// + /// [Bit 13] 1: Full width of counter writable via IA32_A_PMCx. + /// + UINT32 FW_WRITE:1; + UINT32 Reserved1:18; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PERF_CAPABILITIES_REGISTER; + + +/** + Fixed-Function Performance Counter Control (R/W) Counter increments while + the results of ANDing respective enable bit in IA32_PERF_GLOBAL_CTRL with + the corresponding OS or USR bits in this MSR is true. If CPUID.0AH: EAX[= 7:0] + > 1. + + @param ECX MSR_IA32_FIXED_CTR_CTRL (0x0000038D) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_FIXED_CTR_CTRL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_FIXED_CTR_CTRL_REGISTER. + + Example usage + @code + MSR_IA32_FIXED_CTR_CTRL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_FIXED_CTR_CTRL); + AsmWriteMsr64 (MSR_IA32_FIXED_CTR_CTRL, Msr.Uint64); + @endcode + @note MSR_IA32_FIXED_CTR_CTRL is defined as IA32_FIXED_CTR_CTRL in SDM. +**/ +#define MSR_IA32_FIXED_CTR_CTRL 0x0000038D + +/** + MSR information returned for MSR index #MSR_IA32_FIXED_CTR_CTRL +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] EN0_OS: Enable Fixed Counter 0 to count while CPL =3D 0. + /// + UINT32 EN0_OS:1; + /// + /// [Bit 1] EN0_Usr: Enable Fixed Counter 0 to count while CPL > 0. + /// + UINT32 EN0_Usr:1; + /// + /// [Bit 2] AnyThread: When set to 1, it enables counting the associat= ed + /// event conditions occurring across all logical processors sharing a + /// processor core. When set to 0, the counter only increments the + /// associated event conditions occurring in the logical processor whi= ch + /// programmed the MSR. If CPUID.0AH: EAX[7:0] > 2. + /// + UINT32 AnyThread0:1; + /// + /// [Bit 3] EN0_PMI: Enable PMI when fixed counter 0 overflows. + /// + UINT32 EN0_PMI:1; + /// + /// [Bit 4] EN1_OS: Enable Fixed Counter 1 to count while CPL =3D 0. + /// + UINT32 EN1_OS:1; + /// + /// [Bit 5] EN1_Usr: Enable Fixed Counter 1 to count while CPL > 0. + /// + UINT32 EN1_Usr:1; + /// + /// [Bit 6] AnyThread: When set to 1, it enables counting the associat= ed + /// event conditions occurring across all logical processors sharing a + /// processor core. When set to 0, the counter only increments the + /// associated event conditions occurring in the logical processor whi= ch + /// programmed the MSR. If CPUID.0AH: EAX[7:0] > 2. + /// + UINT32 AnyThread1:1; + /// + /// [Bit 7] EN1_PMI: Enable PMI when fixed counter 1 overflows. + /// + UINT32 EN1_PMI:1; + /// + /// [Bit 8] EN2_OS: Enable Fixed Counter 2 to count while CPL =3D 0. + /// + UINT32 EN2_OS:1; + /// + /// [Bit 9] EN2_Usr: Enable Fixed Counter 2 to count while CPL > 0. + /// + UINT32 EN2_Usr:1; + /// + /// [Bit 10] AnyThread: When set to 1, it enables counting the associa= ted + /// event conditions occurring across all logical processors sharing a + /// processor core. When set to 0, the counter only increments the + /// associated event conditions occurring in the logical processor whi= ch + /// programmed the MSR. If CPUID.0AH: EAX[7:0] > 2. + /// + UINT32 AnyThread2:1; + /// + /// [Bit 11] EN2_PMI: Enable PMI when fixed counter 2 overflows. + /// + UINT32 EN2_PMI:1; + UINT32 Reserved1:20; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_FIXED_CTR_CTRL_REGISTER; + + +/** + Global Performance Counter Status (RO). If CPUID.0AH: EAX[7:0] > 0. + + @param ECX MSR_IA32_PERF_GLOBAL_STATUS (0x0000038E) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_STATUS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_STATUS_REGISTER. + + Example usage + @code + MSR_IA32_PERF_GLOBAL_STATUS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_STATUS); + @endcode + @note MSR_IA32_PERF_GLOBAL_STATUS is defined as IA32_PERF_GLOBAL_STATUS = in SDM. +**/ +#define MSR_IA32_PERF_GLOBAL_STATUS 0x0000038E + +/** + MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_STATUS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Ovf_PMC0: Overflow status of IA32_PMC0. If CPUID.0AH: + /// EAX[15:8] > 0. + /// + UINT32 Ovf_PMC0:1; + /// + /// [Bit 1] Ovf_PMC1: Overflow status of IA32_PMC1. If CPUID.0AH: + /// EAX[15:8] > 1. + /// + UINT32 Ovf_PMC1:1; + /// + /// [Bit 2] Ovf_PMC2: Overflow status of IA32_PMC2. If CPUID.0AH: + /// EAX[15:8] > 2. + /// + UINT32 Ovf_PMC2:1; + /// + /// [Bit 3] Ovf_PMC3: Overflow status of IA32_PMC3. If CPUID.0AH: + /// EAX[15:8] > 3. + /// + UINT32 Ovf_PMC3:1; + UINT32 Reserved1:28; + /// + /// [Bit 32] Ovf_FixedCtr0: Overflow status of IA32_FIXED_CTR0. If + /// CPUID.0AH: EAX[7:0] > 1. + /// + UINT32 Ovf_FixedCtr0:1; + /// + /// [Bit 33] Ovf_FixedCtr1: Overflow status of IA32_FIXED_CTR1. If + /// CPUID.0AH: EAX[7:0] > 1. + /// + UINT32 Ovf_FixedCtr1:1; + /// + /// [Bit 34] Ovf_FixedCtr2: Overflow status of IA32_FIXED_CTR2. If + /// CPUID.0AH: EAX[7:0] > 1. + /// + UINT32 Ovf_FixedCtr2:1; + UINT32 Reserved2:20; + /// + /// [Bit 55] Trace_ToPA_PMI: A PMI occurred due to a ToPA entry memory + /// buffer was completely filled. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[2= 5] =3D 1) + /// && IA32_RTIT_CTL.ToPA =3D 1. + /// + UINT32 Trace_ToPA_PMI:1; + UINT32 Reserved3:2; + /// + /// [Bit 58] LBR_Frz: LBRs are frozen due to - + /// IA32_DEBUGCTL.FREEZE_LBR_ON_PMI=3D1, - The LBR stack overflowed. = If + /// CPUID.0AH: EAX[7:0] > 3. + /// + UINT32 LBR_Frz:1; + /// + /// [Bit 59] CTR_Frz: Performance counters in the core PMU are frozen = due + /// to - IA32_DEBUGCTL.FREEZE_PERFMON_ON_ PMI=3D1, - one or more cor= e PMU + /// counters overflowed. If CPUID.0AH: EAX[7:0] > 3. + /// + UINT32 CTR_Frz:1; + /// + /// [Bit 60] ASCI: Data in the performance counters in the core PMU may + /// include contributions from the direct or indirect operation intel = SGX + /// to protect an enclave. If CPUID.(EAX=3D07H, ECX=3D0):EBX[2] =3D 1. + /// + UINT32 ASCI:1; + /// + /// [Bit 61] Ovf_Uncore: Uncore counter overflow status. If CPUID.0AH: + /// EAX[7:0] > 2. + /// + UINT32 Ovf_Uncore:1; + /// + /// [Bit 62] OvfBuf: DS SAVE area Buffer overflow status. If CPUID.0AH: + /// EAX[7:0] > 0. + /// + UINT32 OvfBuf:1; + /// + /// [Bit 63] CondChgd: status bits of this register has changed. If + /// CPUID.0AH: EAX[7:0] > 0. + /// + UINT32 CondChgd:1; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PERF_GLOBAL_STATUS_REGISTER; + + +/** + Global Performance Counter Control (R/W) Counter increments while the re= sult + of ANDing respective enable bit in this MSR with the corresponding OS or= USR + bits in the general-purpose or fixed counter control MSR is true. If + CPUID.0AH: EAX[7:0] > 0. + + @param ECX MSR_IA32_PERF_GLOBAL_CTRL (0x0000038F) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_CTRL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_CTRL_REGISTER. + + Example usage + @code + MSR_IA32_PERF_GLOBAL_CTRL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_CTRL); + AsmWriteMsr64 (MSR_IA32_PERF_GLOBAL_CTRL, Msr.Uint64); + @endcode + @note MSR_IA32_PERF_GLOBAL_CTRL is defined as IA32_PERF_GLOBAL_CTRL in S= DM. +**/ +#define MSR_IA32_PERF_GLOBAL_CTRL 0x0000038F + +/** + MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_CTRL +**/ +typedef union { + /// + /// Individual bit fields +/// + struct { + /// + /// [Bits 31:0] EN_PMCn. If CPUID.0AH: EAX[15:8] > n. + /// Enable bitmask. Only the first n-1 bits are valid. + /// Bits n..31 are reserved. + /// + UINT32 EN_PMCn:32; + /// + /// [Bits 63:32] EN_FIXED_CTRn. If CPUID.0AH: EDX[4:0] > n. + /// Enable bitmask. Only the first n-1 bits are valid. + /// Bits 31:n are reserved. + /// + UINT32 EN_FIXED_CTRn:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PERF_GLOBAL_CTRL_REGISTER; + + +/** + Global Performance Counter Overflow Control (R/W). If CPUID.0AH: EAX[7:0= ] > + 0 && CPUID.0AH: EAX[7:0] <=3D 3. + + @param ECX MSR_IA32_PERF_GLOBAL_OVF_CTRL (0x00000390) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_OVF_CTRL_REGISTE= R. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_OVF_CTRL_REGISTE= R. + + Example usage + @code + MSR_IA32_PERF_GLOBAL_OVF_CTRL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_OVF_CTRL); + AsmWriteMsr64 (MSR_IA32_PERF_GLOBAL_OVF_CTRL, Msr.Uint64); + @endcode + @note MSR_IA32_PERF_GLOBAL_OVF_CTRL is defined as IA32_PERF_GLOBAL_OVF_C= TRL in SDM. +**/ +#define MSR_IA32_PERF_GLOBAL_OVF_CTRL 0x00000390 + +/** + MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_OVF_CTRL +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 31:0] Set 1 to Clear Ovf_PMC0 bit. If CPUID.0AH: EAX[15:8] >= n. + /// Clear bitmask. Only the first n-1 bits are valid. + /// Bits 31:n are reserved. + /// + UINT32 Ovf_PMCn:32; + /// + /// [Bits 54:32] Set 1 to Clear Ovf_FIXED_CTR0 bit. + /// If CPUID.0AH: EDX[4:0] > n. + /// Clear bitmask. Only the first n-1 bits are valid. + /// Bits 22:n are reserved. + /// + UINT32 Ovf_FIXED_CTRn:23; + /// + /// [Bit 55] Set 1 to Clear Trace_ToPA_PMI bit. If (CPUID.(EAX=3D07H, + /// ECX=3D0):EBX[25] =3D 1) && IA32_RTIT_CTL.ToPA =3D 1. + /// + UINT32 Trace_ToPA_PMI:1; + UINT32 Reserved2:5; + /// + /// [Bit 61] Set 1 to Clear Ovf_Uncore bit. Introduced at Display Fami= ly / + /// Display Model 06_2EH. + /// + UINT32 Ovf_Uncore:1; + /// + /// [Bit 62] Set 1 to Clear OvfBuf: bit. If CPUID.0AH: EAX[7:0] > 0. + /// + UINT32 OvfBuf:1; + /// + /// [Bit 63] Set to 1to clear CondChgd: bit. If CPUID.0AH: EAX[7:0] > = 0. + /// + UINT32 CondChgd:1; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PERF_GLOBAL_OVF_CTRL_REGISTER; + + +/** + Global Performance Counter Overflow Reset Control (R/W). If CPUID.0AH: + EAX[7:0] > 3. + + @param ECX MSR_IA32_PERF_GLOBAL_STATUS_RESET (0x00000390) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_STATUS_RESET_REG= ISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_STATUS_RESET_REG= ISTER. + + Example usage + @code + MSR_IA32_PERF_GLOBAL_STATUS_RESET_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_STATUS_RESET); + AsmWriteMsr64 (MSR_IA32_PERF_GLOBAL_STATUS_RESET, Msr.Uint64); + @endcode + @note MSR_IA32_PERF_GLOBAL_STATUS_RESET is defined as IA32_PERF_GLOBAL_S= TATUS_RESET in SDM. +**/ +#define MSR_IA32_PERF_GLOBAL_STATUS_RESET 0x00000390 + +/** + MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_STATUS_RESET +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 31:0] Set 1 to Clear Ovf_PMC0 bit. If CPUID.0AH: EAX[15:8] >= n. + /// Clear bitmask. Only the first n-1 bits are valid. + /// Bits 31:n are reserved. + /// + UINT32 Ovf_PMCn:32; + /// + /// [Bits 54:32] Set 1 to Clear Ovf_FIXED_CTR0 bit. + /// If CPUID.0AH: EDX[4:0] > n. + /// Clear bitmask. Only the first n-1 bits are valid. + /// Bits 22:n are reserved. + /// + UINT32 Ovf_FIXED_CTRn:23; + /// + /// [Bit 55] Set 1 to Clear Trace_ToPA_PMI bit. If (CPUID.(EAX=3D07H, + /// ECX=3D0):EBX[25] =3D 1) && IA32_RTIT_CTL.ToPA[8] =3D 1. + /// + UINT32 Trace_ToPA_PMI:1; + UINT32 Reserved2:2; + /// + /// [Bit 58] Set 1 to Clear LBR_Frz bit. If CPUID.0AH: EAX[7:0] > 3. + /// + UINT32 LBR_Frz:1; + /// + /// [Bit 59] Set 1 to Clear CTR_Frz bit. If CPUID.0AH: EAX[7:0] > 3. + /// + UINT32 CTR_Frz:1; + /// + /// [Bit 60] Set 1 to Clear ASCI bit. If CPUID.0AH: EAX[7:0] > 3. + /// + UINT32 ASCI:1; + /// + /// [Bit 61] Set 1 to Clear Ovf_Uncore bit. Introduced at Display Fami= ly / + /// Display Model 06_2EH. + /// + UINT32 Ovf_Uncore:1; + /// + /// [Bit 62] Set 1 to Clear OvfBuf: bit. If CPUID.0AH: EAX[7:0] > 0. + /// + UINT32 OvfBuf:1; + /// + /// [Bit 63] Set to 1to clear CondChgd: bit. If CPUID.0AH: EAX[7:0] > = 0. + /// + UINT32 CondChgd:1; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PERF_GLOBAL_STATUS_RESET_REGISTER; + + +/** + Global Performance Counter Overflow Set Control (R/W). If CPUID.0AH: + EAX[7:0] > 3. + + @param ECX MSR_IA32_PERF_GLOBAL_STATUS_SET (0x00000391) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_STATUS_SET_REGIS= TER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_STATUS_SET_REGIS= TER. + + Example usage + @code + MSR_IA32_PERF_GLOBAL_STATUS_SET_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_STATUS_SET); + AsmWriteMsr64 (MSR_IA32_PERF_GLOBAL_STATUS_SET, Msr.Uint64); + @endcode + @note MSR_IA32_PERF_GLOBAL_STATUS_SET is defined as IA32_PERF_GLOBAL_STA= TUS_SET in SDM. +**/ +#define MSR_IA32_PERF_GLOBAL_STATUS_SET 0x00000391 + +/** + MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_STATUS_SET +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 31:0] Set 1 to cause Ovf_PMCn =3D 1. If CPUID.0AH: EAX[7:0] = > n. + /// Set bitmask. Only the first n-1 bits are valid. + /// Bits 31:n are reserved. + /// + UINT32 Ovf_PMCn:32; + /// + /// [Bits 54:32] Set 1 to cause Ovf_FIXED_CTRn =3D 1. + /// If CPUID.0AH: EAX[7:0] > n. + /// Set bitmask. Only the first n-1 bits are valid. + /// Bits 22:n are reserved. + /// + UINT32 Ovf_FIXED_CTRn:23; + /// + /// [Bit 55] Set 1 to cause Trace_ToPA_PMI =3D 1. If CPUID.0AH: EAX[7:= 0] > 3. + /// + UINT32 Trace_ToPA_PMI:1; + UINT32 Reserved2:2; + /// + /// [Bit 58] Set 1 to cause LBR_Frz =3D 1. If CPUID.0AH: EAX[7:0] > 3. + /// + UINT32 LBR_Frz:1; + /// + /// [Bit 59] Set 1 to cause CTR_Frz =3D 1. If CPUID.0AH: EAX[7:0] > 3. + /// + UINT32 CTR_Frz:1; + /// + /// [Bit 60] Set 1 to cause ASCI =3D 1. If CPUID.0AH: EAX[7:0] > 3. + /// + UINT32 ASCI:1; + /// + /// [Bit 61] Set 1 to cause Ovf_Uncore =3D 1. If CPUID.0AH: EAX[7:0] >= 3. + /// + UINT32 Ovf_Uncore:1; + /// + /// [Bit 62] Set 1 to cause OvfBuf =3D 1. If CPUID.0AH: EAX[7:0] > 3. + /// + UINT32 OvfBuf:1; + UINT32 Reserved3:1; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PERF_GLOBAL_STATUS_SET_REGISTER; + + +/** + Indicator of core perfmon interface is in use (RO). If CPUID.0AH: EAX[7:= 0] > + 3. + + @param ECX MSR_IA32_PERF_GLOBAL_INUSE (0x00000392) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_INUSE_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PERF_GLOBAL_INUSE_REGISTER. + + Example usage + @code + MSR_IA32_PERF_GLOBAL_INUSE_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_INUSE); + @endcode + @note MSR_IA32_PERF_GLOBAL_INUSE is defined as IA32_PERF_GLOBAL_INUSE in= SDM. +**/ +#define MSR_IA32_PERF_GLOBAL_INUSE 0x00000392 + +/** + MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_INUSE +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 31:0] IA32_PERFEVTSELn in use. If CPUID.0AH: EAX[7:0] > n. + /// Status bitmask. Only the first n-1 bits are valid. + /// Bits 31:n are reserved. + /// + UINT32 IA32_PERFEVTSELn:32; + /// + /// [Bits 62:32] IA32_FIXED_CTRn in use. + /// If CPUID.0AH: EAX[7:0] > n. + /// Status bitmask. Only the first n-1 bits are valid. + /// Bits 30:n are reserved. + /// + UINT32 IA32_FIXED_CTRn:31; + /// + /// [Bit 63] PMI in use. + /// + UINT32 PMI:1; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PERF_GLOBAL_INUSE_REGISTER; + + +/** + PEBS Control (R/W). + + @param ECX MSR_IA32_PEBS_ENABLE (0x000003F1) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PEBS_ENABLE_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PEBS_ENABLE_REGISTER. + + Example usage + @code + MSR_IA32_PEBS_ENABLE_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PEBS_ENABLE); + AsmWriteMsr64 (MSR_IA32_PEBS_ENABLE, Msr.Uint64); + @endcode + @note MSR_IA32_PEBS_ENABLE is defined as IA32_PEBS_ENABLE in SDM. +**/ +#define MSR_IA32_PEBS_ENABLE 0x000003F1 + +/** + MSR information returned for MSR index #MSR_IA32_PEBS_ENABLE +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Enable PEBS on IA32_PMC0. Introduced at Display Family / + /// Display Model 06_0FH. + /// + UINT32 Enable:1; + /// + /// [Bits 3:1] Reserved or Model specific. + /// + UINT32 Reserved1:3; + UINT32 Reserved2:28; + /// + /// [Bits 35:32] Reserved or Model specific. + /// + UINT32 Reserved3:4; + UINT32 Reserved4:28; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PEBS_ENABLE_REGISTER; + + +/** + MCn_CTL. If IA32_MCG_CAP.CNT > n. + + @param ECX MSR_IA32_MCn_CTL + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MC0_CTL); + AsmWriteMsr64 (MSR_IA32_MC0_CTL, Msr); + @endcode + @note MSR_IA32_MC0_CTL is defined as IA32_MC0_CTL in SDM. + MSR_IA32_MC1_CTL is defined as IA32_MC1_CTL in SDM. + MSR_IA32_MC2_CTL is defined as IA32_MC2_CTL in SDM. + MSR_IA32_MC3_CTL is defined as IA32_MC3_CTL in SDM. + MSR_IA32_MC4_CTL is defined as IA32_MC4_CTL in SDM. + MSR_IA32_MC5_CTL is defined as IA32_MC5_CTL in SDM. + MSR_IA32_MC6_CTL is defined as IA32_MC6_CTL in SDM. + MSR_IA32_MC7_CTL is defined as IA32_MC7_CTL in SDM. + MSR_IA32_MC8_CTL is defined as IA32_MC8_CTL in SDM. + MSR_IA32_MC9_CTL is defined as IA32_MC9_CTL in SDM. + MSR_IA32_MC10_CTL is defined as IA32_MC10_CTL in SDM. + MSR_IA32_MC11_CTL is defined as IA32_MC11_CTL in SDM. + MSR_IA32_MC12_CTL is defined as IA32_MC12_CTL in SDM. + MSR_IA32_MC13_CTL is defined as IA32_MC13_CTL in SDM. + MSR_IA32_MC14_CTL is defined as IA32_MC14_CTL in SDM. + MSR_IA32_MC15_CTL is defined as IA32_MC15_CTL in SDM. + MSR_IA32_MC16_CTL is defined as IA32_MC16_CTL in SDM. + MSR_IA32_MC17_CTL is defined as IA32_MC17_CTL in SDM. + MSR_IA32_MC18_CTL is defined as IA32_MC18_CTL in SDM. + MSR_IA32_MC19_CTL is defined as IA32_MC19_CTL in SDM. + MSR_IA32_MC20_CTL is defined as IA32_MC20_CTL in SDM. + MSR_IA32_MC21_CTL is defined as IA32_MC21_CTL in SDM. + MSR_IA32_MC22_CTL is defined as IA32_MC22_CTL in SDM. + MSR_IA32_MC23_CTL is defined as IA32_MC23_CTL in SDM. + MSR_IA32_MC24_CTL is defined as IA32_MC24_CTL in SDM. + MSR_IA32_MC25_CTL is defined as IA32_MC25_CTL in SDM. + MSR_IA32_MC26_CTL is defined as IA32_MC26_CTL in SDM. + MSR_IA32_MC27_CTL is defined as IA32_MC27_CTL in SDM. + MSR_IA32_MC28_CTL is defined as IA32_MC28_CTL in SDM. + @{ +**/ +#define MSR_IA32_MC0_CTL 0x00000400 +#define MSR_IA32_MC1_CTL 0x00000404 +#define MSR_IA32_MC2_CTL 0x00000408 +#define MSR_IA32_MC3_CTL 0x0000040C +#define MSR_IA32_MC4_CTL 0x00000410 +#define MSR_IA32_MC5_CTL 0x00000414 +#define MSR_IA32_MC6_CTL 0x00000418 +#define MSR_IA32_MC7_CTL 0x0000041C +#define MSR_IA32_MC8_CTL 0x00000420 +#define MSR_IA32_MC9_CTL 0x00000424 +#define MSR_IA32_MC10_CTL 0x00000428 +#define MSR_IA32_MC11_CTL 0x0000042C +#define MSR_IA32_MC12_CTL 0x00000430 +#define MSR_IA32_MC13_CTL 0x00000434 +#define MSR_IA32_MC14_CTL 0x00000438 +#define MSR_IA32_MC15_CTL 0x0000043C +#define MSR_IA32_MC16_CTL 0x00000440 +#define MSR_IA32_MC17_CTL 0x00000444 +#define MSR_IA32_MC18_CTL 0x00000448 +#define MSR_IA32_MC19_CTL 0x0000044C +#define MSR_IA32_MC20_CTL 0x00000450 +#define MSR_IA32_MC21_CTL 0x00000454 +#define MSR_IA32_MC22_CTL 0x00000458 +#define MSR_IA32_MC23_CTL 0x0000045C +#define MSR_IA32_MC24_CTL 0x00000460 +#define MSR_IA32_MC25_CTL 0x00000464 +#define MSR_IA32_MC26_CTL 0x00000468 +#define MSR_IA32_MC27_CTL 0x0000046C +#define MSR_IA32_MC28_CTL 0x00000470 +/// @} + + +/** + MCn_STATUS. If IA32_MCG_CAP.CNT > n. + + @param ECX MSR_IA32_MCn_STATUS + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MC0_STATUS); + AsmWriteMsr64 (MSR_IA32_MC0_STATUS, Msr); + @endcode + @note MSR_IA32_MC0_STATUS is defined as IA32_MC0_STATUS in SDM. + MSR_IA32_MC1_STATUS is defined as IA32_MC1_STATUS in SDM. + MSR_IA32_MC2_STATUS is defined as IA32_MC2_STATUS in SDM. + MSR_IA32_MC3_STATUS is defined as IA32_MC3_STATUS in SDM. + MSR_IA32_MC4_STATUS is defined as IA32_MC4_STATUS in SDM. + MSR_IA32_MC5_STATUS is defined as IA32_MC5_STATUS in SDM. + MSR_IA32_MC6_STATUS is defined as IA32_MC6_STATUS in SDM. + MSR_IA32_MC7_STATUS is defined as IA32_MC7_STATUS in SDM. + MSR_IA32_MC8_STATUS is defined as IA32_MC8_STATUS in SDM. + MSR_IA32_MC9_STATUS is defined as IA32_MC9_STATUS in SDM. + MSR_IA32_MC10_STATUS is defined as IA32_MC10_STATUS in SDM. + MSR_IA32_MC11_STATUS is defined as IA32_MC11_STATUS in SDM. + MSR_IA32_MC12_STATUS is defined as IA32_MC12_STATUS in SDM. + MSR_IA32_MC13_STATUS is defined as IA32_MC13_STATUS in SDM. + MSR_IA32_MC14_STATUS is defined as IA32_MC14_STATUS in SDM. + MSR_IA32_MC15_STATUS is defined as IA32_MC15_STATUS in SDM. + MSR_IA32_MC16_STATUS is defined as IA32_MC16_STATUS in SDM. + MSR_IA32_MC17_STATUS is defined as IA32_MC17_STATUS in SDM. + MSR_IA32_MC18_STATUS is defined as IA32_MC18_STATUS in SDM. + MSR_IA32_MC19_STATUS is defined as IA32_MC19_STATUS in SDM. + MSR_IA32_MC20_STATUS is defined as IA32_MC20_STATUS in SDM. + MSR_IA32_MC21_STATUS is defined as IA32_MC21_STATUS in SDM. + MSR_IA32_MC22_STATUS is defined as IA32_MC22_STATUS in SDM. + MSR_IA32_MC23_STATUS is defined as IA32_MC23_STATUS in SDM. + MSR_IA32_MC24_STATUS is defined as IA32_MC24_STATUS in SDM. + MSR_IA32_MC25_STATUS is defined as IA32_MC25_STATUS in SDM. + MSR_IA32_MC26_STATUS is defined as IA32_MC26_STATUS in SDM. + MSR_IA32_MC27_STATUS is defined as IA32_MC27_STATUS in SDM. + MSR_IA32_MC28_STATUS is defined as IA32_MC28_STATUS in SDM. + @{ +**/ +#define MSR_IA32_MC0_STATUS 0x00000401 +#define MSR_IA32_MC1_STATUS 0x00000405 +#define MSR_IA32_MC2_STATUS 0x00000409 +#define MSR_IA32_MC3_STATUS 0x0000040D +#define MSR_IA32_MC4_STATUS 0x00000411 +#define MSR_IA32_MC5_STATUS 0x00000415 +#define MSR_IA32_MC6_STATUS 0x00000419 +#define MSR_IA32_MC7_STATUS 0x0000041D +#define MSR_IA32_MC8_STATUS 0x00000421 +#define MSR_IA32_MC9_STATUS 0x00000425 +#define MSR_IA32_MC10_STATUS 0x00000429 +#define MSR_IA32_MC11_STATUS 0x0000042D +#define MSR_IA32_MC12_STATUS 0x00000431 +#define MSR_IA32_MC13_STATUS 0x00000435 +#define MSR_IA32_MC14_STATUS 0x00000439 +#define MSR_IA32_MC15_STATUS 0x0000043D +#define MSR_IA32_MC16_STATUS 0x00000441 +#define MSR_IA32_MC17_STATUS 0x00000445 +#define MSR_IA32_MC18_STATUS 0x00000449 +#define MSR_IA32_MC19_STATUS 0x0000044D +#define MSR_IA32_MC20_STATUS 0x00000451 +#define MSR_IA32_MC21_STATUS 0x00000455 +#define MSR_IA32_MC22_STATUS 0x00000459 +#define MSR_IA32_MC23_STATUS 0x0000045D +#define MSR_IA32_MC24_STATUS 0x00000461 +#define MSR_IA32_MC25_STATUS 0x00000465 +#define MSR_IA32_MC26_STATUS 0x00000469 +#define MSR_IA32_MC27_STATUS 0x0000046D +#define MSR_IA32_MC28_STATUS 0x00000471 +/// @} + + +/** + MCn_ADDR. If IA32_MCG_CAP.CNT > n. + + @param ECX MSR_IA32_MCn_ADDR + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MC0_ADDR); + AsmWriteMsr64 (MSR_IA32_MC0_ADDR, Msr); + @endcode + @note MSR_IA32_MC0_ADDR is defined as IA32_MC0_ADDR in SDM. + MSR_IA32_MC1_ADDR is defined as IA32_MC1_ADDR in SDM. + MSR_IA32_MC2_ADDR is defined as IA32_MC2_ADDR in SDM. + MSR_IA32_MC3_ADDR is defined as IA32_MC3_ADDR in SDM. + MSR_IA32_MC4_ADDR is defined as IA32_MC4_ADDR in SDM. + MSR_IA32_MC5_ADDR is defined as IA32_MC5_ADDR in SDM. + MSR_IA32_MC6_ADDR is defined as IA32_MC6_ADDR in SDM. + MSR_IA32_MC7_ADDR is defined as IA32_MC7_ADDR in SDM. + MSR_IA32_MC8_ADDR is defined as IA32_MC8_ADDR in SDM. + MSR_IA32_MC9_ADDR is defined as IA32_MC9_ADDR in SDM. + MSR_IA32_MC10_ADDR is defined as IA32_MC10_ADDR in SDM. + MSR_IA32_MC11_ADDR is defined as IA32_MC11_ADDR in SDM. + MSR_IA32_MC12_ADDR is defined as IA32_MC12_ADDR in SDM. + MSR_IA32_MC13_ADDR is defined as IA32_MC13_ADDR in SDM. + MSR_IA32_MC14_ADDR is defined as IA32_MC14_ADDR in SDM. + MSR_IA32_MC15_ADDR is defined as IA32_MC15_ADDR in SDM. + MSR_IA32_MC16_ADDR is defined as IA32_MC16_ADDR in SDM. + MSR_IA32_MC17_ADDR is defined as IA32_MC17_ADDR in SDM. + MSR_IA32_MC18_ADDR is defined as IA32_MC18_ADDR in SDM. + MSR_IA32_MC19_ADDR is defined as IA32_MC19_ADDR in SDM. + MSR_IA32_MC20_ADDR is defined as IA32_MC20_ADDR in SDM. + MSR_IA32_MC21_ADDR is defined as IA32_MC21_ADDR in SDM. + MSR_IA32_MC22_ADDR is defined as IA32_MC22_ADDR in SDM. + MSR_IA32_MC23_ADDR is defined as IA32_MC23_ADDR in SDM. + MSR_IA32_MC24_ADDR is defined as IA32_MC24_ADDR in SDM. + MSR_IA32_MC25_ADDR is defined as IA32_MC25_ADDR in SDM. + MSR_IA32_MC26_ADDR is defined as IA32_MC26_ADDR in SDM. + MSR_IA32_MC27_ADDR is defined as IA32_MC27_ADDR in SDM. + MSR_IA32_MC28_ADDR is defined as IA32_MC28_ADDR in SDM. + @{ +**/ +#define MSR_IA32_MC0_ADDR 0x00000402 +#define MSR_IA32_MC1_ADDR 0x00000406 +#define MSR_IA32_MC2_ADDR 0x0000040A +#define MSR_IA32_MC3_ADDR 0x0000040E +#define MSR_IA32_MC4_ADDR 0x00000412 +#define MSR_IA32_MC5_ADDR 0x00000416 +#define MSR_IA32_MC6_ADDR 0x0000041A +#define MSR_IA32_MC7_ADDR 0x0000041E +#define MSR_IA32_MC8_ADDR 0x00000422 +#define MSR_IA32_MC9_ADDR 0x00000426 +#define MSR_IA32_MC10_ADDR 0x0000042A +#define MSR_IA32_MC11_ADDR 0x0000042E +#define MSR_IA32_MC12_ADDR 0x00000432 +#define MSR_IA32_MC13_ADDR 0x00000436 +#define MSR_IA32_MC14_ADDR 0x0000043A +#define MSR_IA32_MC15_ADDR 0x0000043E +#define MSR_IA32_MC16_ADDR 0x00000442 +#define MSR_IA32_MC17_ADDR 0x00000446 +#define MSR_IA32_MC18_ADDR 0x0000044A +#define MSR_IA32_MC19_ADDR 0x0000044E +#define MSR_IA32_MC20_ADDR 0x00000452 +#define MSR_IA32_MC21_ADDR 0x00000456 +#define MSR_IA32_MC22_ADDR 0x0000045A +#define MSR_IA32_MC23_ADDR 0x0000045E +#define MSR_IA32_MC24_ADDR 0x00000462 +#define MSR_IA32_MC25_ADDR 0x00000466 +#define MSR_IA32_MC26_ADDR 0x0000046A +#define MSR_IA32_MC27_ADDR 0x0000046E +#define MSR_IA32_MC28_ADDR 0x00000472 +/// @} + + +/** + MCn_MISC. If IA32_MCG_CAP.CNT > n. + + @param ECX MSR_IA32_MCn_MISC + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_MC0_MISC); + AsmWriteMsr64 (MSR_IA32_MC0_MISC, Msr); + @endcode + @note MSR_IA32_MC0_MISC is defined as IA32_MC0_MISC in SDM. + MSR_IA32_MC1_MISC is defined as IA32_MC1_MISC in SDM. + MSR_IA32_MC2_MISC is defined as IA32_MC2_MISC in SDM. + MSR_IA32_MC3_MISC is defined as IA32_MC3_MISC in SDM. + MSR_IA32_MC4_MISC is defined as IA32_MC4_MISC in SDM. + MSR_IA32_MC5_MISC is defined as IA32_MC5_MISC in SDM. + MSR_IA32_MC6_MISC is defined as IA32_MC6_MISC in SDM. + MSR_IA32_MC7_MISC is defined as IA32_MC7_MISC in SDM. + MSR_IA32_MC8_MISC is defined as IA32_MC8_MISC in SDM. + MSR_IA32_MC9_MISC is defined as IA32_MC9_MISC in SDM. + MSR_IA32_MC10_MISC is defined as IA32_MC10_MISC in SDM. + MSR_IA32_MC11_MISC is defined as IA32_MC11_MISC in SDM. + MSR_IA32_MC12_MISC is defined as IA32_MC12_MISC in SDM. + MSR_IA32_MC13_MISC is defined as IA32_MC13_MISC in SDM. + MSR_IA32_MC14_MISC is defined as IA32_MC14_MISC in SDM. + MSR_IA32_MC15_MISC is defined as IA32_MC15_MISC in SDM. + MSR_IA32_MC16_MISC is defined as IA32_MC16_MISC in SDM. + MSR_IA32_MC17_MISC is defined as IA32_MC17_MISC in SDM. + MSR_IA32_MC18_MISC is defined as IA32_MC18_MISC in SDM. + MSR_IA32_MC19_MISC is defined as IA32_MC19_MISC in SDM. + MSR_IA32_MC20_MISC is defined as IA32_MC20_MISC in SDM. + MSR_IA32_MC21_MISC is defined as IA32_MC21_MISC in SDM. + MSR_IA32_MC22_MISC is defined as IA32_MC22_MISC in SDM. + MSR_IA32_MC23_MISC is defined as IA32_MC23_MISC in SDM. + MSR_IA32_MC24_MISC is defined as IA32_MC24_MISC in SDM. + MSR_IA32_MC25_MISC is defined as IA32_MC25_MISC in SDM. + MSR_IA32_MC26_MISC is defined as IA32_MC26_MISC in SDM. + MSR_IA32_MC27_MISC is defined as IA32_MC27_MISC in SDM. + MSR_IA32_MC28_MISC is defined as IA32_MC28_MISC in SDM. + @{ +**/ +#define MSR_IA32_MC0_MISC 0x00000403 +#define MSR_IA32_MC1_MISC 0x00000407 +#define MSR_IA32_MC2_MISC 0x0000040B +#define MSR_IA32_MC3_MISC 0x0000040F +#define MSR_IA32_MC4_MISC 0x00000413 +#define MSR_IA32_MC5_MISC 0x00000417 +#define MSR_IA32_MC6_MISC 0x0000041B +#define MSR_IA32_MC7_MISC 0x0000041F +#define MSR_IA32_MC8_MISC 0x00000423 +#define MSR_IA32_MC9_MISC 0x00000427 +#define MSR_IA32_MC10_MISC 0x0000042B +#define MSR_IA32_MC11_MISC 0x0000042F +#define MSR_IA32_MC12_MISC 0x00000433 +#define MSR_IA32_MC13_MISC 0x00000437 +#define MSR_IA32_MC14_MISC 0x0000043B +#define MSR_IA32_MC15_MISC 0x0000043F +#define MSR_IA32_MC16_MISC 0x00000443 +#define MSR_IA32_MC17_MISC 0x00000447 +#define MSR_IA32_MC18_MISC 0x0000044B +#define MSR_IA32_MC19_MISC 0x0000044F +#define MSR_IA32_MC20_MISC 0x00000453 +#define MSR_IA32_MC21_MISC 0x00000457 +#define MSR_IA32_MC22_MISC 0x0000045B +#define MSR_IA32_MC23_MISC 0x0000045F +#define MSR_IA32_MC24_MISC 0x00000463 +#define MSR_IA32_MC25_MISC 0x00000467 +#define MSR_IA32_MC26_MISC 0x0000046B +#define MSR_IA32_MC27_MISC 0x0000046F +#define MSR_IA32_MC28_MISC 0x00000473 +/// @} + + +/** + Reporting Register of Basic VMX Capabilities (R/O) See Appendix A.1, "B= asic + VMX Information.". If CPUID.01H:ECX.[5] =3D 1. + + @param ECX MSR_IA32_VMX_BASIC (0x00000480) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + MSR_IA32_VMX_BASIC_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_VMX_BASIC); + @endcode + @note MSR_IA32_VMX_BASIC is defined as IA32_VMX_BASIC in SDM. +**/ +#define MSR_IA32_VMX_BASIC 0x00000480 + +/** + MSR information returned for MSR index #MSR_IA32_VMX_BASIC +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 30:0] VMCS revision identifier used by the processor. Proce= ssors + /// that use the same VMCS revision identifier use the same size for V= MCS + /// regions (see subsequent item on bits 44:32). + /// + /// @note Earlier versions of this manual specified that the VMCS revi= sion + /// identifier was a 32-bit field in bits 31:0 of this MSR. For all + /// processors produced prior to this change, bit 31 of this MSR was r= ead + /// as 0. + /// + UINT32 VmcsRevisonId:31; + UINT32 MustBeZero:1; + /// + /// [Bit 44:32] Reports the number of bytes that software should alloc= ate + /// for the VMXON region and any VMCS region. It is a value greater t= han + /// 0 and at most 4096(bit 44 is set if and only if bits 43:32 are cle= ar). + /// + UINT32 VmcsSize:13; + UINT32 Reserved1:3; + /// + /// [Bit 48] Indicates the width of the physical addresses that may be= used + /// for the VMXON region, each VMCS, and data structures referenced by + /// pointers in a VMCS (I/O bitmaps, virtual-APIC page, MSR areas for = VMX + /// transitions). If the bit is 0, these addresses are limited to the + /// processor's physical-address width. If the bit is 1, these addres= ses + /// are limited to 32 bits. This bit is always 0 for processors that + /// support Intel 64 architecture. + /// + /// @note On processors that support Intel 64 architecture, the pointer + /// must not set bits beyond the processor's physical address width. + /// + UINT32 VmcsAddressWidth:1; + /// + /// [Bit 49] If bit 49 is read as 1, the logical processor supports the + /// dual-monitor treatment of system-management interrupts and + /// system-management mode. See Section 34.15 for details of this trea= tment. + /// + UINT32 DualMonitor:1; + /// + /// [Bit 53:50] report the memory type that should be used for the VMC= S, + /// for data structures referenced by pointers in the VMCS (I/O bitmap= s, + /// virtual-APIC page, MSR areas for VMX transitions), and for the MSEG + /// header. If software needs to access these data structures (e.g., to + /// modify the contents of the MSR bitmaps), it can configure the pagi= ng + /// structures to map them into the linear-address space. If it does s= o, + /// it should establish mappings that use the memory type reported bits + /// 53:50 in this MSR. + /// + /// As of this writing, all processors that support VMX operation indi= cate + /// the write-back type. + /// + /// If software needs to access these data structures (e.g., to modify + /// the contents of the MSR bitmaps), it can configure the paging + /// structures to map them into the linear-address space. If it does s= o, + /// it should establish mappings that use the memory type reported in = this + /// MSR. + /// + /// @note Alternatively, software may map any of these regions or + /// structures with the UC memory type. (This may be necessary for the= MSEG + /// header.) Doing so is discouraged unless necessary as it will cause= the + /// performance of software accesses to those structures to suffer. + /// + /// + UINT32 MemoryType:4; + /// + /// [Bit 54] If bit 54 is read as 1, the processor reports information= in + /// the VM-exit instruction-information field on VM exitsdue to execut= ion + /// of the INS and OUTS instructions (see Section 27.2.4). This report= ing + /// is done only if this bit is read as 1. + /// + UINT32 InsOutsReporting:1; + /// + /// [Bit 55] Bit 55 is read as 1 if any VMX controls that default to 1= may + /// be cleared to 0. See Appendix A.2 for details. It also reports sup= port + /// for the VMX capability MSRs IA32_VMX_TRUE_PINBASED_CTLS, + /// IA32_VMX_TRUE_PROCBASED_CTLS, IA32_VMX_TRUE_EXIT_CTLS, and + /// IA32_VMX_TRUE_ENTRY_CTLS. See Appendix A.3.1, Appendix A.3.2, + /// Appendix A.4, and Appendix A.5 for details. + /// + UINT32 VmxControls:1; + UINT32 Reserved2:8; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_VMX_BASIC_REGISTER; + +/// +/// @{ Define value for bit field MSR_IA32_VMX_BASIC_REGISTER.MemoryType +/// +#define MSR_IA32_VMX_BASIC_REGISTER_MEMORY_TYPE_UNCACHEABLE 0x00 +#define MSR_IA32_VMX_BASIC_REGISTER_MEMORY_TYPE_WRITE_BACK 0x06 +/// +/// @} +/// + + +/** + Capability Reporting Register of Pinbased VM-execution Controls (R/O) See + Appendix A.3.1, "Pin-Based VMExecution Controls.". If CPUID.01H:ECX.[5] = =3D 1. + + @param ECX MSR_IA32_VMX_PINBASED_CTLS (0x00000481) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_PINBASED_CTLS); + @endcode + @note MSR_IA32_VMX_PINBASED_CTLS is defined as IA32_VMX_PINBASED_CTLS in= SDM. +**/ +#define MSR_IA32_VMX_PINBASED_CTLS 0x00000481 + + +/** + Capability Reporting Register of Primary Processor-based VM-execution + Controls (R/O) See Appendix A.3.2, "Primary Processor- Based VM-Execution + Controls.". If CPUID.01H:ECX.[5] =3D 1. + + @param ECX MSR_IA32_VMX_PROCBASED_CTLS (0x00000482) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_PROCBASED_CTLS); + @endcode + @note MSR_IA32_VMX_PROCBASED_CTLS is defined as IA32_VMX_PROCBASED_CTLS = in SDM. +**/ +#define MSR_IA32_VMX_PROCBASED_CTLS 0x00000482 + + +/** + Capability Reporting Register of VM-exit Controls (R/O) See Appendix A.= 4, + "VM-Exit Controls.". If CPUID.01H:ECX.[5] =3D 1. + + @param ECX MSR_IA32_VMX_EXIT_CTLS (0x00000483) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_EXIT_CTLS); + @endcode + @note MSR_IA32_VMX_EXIT_CTLS is defined as IA32_VMX_EXIT_CTLS in SDM. +**/ +#define MSR_IA32_VMX_EXIT_CTLS 0x00000483 + + +/** + Capability Reporting Register of VMentry Controls (R/O) See Appendix A.5, + "VM-Entry Controls.". If CPUID.01H:ECX.[5] =3D 1. + + @param ECX MSR_IA32_VMX_ENTRY_CTLS (0x00000484) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_ENTRY_CTLS); + @endcode + @note MSR_IA32_VMX_ENTRY_CTLS is defined as IA32_VMX_ENTRY_CTLS in SDM. +**/ +#define MSR_IA32_VMX_ENTRY_CTLS 0x00000484 + + +/** + Reporting Register of Miscellaneous VMX Capabilities (R/O) See Appendix = A.6, + "Miscellaneous Data.". If CPUID.01H:ECX.[5] =3D 1. + + @param ECX MSR_IA32_VMX_MISC (0x00000485) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + IA32_VMX_MISC_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_VMX_MISC); + @endcode + @note MSR_IA32_VMX_MISC is defined as IA32_VMX_MISC in SDM. +**/ +#define MSR_IA32_VMX_MISC 0x00000485 + +/** + MSR information returned for MSR index #IA32_VMX_MISC +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 4:0] Reports a value X that specifies the relationship betwe= en the + /// rate of the VMX-preemption timer and that of the timestamp counter= (TSC). + /// Specifically, the VMX-preemption timer (if it is active) counts do= wn by + /// 1 every time bit X in the TSC changes due to a TSC increment. + /// + UINT32 VmxTimerRatio:5; + /// + /// [Bit 5] If bit 5 is read as 1, VM exits store the value of IA32_EF= ER.LMA + /// into the "IA-32e mode guest" VM-entry control;see Section 27.2 for= more + /// details. This bit is read as 1 on any logical processor that suppo= rts + /// the 1-setting of the "unrestricted guest" VM-execution control. + /// + UINT32 VmExitEferLma:1; + /// + /// [Bit 6] reports (if set) the support for activity state 1 (HLT). + /// + UINT32 HltActivityStateSupported:1; + /// + /// [Bit 7] reports (if set) the support for activity state 2 (shutdow= n). + /// + UINT32 ShutdownActivityStateSupported:1; + /// + /// [Bit 8] reports (if set) the support for activity state 3 (wait-fo= r-SIPI). + /// + UINT32 WaitForSipiActivityStateSupported:1; + UINT32 Reserved1:5; + /// + /// [Bit 14] If read as 1, Intel(R) Processor Trace (Intel PT) can be = used + /// in VMX operation. If the processor supports Intel PT but does not = allow + /// it to be used in VMX operation, execution of VMXON clears + /// IA32_RTIT_CTL.TraceEn (see "VMXON-Enter VMX Operation" in Chapter = 30); + /// any attempt to set that bit while in VMX operation (including VMX = root + /// operation) using the WRMSR instruction causes a general-protection + /// exception. + /// + UINT32 ProcessorTraceSupported:1; + /// + /// [Bit 15] If read as 1, the RDMSR instruction can be used in system- + /// management mode (SMM) to read the IA32_SMBASE MSR (MSR address 9EH= ). + /// See Section 34.15.6.3. + /// + UINT32 SmBaseMsrSupported:1; + /// + /// [Bits 24:16] Indicate the number of CR3-target values supported by= the + /// processor. This number is a value between 0 and 256, inclusive (bi= t 24 + /// is set if and only if bits 23:16 are clear). + /// + UINT32 NumberOfCr3TargetValues:9; + /// + /// [Bit 27:25] Bits 27:25 is used to compute the recommended maximum + /// number of MSRs that should appear in the VM-exit MSR-store list, t= he + /// VM-exit MSR-load list, or the VM-entry MSR-load list. Specifically= , if + /// the value bits 27:25 of IA32_VMX_MISC is N, then 512 * (N + 1) is = the + /// recommended maximum number of MSRs to be included in each list. If= the + /// limit is exceeded, undefined processor behavior may result (includ= ing a + /// machine check during the VMX transition). + /// + UINT32 MsrStoreListMaximum:3; + /// + /// [Bit 28] If read as 1, bit 2 of the IA32_SMM_MONITOR_CTL can be set + /// to 1. VMXOFF unblocks SMIs unless IA32_SMM_MONITOR_CTL[bit 2] is 1 + /// (see Section 34.14.4). + /// + UINT32 BlockSmiSupported:1; + /// + /// [Bit 29] read as 1, software can use VMWRITE to write to any suppo= rted + /// field in the VMCS; otherwise, VMWRITE cannot be used to modify VM-= exit + /// information fields. + /// + UINT32 VmWriteSupported:1; + /// + /// [Bit 30] If read as 1, VM entry allows injection of a software + /// interrupt, software exception, or privileged software exception wi= th an + /// instruction length of 0. + /// + UINT32 VmInjectSupported:1; + UINT32 Reserved2:1; + /// + /// [Bits 63:32] Reports the 32-bit MSEG revision identifier used by t= he + /// processor. + /// + UINT32 MsegRevisionIdentifier:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} IA32_VMX_MISC_REGISTER; + + +/** + Capability Reporting Register of CR0 Bits Fixed to 0 (R/O) See Appendix = A.7, + "VMX-Fixed Bits in CR0.". If CPUID.01H:ECX.[5] =3D 1. + + @param ECX MSR_IA32_VMX_CR0_FIXED0 (0x00000486) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_CR0_FIXED0); + @endcode + @note MSR_IA32_VMX_CR0_FIXED0 is defined as IA32_VMX_CR0_FIXED0 in SDM. +**/ +#define MSR_IA32_VMX_CR0_FIXED0 0x00000486 + + +/** + Capability Reporting Register of CR0 Bits Fixed to 1 (R/O) See Appendix = A.7, + "VMX-Fixed Bits in CR0.". If CPUID.01H:ECX.[5] =3D 1. + + @param ECX MSR_IA32_VMX_CR0_FIXED1 (0x00000487) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_CR0_FIXED1); + @endcode + @note MSR_IA32_VMX_CR0_FIXED1 is defined as IA32_VMX_CR0_FIXED1 in SDM. +**/ +#define MSR_IA32_VMX_CR0_FIXED1 0x00000487 + + +/** + Capability Reporting Register of CR4 Bits Fixed to 0 (R/O) See Appendix = A.8, + "VMX-Fixed Bits in CR4.". If CPUID.01H:ECX.[5] =3D 1. + + @param ECX MSR_IA32_VMX_CR4_FIXED0 (0x00000488) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_CR4_FIXED0); + @endcode + @note MSR_IA32_VMX_CR4_FIXED0 is defined as IA32_VMX_CR4_FIXED0 in SDM. +**/ +#define MSR_IA32_VMX_CR4_FIXED0 0x00000488 + + +/** + Capability Reporting Register of CR4 Bits Fixed to 1 (R/O) See Appendix = A.8, + "VMX-Fixed Bits in CR4.". If CPUID.01H:ECX.[5] =3D 1. + + @param ECX MSR_IA32_VMX_CR4_FIXED1 (0x00000489) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_CR4_FIXED1); + @endcode + @note MSR_IA32_VMX_CR4_FIXED1 is defined as IA32_VMX_CR4_FIXED1 in SDM. +**/ +#define MSR_IA32_VMX_CR4_FIXED1 0x00000489 + + +/** + Capability Reporting Register of VMCS Field Enumeration (R/O) See Append= ix + A.9, "VMCS Enumeration.". If CPUID.01H:ECX.[5] =3D 1. + + @param ECX MSR_IA32_VMX_VMCS_ENUM (0x0000048A) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_VMCS_ENUM); + @endcode + @note MSR_IA32_VMX_VMCS_ENUM is defined as IA32_VMX_VMCS_ENUM in SDM. +**/ +#define MSR_IA32_VMX_VMCS_ENUM 0x0000048A + + +/** + Capability Reporting Register of Secondary Processor-based VM-execution + Controls (R/O) See Appendix A.3.3, "Secondary Processor- Based VM-Execut= ion + Controls.". If ( CPUID.01H:ECX.[5] && IA32_VMX_PROCBASED_C TLS[63]). + + @param ECX MSR_IA32_VMX_PROCBASED_CTLS2 (0x0000048B) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_PROCBASED_CTLS2); + @endcode + @note MSR_IA32_VMX_PROCBASED_CTLS2 is defined as IA32_VMX_PROCBASED_CTLS= 2 in SDM. +**/ +#define MSR_IA32_VMX_PROCBASED_CTLS2 0x0000048B + + +/** + Capability Reporting Register of EPT and VPID (R/O) See Appendix A.10, + "VPID and EPT Capabilities.". If ( CPUID.01H:ECX.[5] && IA32_VMX_PROCBAS= ED_C + TLS[63] && ( IA32_VMX_PROCBASED_C TLS2[33] IA32_VMX_PROCBASED_C TLS2[37]= ) ). + + @param ECX MSR_IA32_VMX_EPT_VPID_CAP (0x0000048C) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_EPT_VPID_CAP); + @endcode + @note MSR_IA32_VMX_EPT_VPID_CAP is defined as IA32_VMX_EPT_VPID_CAP in S= DM. +**/ +#define MSR_IA32_VMX_EPT_VPID_CAP 0x0000048C + + +/** + Capability Reporting Register of Pinbased VM-execution Flex Controls (R/= O) + See Appendix A.3.1, "Pin-Based VMExecution Controls.". If ( + CPUID.01H:ECX.[5] =3D 1 && IA32_VMX_BASIC[55] ). + + @param ECX MSR_IA32_VMX_TRUE_PINBASED_CTLS (0x0000048D) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_TRUE_PINBASED_CTLS); + @endcode + @note MSR_IA32_VMX_TRUE_PINBASED_CTLS is defined as IA32_VMX_TRUE_PINBAS= ED_CTLS in SDM. +**/ +#define MSR_IA32_VMX_TRUE_PINBASED_CTLS 0x0000048D + + +/** + Capability Reporting Register of Primary Processor-based VM-execution F= lex + Controls (R/O) See Appendix A.3.2, "Primary Processor- Based VM-Execution + Controls.". If( CPUID.01H:ECX.[5] =3D 1 && IA32_VMX_BASIC[55] ). + + @param ECX MSR_IA32_VMX_TRUE_PROCBASED_CTLS (0x0000048E) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_TRUE_PROCBASED_CTLS); + @endcode + @note MSR_IA32_VMX_TRUE_PROCBASED_CTLS is defined as IA32_VMX_TRUE_PROCB= ASED_CTLS in SDM. +**/ +#define MSR_IA32_VMX_TRUE_PROCBASED_CTLS 0x0000048E + + +/** + Capability Reporting Register of VM-exit Flex Controls (R/O) See Append= ix + A.4, "VM-Exit Controls.". If( CPUID.01H:ECX.[5] =3D 1 && IA32_VMX_BASIC[= 55] ). + + @param ECX MSR_IA32_VMX_TRUE_EXIT_CTLS (0x0000048F) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_TRUE_EXIT_CTLS); + @endcode + @note MSR_IA32_VMX_TRUE_EXIT_CTLS is defined as IA32_VMX_TRUE_EXIT_CTLS = in SDM. +**/ +#define MSR_IA32_VMX_TRUE_EXIT_CTLS 0x0000048F + + +/** + Capability Reporting Register of VMentry Flex Controls (R/O) See Appendix + A.5, "VM-Entry Controls.". If( CPUID.01H:ECX.[5] =3D 1 && IA32_VMX_BASIC= [55] ). + + @param ECX MSR_IA32_VMX_TRUE_ENTRY_CTLS (0x00000490) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_TRUE_ENTRY_CTLS); + @endcode + @note MSR_IA32_VMX_TRUE_ENTRY_CTLS is defined as IA32_VMX_TRUE_ENTRY_CTL= S in SDM. +**/ +#define MSR_IA32_VMX_TRUE_ENTRY_CTLS 0x00000490 + + +/** + Capability Reporting Register of VMfunction Controls (R/O). If( + CPUID.01H:ECX.[5] =3D 1 && IA32_VMX_BASIC[55] ). + + @param ECX MSR_IA32_VMX_VMFUNC (0x00000491) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_VMX_VMFUNC); + @endcode + @note MSR_IA32_VMX_VMFUNC is defined as IA32_VMX_VMFUNC in SDM. +**/ +#define MSR_IA32_VMX_VMFUNC 0x00000491 + + +/** + Full Width Writable IA32_PMCn Alias (R/W). (If CPUID.0AH: EAX[15:8] > n)= && + IA32_PERF_CAPABILITIES[ 13] =3D 1. + + @param ECX MSR_IA32_A_PMCn + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_A_PMC0); + AsmWriteMsr64 (MSR_IA32_A_PMC0, Msr); + @endcode + @note MSR_IA32_A_PMC0 is defined as IA32_A_PMC0 in SDM. + MSR_IA32_A_PMC1 is defined as IA32_A_PMC1 in SDM. + MSR_IA32_A_PMC2 is defined as IA32_A_PMC2 in SDM. + MSR_IA32_A_PMC3 is defined as IA32_A_PMC3 in SDM. + MSR_IA32_A_PMC4 is defined as IA32_A_PMC4 in SDM. + MSR_IA32_A_PMC5 is defined as IA32_A_PMC5 in SDM. + MSR_IA32_A_PMC6 is defined as IA32_A_PMC6 in SDM. + MSR_IA32_A_PMC7 is defined as IA32_A_PMC7 in SDM. + @{ +**/ +#define MSR_IA32_A_PMC0 0x000004C1 +#define MSR_IA32_A_PMC1 0x000004C2 +#define MSR_IA32_A_PMC2 0x000004C3 +#define MSR_IA32_A_PMC3 0x000004C4 +#define MSR_IA32_A_PMC4 0x000004C5 +#define MSR_IA32_A_PMC5 0x000004C6 +#define MSR_IA32_A_PMC6 0x000004C7 +#define MSR_IA32_A_PMC7 0x000004C8 +/// @} + + +/** + (R/W). If IA32_MCG_CAP.LMCE_P =3D1. + + @param ECX MSR_IA32_MCG_EXT_CTL (0x000004D0) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_MCG_EXT_CTL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_MCG_EXT_CTL_REGISTER. + + Example usage + @code + MSR_IA32_MCG_EXT_CTL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MCG_EXT_CTL); + AsmWriteMsr64 (MSR_IA32_MCG_EXT_CTL, Msr.Uint64); + @endcode + @note MSR_IA32_MCG_EXT_CTL is defined as IA32_MCG_EXT_CTL in SDM. +**/ +#define MSR_IA32_MCG_EXT_CTL 0x000004D0 + +/** + MSR information returned for MSR index #MSR_IA32_MCG_EXT_CTL +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] LMCE_EN. + /// + UINT32 LMCE_EN:1; + UINT32 Reserved1:31; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_MCG_EXT_CTL_REGISTER; + + +/** + Status and SVN Threshold of SGX Support for ACM (RO). If CPUID.(EAX=3D07= H, + ECX=3D0H): EBX[2] =3D 1. + + @param ECX MSR_IA32_SGX_SVN_STATUS (0x00000500) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_SGX_SVN_STATUS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_SGX_SVN_STATUS_REGISTER. + + Example usage + @code + MSR_IA32_SGX_SVN_STATUS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_SGX_SVN_STATUS); + @endcode + @note MSR_IA32_SGX_SVN_STATUS is defined as IA32_SGX_SVN_STATUS in SDM. +**/ +#define MSR_IA32_SGX_SVN_STATUS 0x00000500 + +/** + MSR information returned for MSR index #MSR_IA32_SGX_SVN_STATUS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Lock. See Section 41.11.3, "Interactions with Authenticated + /// Code Modules (ACMs)". + /// + UINT32 Lock:1; + UINT32 Reserved1:15; + /// + /// [Bits 23:16] SGX_SVN_SINIT. See Section 41.11.3, "Interactions with + /// Authenticated Code Modules (ACMs)". + /// + UINT32 SGX_SVN_SINIT:8; + UINT32 Reserved2:8; + UINT32 Reserved3:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_SGX_SVN_STATUS_REGISTER; + + +/** + Trace Output Base Register (R/W). If ((CPUID.(EAX=3D07H, ECX=3D0):EBX[25= ] =3D 1) + && ( (CPUID.(EAX=3D14H,ECX=3D0): ECX[0] =3D 1) (CPUID.(EAX=3D14H,ECX=3D0= ): ECX[2] =3D 1) + ) ). + + @param ECX MSR_IA32_RTIT_OUTPUT_BASE (0x00000560) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_OUTPUT_BASE_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_OUTPUT_BASE_REGISTER. + + Example usage + @code + MSR_IA32_RTIT_OUTPUT_BASE_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_OUTPUT_BASE); + AsmWriteMsr64 (MSR_IA32_RTIT_OUTPUT_BASE, Msr.Uint64); + @endcode + @note MSR_IA32_RTIT_OUTPUT_BASE is defined as IA32_RTIT_OUTPUT_BASE in S= DM. +**/ +#define MSR_IA32_RTIT_OUTPUT_BASE 0x00000560 + +/** + MSR information returned for MSR index #MSR_IA32_RTIT_OUTPUT_BASE +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved:7; + /// + /// [Bits 31:7] Base physical address. + /// + UINT32 Base:25; + /// + /// [Bits 63:32] Base physical address. + /// + UINT32 BaseHi:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_RTIT_OUTPUT_BASE_REGISTER; + + +/** + Trace Output Mask Pointers Register (R/W). If ((CPUID.(EAX=3D07H, + ECX=3D0):EBX[25] =3D 1) && ( (CPUID.(EAX=3D14H,ECX=3D0): ECX[0] =3D 1) + (CPUID.(EAX=3D14H,ECX=3D0): ECX[2] =3D 1) ) ). + + @param ECX MSR_IA32_RTIT_OUTPUT_MASK_PTRS (0x00000561) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_OUTPUT_MASK_PTRS_REGIST= ER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_OUTPUT_MASK_PTRS_REGIST= ER. + + Example usage + @code + MSR_IA32_RTIT_OUTPUT_MASK_PTRS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_OUTPUT_MASK_PTRS); + AsmWriteMsr64 (MSR_IA32_RTIT_OUTPUT_MASK_PTRS, Msr.Uint64); + @endcode + @note MSR_IA32_RTIT_OUTPUT_MASK_PTRS is defined as IA32_RTIT_OUTPUT_MASK= _PTRS in SDM. +**/ +#define MSR_IA32_RTIT_OUTPUT_MASK_PTRS 0x00000561 + +/** + MSR information returned for MSR index #MSR_IA32_RTIT_OUTPUT_MASK_PTRS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved:7; + /// + /// [Bits 31:7] MaskOrTableOffset. + /// + UINT32 MaskOrTableOffset:25; + /// + /// [Bits 63:32] Output Offset. + /// + UINT32 OutputOffset:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_RTIT_OUTPUT_MASK_PTRS_REGISTER; + +/** + Format of ToPA table entries. +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] END. See Section 35.2.6.2, "Table of Physical Addresses (T= oPA)". + /// + UINT32 END:1; + UINT32 Reserved1:1; + /// + /// [Bit 2] INT. See Section 35.2.6.2, "Table of Physical Addresses (T= oPA)". + /// + UINT32 INT:1; + UINT32 Reserved2:1; + /// + /// [Bit 4] STOP. See Section 35.2.6.2, "Table of Physical Addresses (= ToPA)". + /// + UINT32 STOP:1; + UINT32 Reserved3:1; + /// + /// [Bit 6:9] Indicates the size of the associated output region. See = Section + /// 35.2.6.2, "Table of Physical Addresses (ToPA)". + /// + UINT32 Size:4; + UINT32 Reserved4:2; + /// + /// [Bit 12:31] Output Region Base Physical Address low part. + /// [Bit 12:31] Output Region Base Physical Address [12:63] value to m= atch. + /// ATTENTION: The size of the address field is determined by the proc= essor's + /// physical-address width (MAXPHYADDR) in bits, as reported in + /// CPUID.80000008H:EAX[7:0]. the above part of address reserved. + /// True address field is [12:MAXPHYADDR-1], [MAXPHYADDR:63] is reserv= ed part. + /// Detail see Section 35.2.6.2, "Table of Physical Addresses (ToPA)". + /// + UINT32 Base:20; + /// + /// [Bit 32:63] Output Region Base Physical Address high part. + /// [Bit 32:63] Output Region Base Physical Address [12:63] value to m= atch. + /// ATTENTION: The size of the address field is determined by the proc= essor's + /// physical-address width (MAXPHYADDR) in bits, as reported in + /// CPUID.80000008H:EAX[7:0]. the above part of address reserved. + /// True address field is [12:MAXPHYADDR-1], [MAXPHYADDR:63] is reserv= ed part. + /// Detail see Section 35.2.6.2, "Table of Physical Addresses (ToPA)". + /// + UINT32 BaseHi:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} RTIT_TOPA_TABLE_ENTRY; + +/// +/// The size of the associated output region usd by Topa. +/// +typedef enum { + RtitTopaMemorySize4K =3D 0, + RtitTopaMemorySize8K, + RtitTopaMemorySize16K, + RtitTopaMemorySize32K, + RtitTopaMemorySize64K, + RtitTopaMemorySize128K, + RtitTopaMemorySize256K, + RtitTopaMemorySize512K, + RtitTopaMemorySize1M, + RtitTopaMemorySize2M, + RtitTopaMemorySize4M, + RtitTopaMemorySize8M, + RtitTopaMemorySize16M, + RtitTopaMemorySize32M, + RtitTopaMemorySize64M, + RtitTopaMemorySize128M +} RTIT_TOPA_MEMORY_SIZE; + +/** + Trace Control Register (R/W). If (CPUID.(EAX=3D07H, ECX=3D0):EBX[25] =3D= 1). + + @param ECX MSR_IA32_RTIT_CTL (0x00000570) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_CTL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_CTL_REGISTER. + + Example usage + @code + MSR_IA32_RTIT_CTL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_CTL); + AsmWriteMsr64 (MSR_IA32_RTIT_CTL, Msr.Uint64); + @endcode + @note MSR_IA32_RTIT_CTL is defined as IA32_RTIT_CTL in SDM. +**/ +#define MSR_IA32_RTIT_CTL 0x00000570 + +/** + MSR information returned for MSR index #MSR_IA32_RTIT_CTL +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] TraceEn. + /// + UINT32 TraceEn:1; + /// + /// [Bit 1] CYCEn. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[1] =3D 1). + /// + UINT32 CYCEn:1; + /// + /// [Bit 2] OS. + /// + UINT32 OS:1; + /// + /// [Bit 3] User. + /// + UINT32 User:1; + /// + /// [Bit 4] PwrEvtEn. + /// + UINT32 PwrEvtEn:1; + /// + /// [Bit 5] FUPonPTW. + /// + UINT32 FUPonPTW:1; + /// + /// [Bit 6] FabricEn. If (CPUID.(EAX=3D07H, ECX=3D0):ECX[3] =3D 1). + /// + UINT32 FabricEn:1; + /// + /// [Bit 7] CR3 filter. + /// + UINT32 CR3:1; + /// + /// [Bit 8] ToPA. + /// + UINT32 ToPA:1; + /// + /// [Bit 9] MTCEn. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[3] =3D 1). + /// + UINT32 MTCEn:1; + /// + /// [Bit 10] TSCEn. + /// + UINT32 TSCEn:1; + /// + /// [Bit 11] DisRETC. + /// + UINT32 DisRETC:1; + /// + /// [Bit 12] PTWEn. + /// + UINT32 PTWEn:1; + /// + /// [Bit 13] BranchEn. + /// + UINT32 BranchEn:1; + /// + /// [Bits 17:14] MTCFreq. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[3] =3D 1). + /// + UINT32 MTCFreq:4; + UINT32 Reserved3:1; + /// + /// [Bits 22:19] CYCThresh. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[1] =3D = 1). + /// + UINT32 CYCThresh:4; + UINT32 Reserved4:1; + /// + /// [Bits 27:24] PSBFreq. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[1] =3D 1). + /// + UINT32 PSBFreq:4; + UINT32 Reserved5:4; + /// + /// [Bits 35:32] ADDR0_CFG. If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > = 0). + /// + UINT32 ADDR0_CFG:4; + /// + /// [Bits 39:36] ADDR1_CFG. If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > = 1). + /// + UINT32 ADDR1_CFG:4; + /// + /// [Bits 43:40] ADDR2_CFG. If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > = 2). + /// + UINT32 ADDR2_CFG:4; + /// + /// [Bits 47:44] ADDR3_CFG. If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > = 3). + /// + UINT32 ADDR3_CFG:4; + UINT32 Reserved6:16; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_RTIT_CTL_REGISTER; + + +/** + Tracing Status Register (R/W). If (CPUID.(EAX=3D07H, ECX=3D0):EBX[25] = =3D 1). + + @param ECX MSR_IA32_RTIT_STATUS (0x00000571) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_STATUS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_STATUS_REGISTER. + + Example usage + @code + MSR_IA32_RTIT_STATUS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_STATUS); + AsmWriteMsr64 (MSR_IA32_RTIT_STATUS, Msr.Uint64); + @endcode + @note MSR_IA32_RTIT_STATUS is defined as IA32_RTIT_STATUS in SDM. +**/ +#define MSR_IA32_RTIT_STATUS 0x00000571 + +/** + MSR information returned for MSR index #MSR_IA32_RTIT_STATUS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] FilterEn, (writes ignored). + /// If (CPUID.(EAX=3D07H, ECX=3D0):EBX[2] =3D 1). + /// + UINT32 FilterEn:1; + /// + /// [Bit 1] ContexEn, (writes ignored). + /// + UINT32 ContexEn:1; + /// + /// [Bit 2] TriggerEn, (writes ignored). + /// + UINT32 TriggerEn:1; + UINT32 Reserved1:1; + /// + /// [Bit 4] Error. + /// + UINT32 Error:1; + /// + /// [Bit 5] Stopped. + /// + UINT32 Stopped:1; + UINT32 Reserved2:26; + /// + /// [Bits 48:32] PacketByteCnt. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[1] = > 3). + /// + UINT32 PacketByteCnt:17; + UINT32 Reserved3:15; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_RTIT_STATUS_REGISTER; + + +/** + Trace Filter CR3 Match Register (R/W). + If (CPUID.(EAX=3D07H, ECX=3D0):EBX[25] =3D 1). + + @param ECX MSR_IA32_RTIT_CR3_MATCH (0x00000572) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_CR3_MATCH_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_CR3_MATCH_REGISTER. + + Example usage + @code + MSR_IA32_RTIT_CR3_MATCH_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_CR3_MATCH); + AsmWriteMsr64 (MSR_IA32_RTIT_CR3_MATCH, Msr.Uint64); + @endcode + @note MSR_IA32_RTIT_CR3_MATCH is defined as IA32_RTIT_CR3_MATCH in SDM. +**/ +#define MSR_IA32_RTIT_CR3_MATCH 0x00000572 + +/** + MSR information returned for MSR index #MSR_IA32_RTIT_CR3_MATCH +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved:5; + /// + /// [Bits 31:5] CR3[63:5] value to match. + /// + UINT32 Cr3:27; + /// + /// [Bits 63:32] CR3[63:5] value to match. + /// + UINT32 Cr3Hi:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_RTIT_CR3_MATCH_REGISTER; + + +/** + Region n Start Address (R/W). If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > = n). + + @param ECX MSR_IA32_RTIT_ADDRn_A + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_ADDR_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_ADDR_REGISTER. + + Example usage + @code + MSR_IA32_RTIT_ADDR_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_ADDR0_A); + AsmWriteMsr64 (MSR_IA32_RTIT_ADDR0_A, Msr.Uint64); + @endcode + @note MSR_IA32_RTIT_ADDR0_A is defined as IA32_RTIT_ADDR0_A in SDM. + MSR_IA32_RTIT_ADDR1_A is defined as IA32_RTIT_ADDR1_A in SDM. + MSR_IA32_RTIT_ADDR2_A is defined as IA32_RTIT_ADDR2_A in SDM. + MSR_IA32_RTIT_ADDR3_A is defined as IA32_RTIT_ADDR3_A in SDM. + @{ +**/ +#define MSR_IA32_RTIT_ADDR0_A 0x00000580 +#define MSR_IA32_RTIT_ADDR1_A 0x00000582 +#define MSR_IA32_RTIT_ADDR2_A 0x00000584 +#define MSR_IA32_RTIT_ADDR3_A 0x00000586 +/// @} + + +/** + Region n End Address (R/W). If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > n). + + @param ECX MSR_IA32_RTIT_ADDRn_B + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_ADDR_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_RTIT_ADDR_REGISTER. + + Example usage + @code + MSR_IA32_RTIT_ADDR_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_ADDR0_B); + AsmWriteMsr64 (MSR_IA32_RTIT_ADDR0_B, Msr.Uint64); + @endcode + @note MSR_IA32_RTIT_ADDR0_B is defined as IA32_RTIT_ADDR0_B in SDM. + MSR_IA32_RTIT_ADDR1_B is defined as IA32_RTIT_ADDR1_B in SDM. + MSR_IA32_RTIT_ADDR2_B is defined as IA32_RTIT_ADDR2_B in SDM. + MSR_IA32_RTIT_ADDR3_B is defined as IA32_RTIT_ADDR3_B in SDM. + @{ +**/ +#define MSR_IA32_RTIT_ADDR0_B 0x00000581 +#define MSR_IA32_RTIT_ADDR1_B 0x00000583 +#define MSR_IA32_RTIT_ADDR2_B 0x00000585 +#define MSR_IA32_RTIT_ADDR3_B 0x00000587 +/// @} + + +/** + MSR information returned for MSR indexes + #MSR_IA32_RTIT_ADDR0_A to #MSR_IA32_RTIT_ADDR3_A and + #MSR_IA32_RTIT_ADDR0_B to #MSR_IA32_RTIT_ADDR3_B +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 31:0] Virtual Address. + /// + UINT32 VirtualAddress:32; + /// + /// [Bits 47:32] Virtual Address. + /// + UINT32 VirtualAddressHi:16; + /// + /// [Bits 63:48] SignExt_VA. + /// + UINT32 SignExt_VA:16; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_RTIT_ADDR_REGISTER; + + +/** + DS Save Area (R/W) Points to the linear address of the first byte of the= DS + buffer management area, which is used to manage the BTS and PEBS buffers. + See Section 18.6.3.4, "Debug Store (DS) Mechanism.". If( + CPUID.01H:EDX.DS[21] =3D 1. The linear address of the first byte of the = DS + buffer management area, if IA-32e mode is active. + + @param ECX MSR_IA32_DS_AREA (0x00000600) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_DS_AREA_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_DS_AREA_REGISTER. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_DS_AREA); + AsmWriteMsr64 (MSR_IA32_DS_AREA, Msr); + @endcode + @note MSR_IA32_DS_AREA is defined as IA32_DS_AREA in SDM. +**/ +#define MSR_IA32_DS_AREA 0x00000600 + + +/** + TSC Target of Local APIC's TSC Deadline Mode (R/W). If CPUID.01H:ECX.[24= ] =3D + 1. + + @param ECX MSR_IA32_TSC_DEADLINE (0x000006E0) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_TSC_DEADLINE); + AsmWriteMsr64 (MSR_IA32_TSC_DEADLINE, Msr); + @endcode + @note MSR_IA32_TSC_DEADLINE is defined as IA32_TSC_DEADLINE in SDM. +**/ +#define MSR_IA32_TSC_DEADLINE 0x000006E0 + + +/** + Enable/disable HWP (R/W). If CPUID.06H:EAX.[7] =3D 1. + + @param ECX MSR_IA32_PM_ENABLE (0x00000770) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PM_ENABLE_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PM_ENABLE_REGISTER. + + Example usage + @code + MSR_IA32_PM_ENABLE_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PM_ENABLE); + AsmWriteMsr64 (MSR_IA32_PM_ENABLE, Msr.Uint64); + @endcode + @note MSR_IA32_PM_ENABLE is defined as IA32_PM_ENABLE in SDM. +**/ +#define MSR_IA32_PM_ENABLE 0x00000770 + +/** + MSR information returned for MSR index #MSR_IA32_PM_ENABLE +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] HWP_ENABLE (R/W1-Once). See Section 14.4.2, "Enabling HWP"= . If + /// CPUID.06H:EAX.[7] =3D 1. + /// + UINT32 HWP_ENABLE:1; + UINT32 Reserved1:31; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PM_ENABLE_REGISTER; + + +/** + HWP Performance Range Enumeration (RO). If CPUID.06H:EAX.[7] =3D 1. + + @param ECX MSR_IA32_HWP_CAPABILITIES (0x00000771) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_HWP_CAPABILITIES_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_HWP_CAPABILITIES_REGISTER. + + Example usage + @code + MSR_IA32_HWP_CAPABILITIES_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_HWP_CAPABILITIES); + @endcode + @note MSR_IA32_HWP_CAPABILITIES is defined as IA32_HWP_CAPABILITIES in S= DM. +**/ +#define MSR_IA32_HWP_CAPABILITIES 0x00000771 + +/** + MSR information returned for MSR index #MSR_IA32_HWP_CAPABILITIES +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Highest_Performance See Section 14.4.3, "HWP Performance + /// Range and Dynamic Capabilities". If CPUID.06H:EAX.[7] =3D 1. + /// + UINT32 Highest_Performance:8; + /// + /// [Bits 15:8] Guaranteed_Performance See Section 14.4.3, "HWP + /// Performance Range and Dynamic Capabilities". If CPUID.06H:EAX.[7] = =3D 1. + /// + UINT32 Guaranteed_Performance:8; + /// + /// [Bits 23:16] Most_Efficient_Performance See Section 14.4.3, "HWP + /// Performance Range and Dynamic Capabilities". If CPUID.06H:EAX.[7] = =3D 1. + /// + UINT32 Most_Efficient_Performance:8; + /// + /// [Bits 31:24] Lowest_Performance See Section 14.4.3, "HWP Performan= ce + /// Range and Dynamic Capabilities". If CPUID.06H:EAX.[7] =3D 1. + /// + UINT32 Lowest_Performance:8; + UINT32 Reserved:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_HWP_CAPABILITIES_REGISTER; + + +/** + Power Management Control Hints for All Logical Processors in a Package + (R/W). If CPUID.06H:EAX.[11] =3D 1. + + @param ECX MSR_IA32_HWP_REQUEST_PKG (0x00000772) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_HWP_REQUEST_PKG_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_HWP_REQUEST_PKG_REGISTER. + + Example usage + @code + MSR_IA32_HWP_REQUEST_PKG_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_HWP_REQUEST_PKG); + AsmWriteMsr64 (MSR_IA32_HWP_REQUEST_PKG, Msr.Uint64); + @endcode + @note MSR_IA32_HWP_REQUEST_PKG is defined as IA32_HWP_REQUEST_PKG in SDM. +**/ +#define MSR_IA32_HWP_REQUEST_PKG 0x00000772 + +/** + MSR information returned for MSR index #MSR_IA32_HWP_REQUEST_PKG +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Minimum_Performance See Section 14.4.4, "Managing HWP".= If + /// CPUID.06H:EAX.[11] =3D 1. + /// + UINT32 Minimum_Performance:8; + /// + /// [Bits 15:8] Maximum_Performance See Section 14.4.4, "Managing HWP"= . If + /// CPUID.06H:EAX.[11] =3D 1. + /// + UINT32 Maximum_Performance:8; + /// + /// [Bits 23:16] Desired_Performance See Section 14.4.4, "Managing HWP= ". + /// If CPUID.06H:EAX.[11] =3D 1. + /// + UINT32 Desired_Performance:8; + /// + /// [Bits 31:24] Energy_Performance_Preference See Section 14.4.4, + /// "Managing HWP". If CPUID.06H:EAX.[11] =3D 1 && CPUID.06H:EAX.[10] = =3D 1. + /// + UINT32 Energy_Performance_Preference:8; + /// + /// [Bits 41:32] Activity_Window See Section 14.4.4, "Managing HWP". If + /// CPUID.06H:EAX.[11] =3D 1 && CPUID.06H:EAX.[9] =3D 1. + /// + UINT32 Activity_Window:10; + UINT32 Reserved:22; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_HWP_REQUEST_PKG_REGISTER; + + +/** + Control HWP Native Interrupts (R/W). If CPUID.06H:EAX.[8] =3D 1. + + @param ECX MSR_IA32_HWP_INTERRUPT (0x00000773) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_HWP_INTERRUPT_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_HWP_INTERRUPT_REGISTER. + + Example usage + @code + MSR_IA32_HWP_INTERRUPT_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_HWP_INTERRUPT); + AsmWriteMsr64 (MSR_IA32_HWP_INTERRUPT, Msr.Uint64); + @endcode + @note MSR_IA32_HWP_INTERRUPT is defined as IA32_HWP_INTERRUPT in SDM. +**/ +#define MSR_IA32_HWP_INTERRUPT 0x00000773 + +/** + MSR information returned for MSR index #MSR_IA32_HWP_INTERRUPT +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] EN_Guaranteed_Performance_Change. See Section 14.4.6, "HWP + /// Notifications". If CPUID.06H:EAX.[8] =3D 1. + /// + UINT32 EN_Guaranteed_Performance_Change:1; + /// + /// [Bit 1] EN_Excursion_Minimum. See Section 14.4.6, "HWP Notificatio= ns". + /// If CPUID.06H:EAX.[8] =3D 1. + /// + UINT32 EN_Excursion_Minimum:1; + UINT32 Reserved1:30; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_HWP_INTERRUPT_REGISTER; + + +/** + Power Management Control Hints to a Logical Processor (R/W). If + CPUID.06H:EAX.[7] =3D 1. + + @param ECX MSR_IA32_HWP_REQUEST (0x00000774) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_HWP_REQUEST_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_HWP_REQUEST_REGISTER. + + Example usage + @code + MSR_IA32_HWP_REQUEST_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_HWP_REQUEST); + AsmWriteMsr64 (MSR_IA32_HWP_REQUEST, Msr.Uint64); + @endcode + @note MSR_IA32_HWP_REQUEST is defined as IA32_HWP_REQUEST in SDM. +**/ +#define MSR_IA32_HWP_REQUEST 0x00000774 + +/** + MSR information returned for MSR index #MSR_IA32_HWP_REQUEST +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Minimum_Performance See Section 14.4.4, "Managing HWP".= If + /// CPUID.06H:EAX.[7] =3D 1. + /// + UINT32 Minimum_Performance:8; + /// + /// [Bits 15:8] Maximum_Performance See Section 14.4.4, "Managing HWP"= . If + /// CPUID.06H:EAX.[7] =3D 1. + /// + UINT32 Maximum_Performance:8; + /// + /// [Bits 23:16] Desired_Performance See Section 14.4.4, "Managing HWP= ". + /// If CPUID.06H:EAX.[7] =3D 1. + /// + UINT32 Desired_Performance:8; + /// + /// [Bits 31:24] Energy_Performance_Preference See Section 14.4.4, + /// "Managing HWP". If CPUID.06H:EAX.[7] =3D 1 && CPUID.06H:EAX.[10] = =3D 1. + /// + UINT32 Energy_Performance_Preference:8; + /// + /// [Bits 41:32] Activity_Window See Section 14.4.4, "Managing HWP". If + /// CPUID.06H:EAX.[7] =3D 1 && CPUID.06H:EAX.[9] =3D 1. + /// + UINT32 Activity_Window:10; + /// + /// [Bit 42] Package_Control See Section 14.4.4, "Managing HWP". If + /// CPUID.06H:EAX.[7] =3D 1 && CPUID.06H:EAX.[11] =3D 1. + /// + UINT32 Package_Control:1; + UINT32 Reserved:21; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_HWP_REQUEST_REGISTER; + + +/** + Log bits indicating changes to Guaranteed & excursions to Minimum (R/W)= . If + CPUID.06H:EAX.[7] =3D 1. + + @param ECX MSR_IA32_HWP_STATUS (0x00000777) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_HWP_STATUS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_HWP_STATUS_REGISTER. + + Example usage + @code + MSR_IA32_HWP_STATUS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_HWP_STATUS); + AsmWriteMsr64 (MSR_IA32_HWP_STATUS, Msr.Uint64); + @endcode + @note MSR_IA32_HWP_STATUS is defined as IA32_HWP_STATUS in SDM. +**/ +#define MSR_IA32_HWP_STATUS 0x00000777 + +/** + MSR information returned for MSR index #MSR_IA32_HWP_STATUS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Guaranteed_Performance_Change (R/WC0). See Section 14.4.5, + /// "HWP Feedback". If CPUID.06H:EAX.[7] =3D 1. + /// + UINT32 Guaranteed_Performance_Change:1; + UINT32 Reserved1:1; + /// + /// [Bit 2] Excursion_To_Minimum (R/WC0). See Section 14.4.5, "HWP + /// Feedback". If CPUID.06H:EAX.[7] =3D 1. + /// + UINT32 Excursion_To_Minimum:1; + UINT32 Reserved2:29; + UINT32 Reserved3:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_HWP_STATUS_REGISTER; + + +/** + x2APIC ID Register (R/O) See x2APIC Specification. If CPUID.01H:ECX[21] = =3D 1 + && IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_APICID (0x00000802) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_APICID); + @endcode + @note MSR_IA32_X2APIC_APICID is defined as IA32_X2APIC_APICID in SDM. +**/ +#define MSR_IA32_X2APIC_APICID 0x00000802 + + +/** + x2APIC Version Register (R/O). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_VERSION (0x00000803) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_VERSION); + @endcode + @note MSR_IA32_X2APIC_VERSION is defined as IA32_X2APIC_VERSION in SDM. +**/ +#define MSR_IA32_X2APIC_VERSION 0x00000803 + + +/** + x2APIC Task Priority Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_TPR (0x00000808) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_TPR); + AsmWriteMsr64 (MSR_IA32_X2APIC_TPR, Msr); + @endcode + @note MSR_IA32_X2APIC_TPR is defined as IA32_X2APIC_TPR in SDM. +**/ +#define MSR_IA32_X2APIC_TPR 0x00000808 + + +/** + x2APIC Processor Priority Register (R/O). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_PPR (0x0000080A) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_PPR); + @endcode + @note MSR_IA32_X2APIC_PPR is defined as IA32_X2APIC_PPR in SDM. +**/ +#define MSR_IA32_X2APIC_PPR 0x0000080A + + +/** + x2APIC EOI Register (W/O). If CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE= .[10] + =3D 1. + + @param ECX MSR_IA32_X2APIC_EOI (0x0000080B) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D 0; + AsmWriteMsr64 (MSR_IA32_X2APIC_EOI, Msr); + @endcode + @note MSR_IA32_X2APIC_EOI is defined as IA32_X2APIC_EOI in SDM. +**/ +#define MSR_IA32_X2APIC_EOI 0x0000080B + + +/** + x2APIC Logical Destination Register (R/O). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_LDR (0x0000080D) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LDR); + @endcode + @note MSR_IA32_X2APIC_LDR is defined as IA32_X2APIC_LDR in SDM. +**/ +#define MSR_IA32_X2APIC_LDR 0x0000080D + + +/** + x2APIC Spurious Interrupt Vector Register (R/W). If CPUID.01H:ECX.[21] = =3D 1 + && IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_SIVR (0x0000080F) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_SIVR); + AsmWriteMsr64 (MSR_IA32_X2APIC_SIVR, Msr); + @endcode + @note MSR_IA32_X2APIC_SIVR is defined as IA32_X2APIC_SIVR in SDM. +**/ +#define MSR_IA32_X2APIC_SIVR 0x0000080F + + +/** + x2APIC In-Service Register Bits (n * 32 + 31):(n * 32) (R/O). + If CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_ISRn + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_ISR0); + @endcode + @note MSR_IA32_X2APIC_ISR0 is defined as IA32_X2APIC_ISR0 in SDM. + MSR_IA32_X2APIC_ISR1 is defined as IA32_X2APIC_ISR1 in SDM. + MSR_IA32_X2APIC_ISR2 is defined as IA32_X2APIC_ISR2 in SDM. + MSR_IA32_X2APIC_ISR3 is defined as IA32_X2APIC_ISR3 in SDM. + MSR_IA32_X2APIC_ISR4 is defined as IA32_X2APIC_ISR4 in SDM. + MSR_IA32_X2APIC_ISR5 is defined as IA32_X2APIC_ISR5 in SDM. + MSR_IA32_X2APIC_ISR6 is defined as IA32_X2APIC_ISR6 in SDM. + MSR_IA32_X2APIC_ISR7 is defined as IA32_X2APIC_ISR7 in SDM. + @{ +**/ +#define MSR_IA32_X2APIC_ISR0 0x00000810 +#define MSR_IA32_X2APIC_ISR1 0x00000811 +#define MSR_IA32_X2APIC_ISR2 0x00000812 +#define MSR_IA32_X2APIC_ISR3 0x00000813 +#define MSR_IA32_X2APIC_ISR4 0x00000814 +#define MSR_IA32_X2APIC_ISR5 0x00000815 +#define MSR_IA32_X2APIC_ISR6 0x00000816 +#define MSR_IA32_X2APIC_ISR7 0x00000817 +/// @} + + +/** + x2APIC Trigger Mode Register Bits (n * 32 + ):(n * 32) (R/O). + If CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_TMRn + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_TMR0); + @endcode + @note MSR_IA32_X2APIC_TMR0 is defined as IA32_X2APIC_TMR0 in SDM. + MSR_IA32_X2APIC_TMR1 is defined as IA32_X2APIC_TMR1 in SDM. + MSR_IA32_X2APIC_TMR2 is defined as IA32_X2APIC_TMR2 in SDM. + MSR_IA32_X2APIC_TMR3 is defined as IA32_X2APIC_TMR3 in SDM. + MSR_IA32_X2APIC_TMR4 is defined as IA32_X2APIC_TMR4 in SDM. + MSR_IA32_X2APIC_TMR5 is defined as IA32_X2APIC_TMR5 in SDM. + MSR_IA32_X2APIC_TMR6 is defined as IA32_X2APIC_TMR6 in SDM. + MSR_IA32_X2APIC_TMR7 is defined as IA32_X2APIC_TMR7 in SDM. + @{ +**/ +#define MSR_IA32_X2APIC_TMR0 0x00000818 +#define MSR_IA32_X2APIC_TMR1 0x00000819 +#define MSR_IA32_X2APIC_TMR2 0x0000081A +#define MSR_IA32_X2APIC_TMR3 0x0000081B +#define MSR_IA32_X2APIC_TMR4 0x0000081C +#define MSR_IA32_X2APIC_TMR5 0x0000081D +#define MSR_IA32_X2APIC_TMR6 0x0000081E +#define MSR_IA32_X2APIC_TMR7 0x0000081F +/// @} + + +/** + x2APIC Interrupt Request Register Bits (n* 32 + 31):(n * 32) (R/O). + If CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_IRRn + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_IRR0); + @endcode + @note MSR_IA32_X2APIC_IRR0 is defined as IA32_X2APIC_IRR0 in SDM. + MSR_IA32_X2APIC_IRR1 is defined as IA32_X2APIC_IRR1 in SDM. + MSR_IA32_X2APIC_IRR2 is defined as IA32_X2APIC_IRR2 in SDM. + MSR_IA32_X2APIC_IRR3 is defined as IA32_X2APIC_IRR3 in SDM. + MSR_IA32_X2APIC_IRR4 is defined as IA32_X2APIC_IRR4 in SDM. + MSR_IA32_X2APIC_IRR5 is defined as IA32_X2APIC_IRR5 in SDM. + MSR_IA32_X2APIC_IRR6 is defined as IA32_X2APIC_IRR6 in SDM. + MSR_IA32_X2APIC_IRR7 is defined as IA32_X2APIC_IRR7 in SDM. + @{ +**/ +#define MSR_IA32_X2APIC_IRR0 0x00000820 +#define MSR_IA32_X2APIC_IRR1 0x00000821 +#define MSR_IA32_X2APIC_IRR2 0x00000822 +#define MSR_IA32_X2APIC_IRR3 0x00000823 +#define MSR_IA32_X2APIC_IRR4 0x00000824 +#define MSR_IA32_X2APIC_IRR5 0x00000825 +#define MSR_IA32_X2APIC_IRR6 0x00000826 +#define MSR_IA32_X2APIC_IRR7 0x00000827 +/// @} + + +/** + x2APIC Error Status Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_ESR (0x00000828) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_ESR); + AsmWriteMsr64 (MSR_IA32_X2APIC_ESR, Msr); + @endcode + @note MSR_IA32_X2APIC_ESR is defined as IA32_X2APIC_ESR in SDM. +**/ +#define MSR_IA32_X2APIC_ESR 0x00000828 + + +/** + x2APIC LVT Corrected Machine Check Interrupt Register (R/W). If + CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_LVT_CMCI (0x0000082F) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_CMCI); + AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_CMCI, Msr); + @endcode + @note MSR_IA32_X2APIC_LVT_CMCI is defined as IA32_X2APIC_LVT_CMCI in SDM. +**/ +#define MSR_IA32_X2APIC_LVT_CMCI 0x0000082F + + +/** + x2APIC Interrupt Command Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_ICR (0x00000830) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_ICR); + AsmWriteMsr64 (MSR_IA32_X2APIC_ICR, Msr); + @endcode + @note MSR_IA32_X2APIC_ICR is defined as IA32_X2APIC_ICR in SDM. +**/ +#define MSR_IA32_X2APIC_ICR 0x00000830 + + +/** + x2APIC LVT Timer Interrupt Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_LVT_TIMER (0x00000832) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_TIMER); + AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_TIMER, Msr); + @endcode + @note MSR_IA32_X2APIC_LVT_TIMER is defined as IA32_X2APIC_LVT_TIMER in S= DM. +**/ +#define MSR_IA32_X2APIC_LVT_TIMER 0x00000832 + + +/** + x2APIC LVT Thermal Sensor Interrupt Register (R/W). If CPUID.01H:ECX.[21= ] =3D + 1 && IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_LVT_THERMAL (0x00000833) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_THERMAL); + AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_THERMAL, Msr); + @endcode + @note MSR_IA32_X2APIC_LVT_THERMAL is defined as IA32_X2APIC_LVT_THERMAL = in SDM. +**/ +#define MSR_IA32_X2APIC_LVT_THERMAL 0x00000833 + + +/** + x2APIC LVT Performance Monitor Interrupt Register (R/W). If + CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_LVT_PMI (0x00000834) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_PMI); + AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_PMI, Msr); + @endcode + @note MSR_IA32_X2APIC_LVT_PMI is defined as IA32_X2APIC_LVT_PMI in SDM. +**/ +#define MSR_IA32_X2APIC_LVT_PMI 0x00000834 + + +/** + x2APIC LVT LINT0 Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_LVT_LINT0 (0x00000835) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_LINT0); + AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_LINT0, Msr); + @endcode + @note MSR_IA32_X2APIC_LVT_LINT0 is defined as IA32_X2APIC_LVT_LINT0 in S= DM. +**/ +#define MSR_IA32_X2APIC_LVT_LINT0 0x00000835 + + +/** + x2APIC LVT LINT1 Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_LVT_LINT1 (0x00000836) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_LINT1); + AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_LINT1, Msr); + @endcode + @note MSR_IA32_X2APIC_LVT_LINT1 is defined as IA32_X2APIC_LVT_LINT1 in S= DM. +**/ +#define MSR_IA32_X2APIC_LVT_LINT1 0x00000836 + + +/** + x2APIC LVT Error Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_LVT_ERROR (0x00000837) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_ERROR); + AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_ERROR, Msr); + @endcode + @note MSR_IA32_X2APIC_LVT_ERROR is defined as IA32_X2APIC_LVT_ERROR in S= DM. +**/ +#define MSR_IA32_X2APIC_LVT_ERROR 0x00000837 + + +/** + x2APIC Initial Count Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_INIT_COUNT (0x00000838) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_INIT_COUNT); + AsmWriteMsr64 (MSR_IA32_X2APIC_INIT_COUNT, Msr); + @endcode + @note MSR_IA32_X2APIC_INIT_COUNT is defined as IA32_X2APIC_INIT_COUNT in= SDM. +**/ +#define MSR_IA32_X2APIC_INIT_COUNT 0x00000838 + + +/** + x2APIC Current Count Register (R/O). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_CUR_COUNT (0x00000839) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_CUR_COUNT); + @endcode + @note MSR_IA32_X2APIC_CUR_COUNT is defined as IA32_X2APIC_CUR_COUNT in S= DM. +**/ +#define MSR_IA32_X2APIC_CUR_COUNT 0x00000839 + + +/** + x2APIC Divide Configuration Register (R/W). If CPUID.01H:ECX.[21] =3D 1 = && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_DIV_CONF (0x0000083E) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_DIV_CONF); + AsmWriteMsr64 (MSR_IA32_X2APIC_DIV_CONF, Msr); + @endcode + @note MSR_IA32_X2APIC_DIV_CONF is defined as IA32_X2APIC_DIV_CONF in SDM. +**/ +#define MSR_IA32_X2APIC_DIV_CONF 0x0000083E + + +/** + x2APIC Self IPI Register (W/O). If CPUID.01H:ECX.[21] =3D 1 && + IA32_APIC_BASE.[10] =3D 1. + + @param ECX MSR_IA32_X2APIC_SELF_IPI (0x0000083F) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D 0; + AsmWriteMsr64 (MSR_IA32_X2APIC_SELF_IPI, Msr); + @endcode + @note MSR_IA32_X2APIC_SELF_IPI is defined as IA32_X2APIC_SELF_IPI in SDM. +**/ +#define MSR_IA32_X2APIC_SELF_IPI 0x0000083F + + +/** + Silicon Debug Feature Control (R/W). If CPUID.01H:ECX.[11] =3D 1. + + @param ECX MSR_IA32_DEBUG_INTERFACE (0x00000C80) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_DEBUG_INTERFACE_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_DEBUG_INTERFACE_REGISTER. + + Example usage + @code + MSR_IA32_DEBUG_INTERFACE_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_DEBUG_INTERFACE); + AsmWriteMsr64 (MSR_IA32_DEBUG_INTERFACE, Msr.Uint64); + @endcode + @note MSR_IA32_DEBUG_INTERFACE is defined as IA32_DEBUG_INTERFACE in SDM. +**/ +#define MSR_IA32_DEBUG_INTERFACE 0x00000C80 + +/** + MSR information returned for MSR index #MSR_IA32_DEBUG_INTERFACE +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Enable (R/W) BIOS set 1 to enable Silicon debug features. + /// Default is 0. If CPUID.01H:ECX.[11] =3D 1. + /// + UINT32 Enable:1; + UINT32 Reserved1:29; + /// + /// [Bit 30] Lock (R/W): If 1, locks any further change to the MSR. The + /// lock bit is set automatically on the first SMI assertion even if n= ot + /// explicitly set by BIOS. Default is 0. If CPUID.01H:ECX.[11] =3D 1. + /// + UINT32 Lock:1; + /// + /// [Bit 31] Debug Occurred (R/O): This "sticky bit" is set by hardwar= e to + /// indicate the status of bit 0. Default is 0. If CPUID.01H:ECX.[11] = =3D 1. + /// + UINT32 DebugOccurred:1; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_DEBUG_INTERFACE_REGISTER; + + +/** + L3 QOS Configuration (R/W). If ( CPUID.(EAX=3D10H, ECX=3D1):ECX.[2] =3D = 1 ). + + @param ECX MSR_IA32_L3_QOS_CFG (0x00000C81) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_L3_QOS_CFG_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_L3_QOS_CFG_REGISTER. + + Example usage + @code + MSR_IA32_L3_QOS_CFG_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_L3_QOS_CFG); + AsmWriteMsr64 (MSR_IA32_L3_QOS_CFG, Msr.Uint64); + @endcode + @note MSR_IA32_L3_QOS_CFG is defined as IA32_L3_QOS_CFG in SDM. +**/ +#define MSR_IA32_L3_QOS_CFG 0x00000C81 + +/** + MSR information returned for MSR index #MSR_IA32_L3_QOS_CFG +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Enable (R/W) Set 1 to enable L3 CAT masks and COS to opera= te + /// in Code and Data Prioritization (CDP) mode. + /// + UINT32 Enable:1; + UINT32 Reserved1:31; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_L3_QOS_CFG_REGISTER; + +/** + L2 QOS Configuration (R/W). If ( CPUID.(EAX=3D10H, ECX=3D2):ECX.[2] =3D = 1 ). + + @param ECX MSR_IA32_L2_QOS_CFG (0x00000C82) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_L2_QOS_CFG_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_L2_QOS_CFG_REGISTER. + + Example usage + @code + MSR_IA32_L2_QOS_CFG_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_L2_QOS_CFG); + AsmWriteMsr64 (MSR_IA32_L2_QOS_CFG, Msr.Uint64); + @endcode + @note MSR_IA32_L2_QOS_CFG is defined as IA32_L2_QOS_CFG in SDM. +**/ +#define MSR_IA32_L2_QOS_CFG 0x00000C82 + +/** + MSR information returned for MSR index #MSR_IA32_L2_QOS_CFG +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] Enable (R/W) Set 1 to enable L2 CAT masks and COS to opera= te + /// in Code and Data Prioritization (CDP) mode. + /// + UINT32 Enable:1; + UINT32 Reserved1:31; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_L2_QOS_CFG_REGISTER; + +/** + Monitoring Event Select Register (R/W). If ( CPUID.(EAX=3D07H, ECX=3D0):= EBX.[12] + =3D 1 ). + + @param ECX MSR_IA32_QM_EVTSEL (0x00000C8D) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_QM_EVTSEL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_QM_EVTSEL_REGISTER. + + Example usage + @code + MSR_IA32_QM_EVTSEL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_QM_EVTSEL); + AsmWriteMsr64 (MSR_IA32_QM_EVTSEL, Msr.Uint64); + @endcode + @note MSR_IA32_QM_EVTSEL is defined as IA32_QM_EVTSEL in SDM. +**/ +#define MSR_IA32_QM_EVTSEL 0x00000C8D + +/** + MSR information returned for MSR index #MSR_IA32_QM_EVTSEL +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 7:0] Event ID: ID of a supported monitoring event to report = via + /// IA32_QM_CTR. + /// + UINT32 EventID:8; + UINT32 Reserved:24; + /// + /// [Bits 63:32] Resource Monitoring ID: ID for monitoring hardware to + /// report monitored data via IA32_QM_CTR. N =3D Ceil (Log:sub:`2` ( + /// CPUID.(EAX=3D 0FH, ECX=3D0H).EBX[31:0] +1)). + /// + UINT32 ResourceMonitoringID:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_QM_EVTSEL_REGISTER; + + +/** + Monitoring Counter Register (R/O). If ( CPUID.(EAX=3D07H, ECX=3D0):EBX.[= 12] =3D 1 + ). + + @param ECX MSR_IA32_QM_CTR (0x00000C8E) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_QM_CTR_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_QM_CTR_REGISTER. + + Example usage + @code + MSR_IA32_QM_CTR_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_QM_CTR); + @endcode + @note MSR_IA32_QM_CTR is defined as IA32_QM_CTR in SDM. +**/ +#define MSR_IA32_QM_CTR 0x00000C8E + +/** + MSR information returned for MSR index #MSR_IA32_QM_CTR +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 31:0] Resource Monitored Data. + /// + UINT32 ResourceMonitoredData:32; + /// + /// [Bits 61:32] Resource Monitored Data. + /// + UINT32 ResourceMonitoredDataHi:30; + /// + /// [Bit 62] Unavailable: If 1, indicates data for this RMID is not + /// available or not monitored for this resource or RMID. + /// + UINT32 Unavailable:1; + /// + /// [Bit 63] Error: If 1, indicates and unsupported RMID or event type= was + /// written to IA32_PQR_QM_EVTSEL. + /// + UINT32 Error:1; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_QM_CTR_REGISTER; + + +/** + Resource Association Register (R/W). If ( (CPUID.(EAX=3D07H, ECX=3D0):EB= X[12] + =3D1) or (CPUID.(EAX=3D07H, ECX=3D0):EBX[15] =3D1 ) ). + + @param ECX MSR_IA32_PQR_ASSOC (0x00000C8F) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PQR_ASSOC_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PQR_ASSOC_REGISTER. + + Example usage + @code + MSR_IA32_PQR_ASSOC_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PQR_ASSOC); + AsmWriteMsr64 (MSR_IA32_PQR_ASSOC, Msr.Uint64); + @endcode + @note MSR_IA32_PQR_ASSOC is defined as IA32_PQR_ASSOC in SDM. +**/ +#define MSR_IA32_PQR_ASSOC 0x00000C8F + +/** + MSR information returned for MSR index #MSR_IA32_PQR_ASSOC +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 31:0] Resource Monitoring ID (R/W): ID for monitoring hardwa= re + /// to track internal operation, e.g. memory access. N =3D Ceil (Log:s= ub:`2` + /// ( CPUID.(EAX=3D 0FH, ECX=3D0H).EBX[31:0] +1)). + /// + UINT32 ResourceMonitoringID:32; + /// + /// [Bits 63:32] COS (R/W). The class of service (COS) to enforce (on + /// writes); returns the current COS when read. If ( CPUID.(EAX=3D07H, + /// ECX=3D0):EBX.[15] =3D 1 ). + /// + UINT32 COS:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PQR_ASSOC_REGISTER; + + +/** + Supervisor State of MPX Configuration. (R/W). If (CPUID.(EAX=3D07H, + ECX=3D0H):EBX[14] =3D 1). + + @param ECX MSR_IA32_BNDCFGS (0x00000D90) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_BNDCFGS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_BNDCFGS_REGISTER. + + Example usage + @code + MSR_IA32_BNDCFGS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_BNDCFGS); + AsmWriteMsr64 (MSR_IA32_BNDCFGS, Msr.Uint64); + @endcode + @note MSR_IA32_BNDCFGS is defined as IA32_BNDCFGS in SDM. +**/ +#define MSR_IA32_BNDCFGS 0x00000D90 + +/** + MSR information returned for MSR index #MSR_IA32_BNDCFGS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] EN: Enable Intel MPX in supervisor mode. + /// + UINT32 EN:1; + /// + /// [Bit 1] BNDPRESERVE: Preserve the bounds registers for near branch + /// instructions in the absence of the BND prefix. + /// + UINT32 BNDPRESERVE:1; + UINT32 Reserved:10; + /// + /// [Bits 31:12] Base Address of Bound Directory. + /// + UINT32 Base:20; + /// + /// [Bits 63:32] Base Address of Bound Directory. + /// + UINT32 BaseHi:32; + } Bits; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_BNDCFGS_REGISTER; + + +/** + Extended Supervisor State Mask (R/W). If( CPUID.(0DH, 1):EAX.[3] =3D 1. + + @param ECX MSR_IA32_XSS (0x00000DA0) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_XSS_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_XSS_REGISTER. + + Example usage + @code + MSR_IA32_XSS_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_XSS); + AsmWriteMsr64 (MSR_IA32_XSS, Msr.Uint64); + @endcode + @note MSR_IA32_XSS is defined as IA32_XSS in SDM. +**/ +#define MSR_IA32_XSS 0x00000DA0 + +/** + MSR information returned for MSR index #MSR_IA32_XSS +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + UINT32 Reserved1:8; + /// + /// [Bit 8] Trace Packet Configuration State (R/W). + /// + UINT32 TracePacketConfigurationState:1; + UINT32 Reserved2:23; + UINT32 Reserved3:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_XSS_REGISTER; + + +/** + Package Level Enable/disable HDC (R/W). If CPUID.06H:EAX.[13] =3D 1. + + @param ECX MSR_IA32_PKG_HDC_CTL (0x00000DB0) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PKG_HDC_CTL_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PKG_HDC_CTL_REGISTER. + + Example usage + @code + MSR_IA32_PKG_HDC_CTL_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PKG_HDC_CTL); + AsmWriteMsr64 (MSR_IA32_PKG_HDC_CTL, Msr.Uint64); + @endcode + @note MSR_IA32_PKG_HDC_CTL is defined as IA32_PKG_HDC_CTL in SDM. +**/ +#define MSR_IA32_PKG_HDC_CTL 0x00000DB0 + +/** + MSR information returned for MSR index #MSR_IA32_PKG_HDC_CTL +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] HDC_Pkg_Enable (R/W) Force HDC idling or wake up HDC-idled + /// logical processors in the package. See Section 14.5.2, "Package le= vel + /// Enabling HDC". If CPUID.06H:EAX.[13] =3D 1. + /// + UINT32 HDC_Pkg_Enable:1; + UINT32 Reserved1:31; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PKG_HDC_CTL_REGISTER; + + +/** + Enable/disable HWP (R/W). If CPUID.06H:EAX.[13] =3D 1. + + @param ECX MSR_IA32_PM_CTL1 (0x00000DB1) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_PM_CTL1_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_PM_CTL1_REGISTER. + + Example usage + @code + MSR_IA32_PM_CTL1_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PM_CTL1); + AsmWriteMsr64 (MSR_IA32_PM_CTL1, Msr.Uint64); + @endcode + @note MSR_IA32_PM_CTL1 is defined as IA32_PM_CTL1 in SDM. +**/ +#define MSR_IA32_PM_CTL1 0x00000DB1 + +/** + MSR information returned for MSR index #MSR_IA32_PM_CTL1 +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] HDC_Allow_Block (R/W) Allow/Block this logical processor f= or + /// package level HDC control. See Section 14.5.3. + /// If CPUID.06H:EAX.[13] =3D 1. + /// + UINT32 HDC_Allow_Block:1; + UINT32 Reserved1:31; + UINT32 Reserved2:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_PM_CTL1_REGISTER; + + +/** + Per-Logical_Processor HDC Idle Residency (R/0). If CPUID.06H:EAX.[13] = =3D 1. + Stall_Cycle_Cnt (R/W) Stalled cycles due to HDC forced idle on this logi= cal + processor. See Section 14.5.4.1. If CPUID.06H:EAX.[13] =3D 1. + + @param ECX MSR_IA32_THREAD_STALL (0x00000DB2) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_THREAD_STALL); + @endcode + @note MSR_IA32_THREAD_STALL is defined as IA32_THREAD_STALL in SDM. +**/ +#define MSR_IA32_THREAD_STALL 0x00000DB2 + + +/** + Extended Feature Enables. If ( CPUID.80000001H:EDX.[2 0] + CPUID.80000001H:EDX.[2 9]). + + @param ECX MSR_IA32_EFER (0xC0000080) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_EFER_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_EFER_REGISTER. + + Example usage + @code + MSR_IA32_EFER_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_EFER); + AsmWriteMsr64 (MSR_IA32_EFER, Msr.Uint64); + @endcode + @note MSR_IA32_EFER is defined as IA32_EFER in SDM. +**/ +#define MSR_IA32_EFER 0xC0000080 + +/** + MSR information returned for MSR index #MSR_IA32_EFER +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bit 0] SYSCALL Enable: IA32_EFER.SCE (R/W) Enables SYSCALL/SYSRET + /// instructions in 64-bit mode. + /// + UINT32 SCE:1; + UINT32 Reserved1:7; + /// + /// [Bit 8] IA-32e Mode Enable: IA32_EFER.LME (R/W) Enables IA-32e mode + /// operation. + /// + UINT32 LME:1; + UINT32 Reserved2:1; + /// + /// [Bit 10] IA-32e Mode Active: IA32_EFER.LMA (R) Indicates IA-32e mo= de + /// is active when set. + /// + UINT32 LMA:1; + /// + /// [Bit 11] Execute Disable Bit Enable: IA32_EFER.NXE (R/W). + /// + UINT32 NXE:1; + UINT32 Reserved3:20; + UINT32 Reserved4:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_EFER_REGISTER; + + +/** + System Call Target Address (R/W). If CPUID.80000001:EDX.[29] =3D 1. + + @param ECX MSR_IA32_STAR (0xC0000081) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_STAR); + AsmWriteMsr64 (MSR_IA32_STAR, Msr); + @endcode + @note MSR_IA32_STAR is defined as IA32_STAR in SDM. +**/ +#define MSR_IA32_STAR 0xC0000081 + + +/** + IA-32e Mode System Call Target Address (R/W). If CPUID.80000001:EDX.[29]= =3D 1. + + @param ECX MSR_IA32_LSTAR (0xC0000082) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_LSTAR); + AsmWriteMsr64 (MSR_IA32_LSTAR, Msr); + @endcode + @note MSR_IA32_LSTAR is defined as IA32_LSTAR in SDM. +**/ +#define MSR_IA32_LSTAR 0xC0000082 + +/** + IA-32e Mode System Call Target Address (R/W) Not used, as the SYSCALL + instruction is not recognized in compatibility mode. If + CPUID.80000001:EDX.[29] =3D 1. + + @param ECX MSR_IA32_CSTAR (0xC0000083) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_CSTAR); + AsmWriteMsr64 (MSR_IA32_CSTAR, Msr); + @endcode + @note MSR_IA32_CSTAR is defined as IA32_CSTAR in SDM. +**/ +#define MSR_IA32_CSTAR 0xC0000083 + +/** + System Call Flag Mask (R/W). If CPUID.80000001:EDX.[29] =3D 1. + + @param ECX MSR_IA32_FMASK (0xC0000084) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_FMASK); + AsmWriteMsr64 (MSR_IA32_FMASK, Msr); + @endcode + @note MSR_IA32_FMASK is defined as IA32_FMASK in SDM. +**/ +#define MSR_IA32_FMASK 0xC0000084 + + +/** + Map of BASE Address of FS (R/W). If CPUID.80000001:EDX.[29] =3D 1. + + @param ECX MSR_IA32_FS_BASE (0xC0000100) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_FS_BASE); + AsmWriteMsr64 (MSR_IA32_FS_BASE, Msr); + @endcode + @note MSR_IA32_FS_BASE is defined as IA32_FS_BASE in SDM. +**/ +#define MSR_IA32_FS_BASE 0xC0000100 + + +/** + Map of BASE Address of GS (R/W). If CPUID.80000001:EDX.[29] =3D 1. + + @param ECX MSR_IA32_GS_BASE (0xC0000101) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_GS_BASE); + AsmWriteMsr64 (MSR_IA32_GS_BASE, Msr); + @endcode + @note MSR_IA32_GS_BASE is defined as IA32_GS_BASE in SDM. +**/ +#define MSR_IA32_GS_BASE 0xC0000101 + + +/** + Swap Target of BASE Address of GS (R/W). If CPUID.80000001:EDX.[29] =3D = 1. + + @param ECX MSR_IA32_KERNEL_GS_BASE (0xC0000102) + @param EAX Lower 32-bits of MSR value. + @param EDX Upper 32-bits of MSR value. + + Example usage + @code + UINT64 Msr; + + Msr =3D AsmReadMsr64 (MSR_IA32_KERNEL_GS_BASE); + AsmWriteMsr64 (MSR_IA32_KERNEL_GS_BASE, Msr); + @endcode + @note MSR_IA32_KERNEL_GS_BASE is defined as IA32_KERNEL_GS_BASE in SDM. +**/ +#define MSR_IA32_KERNEL_GS_BASE 0xC0000102 + + +/** + Auxiliary TSC (RW). If CPUID.80000001H: EDX[27] =3D 1. + + @param ECX MSR_IA32_TSC_AUX (0xC0000103) + @param EAX Lower 32-bits of MSR value. + Described by the type MSR_IA32_TSC_AUX_REGISTER. + @param EDX Upper 32-bits of MSR value. + Described by the type MSR_IA32_TSC_AUX_REGISTER. + + Example usage + @code + MSR_IA32_TSC_AUX_REGISTER Msr; + + Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_TSC_AUX); + AsmWriteMsr64 (MSR_IA32_TSC_AUX, Msr.Uint64); + @endcode + @note MSR_IA32_TSC_AUX is defined as IA32_TSC_AUX in SDM. +**/ +#define MSR_IA32_TSC_AUX 0xC0000103 + +/** + MSR information returned for MSR index #MSR_IA32_TSC_AUX +**/ +typedef union { + /// + /// Individual bit fields + /// + struct { + /// + /// [Bits 31:0] AUX: Auxiliary signature of TSC. + /// + UINT32 AUX:32; + UINT32 Reserved:32; + } Bits; + /// + /// All bit fields as a 32-bit value + /// + UINT32 Uint32; + /// + /// All bit fields as a 64-bit value + /// + UINT64 Uint64; +} MSR_IA32_TSC_AUX_REGISTER; + +#endif diff --git a/MdePkg/Include/Register/Intel/LocalApic.h b/MdePkg/Include/Reg= ister/Intel/LocalApic.h new file mode 100644 index 0000000000..35625cff70 --- /dev/null +++ b/MdePkg/Include/Register/Intel/LocalApic.h @@ -0,0 +1,183 @@ +/** @file + IA32 Local APIC Definitions. + + Copyright (c) 2010 - 2019, Intel Corporation. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent + +**/ + +#ifndef __INTEL_LOCAL_APIC_H__ +#define __INTEL_LOCAL_APIC_H__ + +// +// Definition for Local APIC registers and related values +// +#define XAPIC_ID_OFFSET 0x20 +#define XAPIC_VERSION_OFFSET 0x30 +#define XAPIC_EOI_OFFSET 0x0b0 +#define XAPIC_ICR_DFR_OFFSET 0x0e0 +#define XAPIC_SPURIOUS_VECTOR_OFFSET 0x0f0 +#define XAPIC_ICR_LOW_OFFSET 0x300 +#define XAPIC_ICR_HIGH_OFFSET 0x310 +#define XAPIC_LVT_TIMER_OFFSET 0x320 +#define XAPIC_LVT_LINT0_OFFSET 0x350 +#define XAPIC_LVT_LINT1_OFFSET 0x360 +#define XAPIC_TIMER_INIT_COUNT_OFFSET 0x380 +#define XAPIC_TIMER_CURRENT_COUNT_OFFSET 0x390 +#define XAPIC_TIMER_DIVIDE_CONFIGURATION_OFFSET 0x3E0 + +#define X2APIC_MSR_BASE_ADDRESS 0x800 +#define X2APIC_MSR_ICR_ADDRESS 0x830 + +#define LOCAL_APIC_DELIVERY_MODE_FIXED 0 +#define LOCAL_APIC_DELIVERY_MODE_LOWEST_PRIORITY 1 +#define LOCAL_APIC_DELIVERY_MODE_SMI 2 +#define LOCAL_APIC_DELIVERY_MODE_NMI 4 +#define LOCAL_APIC_DELIVERY_MODE_INIT 5 +#define LOCAL_APIC_DELIVERY_MODE_STARTUP 6 +#define LOCAL_APIC_DELIVERY_MODE_EXTINT 7 + +#define LOCAL_APIC_DESTINATION_SHORTHAND_NO_SHORTHAND 0 +#define LOCAL_APIC_DESTINATION_SHORTHAND_SELF 1 +#define LOCAL_APIC_DESTINATION_SHORTHAND_ALL_INCLUDING_SELF 2 +#define LOCAL_APIC_DESTINATION_SHORTHAND_ALL_EXCLUDING_SELF 3 + +// +// Local APIC Version Register. +// +typedef union { + struct { + UINT32 Version:8; ///< The version numbers of the lo= cal APIC. + UINT32 Reserved0:8; ///< Reserved. + UINT32 MaxLvtEntry:8; ///< Number of LVT entries minus 1. + UINT32 EoiBroadcastSuppression:1; ///< 1 if EOI-broadcast suppressio= n supported. + UINT32 Reserved1:7; ///< Reserved. + } Bits; + UINT32 Uint32; +} LOCAL_APIC_VERSION; + +// +// Low half of Interrupt Command Register (ICR). +// +typedef union { + struct { + UINT32 Vector:8; ///< The vector number of the interru= pt being sent. + UINT32 DeliveryMode:3; ///< Specifies the type of IPI to be = sent. + UINT32 DestinationMode:1; ///< 0: physical destination mode, 1:= logical destination mode. + UINT32 DeliveryStatus:1; ///< Indicates the IPI delivery statu= s. This field is reserved in x2APIC mode. + UINT32 Reserved0:1; ///< Reserved. + UINT32 Level:1; ///< 0 for the INIT level de-assert d= elivery mode. Otherwise 1. + UINT32 TriggerMode:1; ///< 0: edge, 1: level when using the= INIT level de-assert delivery mode. + UINT32 Reserved1:2; ///< Reserved. + UINT32 DestinationShorthand:2; ///< A shorthand notation to specify = the destination of the interrupt. + UINT32 Reserved2:12; ///< Reserved. + } Bits; + UINT32 Uint32; +} LOCAL_APIC_ICR_LOW; + +// +// High half of Interrupt Command Register (ICR) +// +typedef union { + struct { + UINT32 Reserved0:24; ///< Reserved. + UINT32 Destination:8; ///< Specifies the target processor or process= ors in xAPIC mode. + } Bits; + UINT32 Uint32; ///< Destination field expanded to 32-bit in x= 2APIC mode. +} LOCAL_APIC_ICR_HIGH; + +// +// Spurious-Interrupt Vector Register (SVR) +// +typedef union { + struct { + UINT32 SpuriousVector:8; ///< Spurious Vector. + UINT32 SoftwareEnable:1; ///< APIC Software Enable/Disable. + UINT32 FocusProcessorChecking:1; ///< Focus Processor Checking. + UINT32 Reserved0:2; ///< Reserved. + UINT32 EoiBroadcastSuppression:1; ///< EOI-Broadcast Suppression. + UINT32 Reserved1:19; ///< Reserved. + } Bits; + UINT32 Uint32; +} LOCAL_APIC_SVR; + +// +// Divide Configuration Register (DCR) +// +typedef union { + struct { + UINT32 DivideValue1:2; ///< Low 2 bits of the divide value. + UINT32 Reserved0:1; ///< Always 0. + UINT32 DivideValue2:1; ///< Highest 1 bit of the divide value. + UINT32 Reserved1:28; ///< Reserved. + } Bits; + UINT32 Uint32; +} LOCAL_APIC_DCR; + +// +// LVT Timer Register +// +typedef union { + struct { + UINT32 Vector:8; ///< The vector number of the interrupt bei= ng sent. + UINT32 Reserved0:4; ///< Reserved. + UINT32 DeliveryStatus:1; ///< 0: Idle, 1: send pending. + UINT32 Reserved1:3; ///< Reserved. + UINT32 Mask:1; ///< 0: Not masked, 1: Masked. + UINT32 TimerMode:1; ///< 0: One-shot, 1: Periodic. + UINT32 Reserved2:14; ///< Reserved. + } Bits; + UINT32 Uint32; +} LOCAL_APIC_LVT_TIMER; + +// +// LVT LINT0/LINT1 Register +// +typedef union { + struct { + UINT32 Vector:8; ///< The vector number of the interrupt b= eing sent. + UINT32 DeliveryMode:3; ///< Specifies the type of interrupt to b= e sent. + UINT32 Reserved0:1; ///< Reserved. + UINT32 DeliveryStatus:1; ///< 0: Idle, 1: send pending. + UINT32 InputPinPolarity:1; ///< Interrupt Input Pin Polarity. + UINT32 RemoteIrr:1; ///< RO. Set when the local APIC accepts = the interrupt and reset when an EOI is received. + UINT32 TriggerMode:1; ///< 0:edge, 1:level. + UINT32 Mask:1; ///< 0: Not masked, 1: Masked. + UINT32 Reserved1:15; ///< Reserved. + } Bits; + UINT32 Uint32; +} LOCAL_APIC_LVT_LINT; + +// +// MSI Address Register +// +typedef union { + struct { + UINT32 Reserved0:2; ///< Reserved + UINT32 DestinationMode:1; ///< Specifies the Destination Mode. + UINT32 RedirectionHint:1; ///< Specifies the Redirection Hint. + UINT32 Reserved1:8; ///< Reserved. + UINT32 DestinationId:8; ///< Specifies the Destination ID. + UINT32 BaseAddress:12; ///< Must be 0FEEH + } Bits; + UINT32 Uint32; +} LOCAL_APIC_MSI_ADDRESS; + +// +// MSI Address Register +// +typedef union { + struct { + UINT32 Vector:8; ///< Interrupt vector in range 010h..0FEH + UINT32 DeliveryMode:3; ///< Specifies the type of interrupt to b= e sent. + UINT32 Reserved0:3; ///< Reserved. + UINT32 Level:1; ///< 0:Deassert, 1:Assert. Ignored for E= dge triggered interrupts. + UINT32 TriggerMode:1; ///< 0:Edge, 1:Level. + UINT32 Reserved1:16; ///< Reserved. + UINT32 Reserved2:32; ///< Reserved. + } Bits; + UINT64 Uint64; +} LOCAL_APIC_MSI_DATA; + +#endif + diff --git a/MdePkg/Include/Register/Intel/Microcode.h b/MdePkg/Include/Reg= ister/Intel/Microcode.h new file mode 100644 index 0000000000..93fa3d6d53 --- /dev/null +++ b/MdePkg/Include/Register/Intel/Microcode.h @@ -0,0 +1,194 @@ +/** @file + Microcode Definitions. + + Microcode Definitions based on contents of the + Intel(R) 64 and IA-32 Architectures Software Developer's Manual + Volume 3A, Section 9.11 Microcode Definitions + + Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent + + @par Specification Reference: + Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume = 3A, + June 2016, Chapter 9 Processor Management and Initialization, Section 9-= 11. + +**/ + +#ifndef __INTEL_MICROCODE_H__ +#define __INTEL_MICROCODE_H__ + +/// +/// CPU Microcode Date in BCD format +/// +typedef union { + struct { + UINT32 Year:16; + UINT32 Day:8; + UINT32 Month:8; + } Bits; + UINT32 Uint32; +} CPU_MICROCODE_DATE; + +/// +/// CPU Microcode Processor Signature format +/// +typedef union { + struct { + UINT32 Stepping:4; + UINT32 Model:4; + UINT32 Family:4; + UINT32 Type:2; + UINT32 Reserved1:2; + UINT32 ExtendedModel:4; + UINT32 ExtendedFamily:8; + UINT32 Reserved2:4; + } Bits; + UINT32 Uint32; +} CPU_MICROCODE_PROCESSOR_SIGNATURE; + +#pragma pack (1) + +/// +/// Microcode Update Format definition +/// +typedef struct { + /// + /// Version number of the update header + /// + UINT32 HeaderVersion; + /// + /// Unique version number for the update, the basis for the update + /// signature provided by the processor to indicate the current update + /// functioning within the processor. Used by the BIOS to authenticate + /// the update and verify that the processor loads successfully. The + /// value in this field cannot be used for processor stepping identifica= tion + /// alone. This is a signed 32-bit number. + /// + UINT32 UpdateRevision; + /// + /// Date of the update creation in binary format: mmddyyyy (e.g. + /// 07/18/98 is 07181998H). + /// + CPU_MICROCODE_DATE Date; + /// + /// Extended family, extended model, type, family, model, and stepping + /// of processor that requires this particular update revision (e.g., + /// 00000650H). Each microcode update is designed specifically for a + /// given extended family, extended model, type, family, model, and + /// stepping of the processor. + /// The BIOS uses the processor signature field in conjunction with the + /// CPUID instruction to determine whether or not an update is + /// appropriate to load on a processor. The information encoded within + /// this field exactly corresponds to the bit representations returned by + /// the CPUID instruction. + /// + CPU_MICROCODE_PROCESSOR_SIGNATURE ProcessorSignature; + /// + /// Checksum of Update Data and Header. Used to verify the integrity of + /// the update header and data. Checksum is correct when the + /// summation of all the DWORDs (including the extended Processor + /// Signature Table) that comprise the microcode update result in + /// 00000000H. + /// + UINT32 Checksum; + /// + /// Version number of the loader program needed to correctly load this + /// update. The initial version is 00000001H + /// + UINT32 LoaderRevision; + /// + /// Platform type information is encoded in the lower 8 bits of this 4- + /// byte field. Each bit represents a particular platform type for a giv= en + /// CPUID. The BIOS uses the processor flags field in conjunction with + /// the platform Id bits in MSR (17H) to determine whether or not an + /// update is appropriate to load on a processor. Multiple bits may be s= et + /// representing support for multiple platform IDs. + /// + UINT32 ProcessorFlags; + /// + /// Specifies the size of the encrypted data in bytes, and must be a + /// multiple of DWORDs. If this value is 00000000H, then the microcode + /// update encrypted data is 2000 bytes (or 500 DWORDs). + /// + UINT32 DataSize; + /// + /// Specifies the total size of the microcode update in bytes. It is the + /// summation of the header size, the encrypted data size and the size of + /// the optional extended signature table. This value is always a multip= le + /// of 1024. + /// + UINT32 TotalSize; + /// + /// Reserved fields for future expansion. + /// + UINT8 Reserved[12]; +} CPU_MICROCODE_HEADER; + +/// +/// Extended Signature Table Header Field Definitions +/// +typedef struct { + /// + /// Specifies the number of extended signature structures (Processor + /// Signature[n], processor flags[n] and checksum[n]) that exist in this + /// microcode update + /// + UINT32 ExtendedSignatureCount; + /// + /// Checksum of update extended processor signature table. Used to + /// verify the integrity of the extended processor signature table. + /// Checksum is correct when the summation of the DWORDs that + /// comprise the extended processor signature table results in + /// 00000000H. + /// + UINT32 ExtendedChecksum; + /// + /// Reserved fields. + /// + UINT8 Reserved[12]; +} CPU_MICROCODE_EXTENDED_TABLE_HEADER; + +/// +/// Extended Signature Table Field Definitions +/// +typedef struct { + /// + /// Extended family, extended model, type, family, model, and stepping + /// of processor that requires this particular update revision (e.g., + /// 00000650H). Each microcode update is designed specifically for a + /// given extended family, extended model, type, family, model, and + /// stepping of the processor. + /// The BIOS uses the processor signature field in conjunction with the + /// CPUID instruction to determine whether or not an update is + /// appropriate to load on a processor. The information encoded within + /// this field exactly corresponds to the bit representations returned by + /// the CPUID instruction. + /// + CPU_MICROCODE_PROCESSOR_SIGNATURE ProcessorSignature; + /// + /// Platform type information is encoded in the lower 8 bits of this 4- + /// byte field. Each bit represents a particular platform type for a giv= en + /// CPUID. The BIOS uses the processor flags field in conjunction with + /// the platform Id bits in MSR (17H) to determine whether or not an + /// update is appropriate to load on a processor. Multiple bits may be s= et + /// representing support for multiple platform IDs. + /// + UINT32 ProcessorFlag; + /// + /// Used by utility software to decompose a microcode update into + /// multiple microcode updates where each of the new updates is + /// constructed without the optional Extended Processor Signature + /// Table. + /// To calculate the Checksum, substitute the Primary Processor + /// Signature entry and the Processor Flags entry with the + /// corresponding Extended Patch entry. Delete the Extended Processor + /// Signature Table entries. The Checksum is correct when the + /// summation of all DWORDs that comprise the created Extended + /// Processor Patch results in 00000000H. + /// + UINT32 Checksum; +} CPU_MICROCODE_EXTENDED_TABLE; + +#pragma pack () + +#endif diff --git a/MdePkg/Include/Register/Intel/Msr.h b/MdePkg/Include/Register/= Intel/Msr.h new file mode 100644 index 0000000000..0857d8bffd --- /dev/null +++ b/MdePkg/Include/Register/Intel/Msr.h @@ -0,0 +1,44 @@ +/** @file + MSR Definitions. + + Provides defines for Machine Specific Registers(MSR) indexes. Data struc= tures + are provided for MSRs that contain one or more bit fields. If the MSR v= alue + returned is a single 32-bit or 64-bit value, then a data structure is not + provided for that MSR. + + Copyright (c) 2016 ~ 2019, Intel Corporation. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent + + @par Specification Reference: + Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume = 4, + May 2018, Volume 4: Model-Specific-Registers (MSR) + +**/ + +#ifndef __INTEL_MSR_H__ +#define __INTEL_MSR_H__ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#endif diff --git a/UefiCpuPkg/Include/Register/Msr/AtomMsr.h b/MdePkg/Include/Reg= ister/Intel/Msr/AtomMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/AtomMsr.h rename to MdePkg/Include/Register/Intel/Msr/AtomMsr.h index 802efe54a6..c174df1535 100644 --- a/UefiCpuPkg/Include/Register/Msr/AtomMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/AtomMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __ATOM_MSR_H__ #define __ATOM_MSR_H__ =20 -#include +#include =20 /** Is Intel(R) Atom(TM) Processor Family? diff --git a/UefiCpuPkg/Include/Register/Msr/BroadwellMsr.h b/MdePkg/Includ= e/Register/Intel/Msr/BroadwellMsr.h similarity index 95% rename from UefiCpuPkg/Include/Register/Msr/BroadwellMsr.h rename to MdePkg/Include/Register/Intel/Msr/BroadwellMsr.h index e9d39d99c4..d05869e037 100644 --- a/UefiCpuPkg/Include/Register/Msr/BroadwellMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/BroadwellMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __BROADWELL_MSR_H__ #define __BROADWELL_MSR_H__ =20 -#include +#include =20 /** Is Intel processors based on the Broadwell microarchitecture? diff --git a/UefiCpuPkg/Include/Register/Msr/Core2Msr.h b/MdePkg/Include/Re= gister/Intel/Msr/Core2Msr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/Core2Msr.h rename to MdePkg/Include/Register/Intel/Msr/Core2Msr.h index a5d66261ec..e9d999cdd5 100644 --- a/UefiCpuPkg/Include/Register/Msr/Core2Msr.h +++ b/MdePkg/Include/Register/Intel/Msr/Core2Msr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __CORE2_MSR_H__ #define __CORE2_MSR_H__ =20 -#include +#include =20 /** Is Intel(R) Core(TM) 2 Processor Family? diff --git a/UefiCpuPkg/Include/Register/Msr/CoreMsr.h b/MdePkg/Include/Reg= ister/Intel/Msr/CoreMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/CoreMsr.h rename to MdePkg/Include/Register/Intel/Msr/CoreMsr.h index 5368db83ba..1e43bc13f5 100644 --- a/UefiCpuPkg/Include/Register/Msr/CoreMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/CoreMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __CORE_MSR_H__ #define __CORE_MSR_H__ =20 -#include +#include =20 /** Is Intel Core Solo and Intel Core Duo Processors? diff --git a/UefiCpuPkg/Include/Register/Msr/GoldmontMsr.h b/MdePkg/Include= /Register/Intel/Msr/GoldmontMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/GoldmontMsr.h rename to MdePkg/Include/Register/Intel/Msr/GoldmontMsr.h index a7db0374f8..d44172f29c 100644 --- a/UefiCpuPkg/Include/Register/Msr/GoldmontMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/GoldmontMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __GOLDMONT_MSR_H__ #define __GOLDMONT_MSR_H__ =20 -#include +#include =20 /** Is Intel Atom processors based on the Goldmont microarchitecture? diff --git a/UefiCpuPkg/Include/Register/Msr/GoldmontPlusMsr.h b/MdePkg/Inc= lude/Register/Intel/Msr/GoldmontPlusMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/GoldmontPlusMsr.h rename to MdePkg/Include/Register/Intel/Msr/GoldmontPlusMsr.h index 635f4cae43..2edc1363b7 100644 --- a/UefiCpuPkg/Include/Register/Msr/GoldmontPlusMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/GoldmontPlusMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2018 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __GOLDMONT_PLUS_MSR_H__ #define __GOLDMONT_PLUS_MSR_H__ =20 -#include +#include =20 /** Is Intel Atom processors based on the Goldmont plus microarchitecture? diff --git a/UefiCpuPkg/Include/Register/Msr/HaswellEMsr.h b/MdePkg/Include= /Register/Intel/Msr/HaswellEMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/HaswellEMsr.h rename to MdePkg/Include/Register/Intel/Msr/HaswellEMsr.h index 6cde974b1d..6c8e29d2ac 100644 --- a/UefiCpuPkg/Include/Register/Msr/HaswellEMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/HaswellEMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __HASWELL_E_MSR_H__ #define __HASWELL_E_MSR_H__ =20 -#include +#include =20 /** Is Intel processors based on the Haswell-E microarchitecture? diff --git a/UefiCpuPkg/Include/Register/Msr/HaswellMsr.h b/MdePkg/Include/= Register/Intel/Msr/HaswellMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/HaswellMsr.h rename to MdePkg/Include/Register/Intel/Msr/HaswellMsr.h index 3aec00cab2..704a7079f2 100644 --- a/UefiCpuPkg/Include/Register/Msr/HaswellMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/HaswellMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __HASWELL_MSR_H__ #define __HASWELL_MSR_H__ =20 -#include +#include =20 /** Is Intel processors based on the Haswell microarchitecture? diff --git a/UefiCpuPkg/Include/Register/Msr/IvyBridgeMsr.h b/MdePkg/Includ= e/Register/Intel/Msr/IvyBridgeMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/IvyBridgeMsr.h rename to MdePkg/Include/Register/Intel/Msr/IvyBridgeMsr.h index fc94f91be0..bc8559d519 100644 --- a/UefiCpuPkg/Include/Register/Msr/IvyBridgeMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/IvyBridgeMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __IVY_BRIDGE_MSR_H__ #define __IVY_BRIDGE_MSR_H__ =20 -#include +#include =20 /** Is Intel processors based on the Ivy Bridge microarchitecture? diff --git a/UefiCpuPkg/Include/Register/Msr/NehalemMsr.h b/MdePkg/Include/= Register/Intel/Msr/NehalemMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/NehalemMsr.h rename to MdePkg/Include/Register/Intel/Msr/NehalemMsr.h index ada2084654..a21e8a5e85 100644 --- a/UefiCpuPkg/Include/Register/Msr/NehalemMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/NehalemMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __NEHALEM_MSR_H__ #define __NEHALEM_MSR_H__ =20 -#include +#include =20 /** Is Intel processors based on the Nehalem microarchitecture? diff --git a/UefiCpuPkg/Include/Register/Msr/P6Msr.h b/MdePkg/Include/Regis= ter/Intel/Msr/P6Msr.h similarity index 95% rename from UefiCpuPkg/Include/Register/Msr/P6Msr.h rename to MdePkg/Include/Register/Intel/Msr/P6Msr.h index 020349291a..d4af2774d3 100644 --- a/UefiCpuPkg/Include/Register/Msr/P6Msr.h +++ b/MdePkg/Include/Register/Intel/Msr/P6Msr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __P6_MSR_H__ #define __P6_MSR_H__ =20 -#include +#include =20 /** Is P6 Family Processors? diff --git a/UefiCpuPkg/Include/Register/Msr/Pentium4Msr.h b/MdePkg/Include= /Register/Intel/Msr/Pentium4Msr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/Pentium4Msr.h rename to MdePkg/Include/Register/Intel/Msr/Pentium4Msr.h index 1d66cc2b31..579e4fbd09 100644 --- a/UefiCpuPkg/Include/Register/Msr/Pentium4Msr.h +++ b/MdePkg/Include/Register/Intel/Msr/Pentium4Msr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __PENTIUM_4_MSR_H__ #define __PENTIUM_4_MSR_H__ =20 -#include +#include =20 /** Is Pentium(R) 4 Processors? diff --git a/UefiCpuPkg/Include/Register/Msr/PentiumMMsr.h b/MdePkg/Include= /Register/Intel/Msr/PentiumMMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/PentiumMMsr.h rename to MdePkg/Include/Register/Intel/Msr/PentiumMMsr.h index 869eec1114..4a0e0ba3bd 100644 --- a/UefiCpuPkg/Include/Register/Msr/PentiumMMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/PentiumMMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __PENTIUM_M_MSR_H__ #define __PENTIUM_M_MSR_H__ =20 -#include +#include =20 /** Is Pentium M Processors? diff --git a/UefiCpuPkg/Include/Register/Msr/PentiumMsr.h b/MdePkg/Include/= Register/Intel/Msr/PentiumMsr.h similarity index 93% rename from UefiCpuPkg/Include/Register/Msr/PentiumMsr.h rename to MdePkg/Include/Register/Intel/Msr/PentiumMsr.h index c87212f08f..5907432b7b 100644 --- a/UefiCpuPkg/Include/Register/Msr/PentiumMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/PentiumMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __PENTIUM_MSR_H__ #define __PENTIUM_MSR_H__ =20 -#include +#include =20 /** Is Pentium Processors? diff --git a/UefiCpuPkg/Include/Register/Msr/SandyBridgeMsr.h b/MdePkg/Incl= ude/Register/Intel/Msr/SandyBridgeMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/SandyBridgeMsr.h rename to MdePkg/Include/Register/Intel/Msr/SandyBridgeMsr.h index 0f977e2a2f..7118bf29ff 100644 --- a/UefiCpuPkg/Include/Register/Msr/SandyBridgeMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/SandyBridgeMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __SANDY_BRIDGE_MSR_H__ #define __SANDY_BRIDGE_MSR_H__ =20 -#include +#include =20 /** Is Intel processors based on the Sandy Bridge microarchitecture? diff --git a/UefiCpuPkg/Include/Register/Msr/SilvermontMsr.h b/MdePkg/Inclu= de/Register/Intel/Msr/SilvermontMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/SilvermontMsr.h rename to MdePkg/Include/Register/Intel/Msr/SilvermontMsr.h index fc2a8f6c87..cc0dc03c7c 100644 --- a/UefiCpuPkg/Include/Register/Msr/SilvermontMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/SilvermontMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __SILVERMONT_MSR_H__ #define __SILVERMONT_MSR_H__ =20 -#include +#include =20 /** Is Intel processors based on the Silvermont microarchitecture? diff --git a/UefiCpuPkg/Include/Register/Msr/SkylakeMsr.h b/MdePkg/Include/= Register/Intel/Msr/SkylakeMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/SkylakeMsr.h rename to MdePkg/Include/Register/Intel/Msr/SkylakeMsr.h index 01166e3446..30f96f0e82 100644 --- a/UefiCpuPkg/Include/Register/Msr/SkylakeMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/SkylakeMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __SKYLAKE_MSR_H__ #define __SKYLAKE_MSR_H__ =20 -#include +#include =20 /** Is Intel processors based on the Skylake microarchitecture? diff --git a/UefiCpuPkg/Include/Register/Msr/Xeon5600Msr.h b/MdePkg/Include= /Register/Intel/Msr/Xeon5600Msr.h similarity index 94% rename from UefiCpuPkg/Include/Register/Msr/Xeon5600Msr.h rename to MdePkg/Include/Register/Intel/Msr/Xeon5600Msr.h index c285d1877f..01293ff293 100644 --- a/UefiCpuPkg/Include/Register/Msr/Xeon5600Msr.h +++ b/MdePkg/Include/Register/Intel/Msr/Xeon5600Msr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __XEON_5600_MSR_H__ #define __XEON_5600_MSR_H__ =20 -#include +#include =20 /** Is Intel(R) Xeon(R) Processor Series 5600? diff --git a/UefiCpuPkg/Include/Register/Msr/XeonDMsr.h b/MdePkg/Include/Re= gister/Intel/Msr/XeonDMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/XeonDMsr.h rename to MdePkg/Include/Register/Intel/Msr/XeonDMsr.h index dae11c8e30..f742aeb163 100644 --- a/UefiCpuPkg/Include/Register/Msr/XeonDMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/XeonDMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __XEON_D_MSR_H__ #define __XEON_D_MSR_H__ =20 -#include +#include =20 /** Is Intel(R) Xeon(R) Processor D product Family? diff --git a/UefiCpuPkg/Include/Register/Msr/XeonE7Msr.h b/MdePkg/Include/R= egister/Intel/Msr/XeonE7Msr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/XeonE7Msr.h rename to MdePkg/Include/Register/Intel/Msr/XeonE7Msr.h index 2e9b296d51..6e8c61e19b 100644 --- a/UefiCpuPkg/Include/Register/Msr/XeonE7Msr.h +++ b/MdePkg/Include/Register/Intel/Msr/XeonE7Msr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __XEON_E7_MSR_H__ #define __XEON_E7_MSR_H__ =20 -#include +#include =20 /** Is Intel(R) Xeon(R) Processor E7 Family? diff --git a/UefiCpuPkg/Include/Register/Msr/XeonPhiMsr.h b/MdePkg/Include/= Register/Intel/Msr/XeonPhiMsr.h similarity index 96% rename from UefiCpuPkg/Include/Register/Msr/XeonPhiMsr.h rename to MdePkg/Include/Register/Intel/Msr/XeonPhiMsr.h index 57d71d6a7d..b4dbb52ca5 100644 --- a/UefiCpuPkg/Include/Register/Msr/XeonPhiMsr.h +++ b/MdePkg/Include/Register/Intel/Msr/XeonPhiMsr.h @@ -6,7 +6,7 @@ returned is a single 32-bit or 64-bit value, then a data structure is not provided for that MSR. =20 - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -18,7 +18,7 @@ #ifndef __XEON_PHI_MSR_H__ #define __XEON_PHI_MSR_H__ =20 -#include +#include =20 /** Is Intel(R) Xeon(R) Phi(TM) processor Family? diff --git a/MdePkg/Include/Register/Intel/SmramSaveStateMap.h b/MdePkg/Inc= lude/Register/Intel/SmramSaveStateMap.h new file mode 100644 index 0000000000..81aa6c3c66 --- /dev/null +++ b/MdePkg/Include/Register/Intel/SmramSaveStateMap.h @@ -0,0 +1,184 @@ +/** @file +SMRAM Save State Map Definitions. + +SMRAM Save State Map definitions based on contents of the +Intel(R) 64 and IA-32 Architectures Software Developer's Manual + Volume 3C, Section 34.4 SMRAM + Volume 3C, Section 34.5 SMI Handler Execution Environment + Volume 3C, Section 34.7 Managing Synchronous and Asynchronous SMIs + +Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
+SPDX-License-Identifier: BSD-2-Clause-Patent + +**/ + +#ifndef __INTEL_SMRAM_SAVE_STATE_MAP_H__ +#define __INTEL_SMRAM_SAVE_STATE_MAP_H__ + +/// +/// Default SMBASE address +/// +#define SMM_DEFAULT_SMBASE 0x30000 + +/// +/// Offset of SMM handler from SMBASE +/// +#define SMM_HANDLER_OFFSET 0x8000 + +/// +/// Offset of SMRAM Save State Map from SMBASE +/// +#define SMRAM_SAVE_STATE_MAP_OFFSET 0xfc00 + +#pragma pack (1) + +/// +/// 32-bit SMRAM Save State Map +/// +typedef struct { + UINT8 Reserved[0x200]; // 7c00h + // Padded an extra 0x200 bytes so 32-bit and 6= 4-bit + // SMRAM Save State Maps are the same size + UINT8 Reserved1[0xf8]; // 7e00h + UINT32 SMBASE; // 7ef8h + UINT32 SMMRevId; // 7efch + UINT16 IORestart; // 7f00h + UINT16 AutoHALTRestart; // 7f02h + UINT8 Reserved2[0x9C]; // 7f08h + UINT32 IOMemAddr; // 7fa0h + UINT32 IOMisc; // 7fa4h + UINT32 _ES; // 7fa8h + UINT32 _CS; // 7fach + UINT32 _SS; // 7fb0h + UINT32 _DS; // 7fb4h + UINT32 _FS; // 7fb8h + UINT32 _GS; // 7fbch + UINT32 Reserved3; // 7fc0h + UINT32 _TR; // 7fc4h + UINT32 _DR7; // 7fc8h + UINT32 _DR6; // 7fcch + UINT32 _EAX; // 7fd0h + UINT32 _ECX; // 7fd4h + UINT32 _EDX; // 7fd8h + UINT32 _EBX; // 7fdch + UINT32 _ESP; // 7fe0h + UINT32 _EBP; // 7fe4h + UINT32 _ESI; // 7fe8h + UINT32 _EDI; // 7fech + UINT32 _EIP; // 7ff0h + UINT32 _EFLAGS; // 7ff4h + UINT32 _CR3; // 7ff8h + UINT32 _CR0; // 7ffch +} SMRAM_SAVE_STATE_MAP32; + +/// +/// 64-bit SMRAM Save State Map +/// +typedef struct { + UINT8 Reserved1[0x1d0]; // 7c00h + UINT32 GdtBaseHiDword; // 7dd0h + UINT32 LdtBaseHiDword; // 7dd4h + UINT32 IdtBaseHiDword; // 7dd8h + UINT8 Reserved2[0xc]; // 7ddch + UINT64 IO_EIP; // 7de8h + UINT8 Reserved3[0x50]; // 7df0h + UINT32 _CR4; // 7e40h + UINT8 Reserved4[0x48]; // 7e44h + UINT32 GdtBaseLoDword; // 7e8ch + UINT32 Reserved5; // 7e90h + UINT32 IdtBaseLoDword; // 7e94h + UINT32 Reserved6; // 7e98h + UINT32 LdtBaseLoDword; // 7e9ch + UINT8 Reserved7[0x38]; // 7ea0h + UINT64 EptVmxControl; // 7ed8h + UINT32 EnEptVmxControl; // 7ee0h + UINT8 Reserved8[0x14]; // 7ee4h + UINT32 SMBASE; // 7ef8h + UINT32 SMMRevId; // 7efch + UINT16 IORestart; // 7f00h + UINT16 AutoHALTRestart; // 7f02h + UINT8 Reserved9[0x18]; // 7f04h + UINT64 _R15; // 7f1ch + UINT64 _R14; + UINT64 _R13; + UINT64 _R12; + UINT64 _R11; + UINT64 _R10; + UINT64 _R9; + UINT64 _R8; + UINT64 _RAX; // 7f5ch + UINT64 _RCX; + UINT64 _RDX; + UINT64 _RBX; + UINT64 _RSP; + UINT64 _RBP; + UINT64 _RSI; + UINT64 _RDI; + UINT64 IOMemAddr; // 7f9ch + UINT32 IOMisc; // 7fa4h + UINT32 _ES; // 7fa8h + UINT32 _CS; + UINT32 _SS; + UINT32 _DS; + UINT32 _FS; + UINT32 _GS; + UINT32 _LDTR; // 7fc0h + UINT32 _TR; + UINT64 _DR7; // 7fc8h + UINT64 _DR6; + UINT64 _RIP; // 7fd8h + UINT64 IA32_EFER; // 7fe0h + UINT64 _RFLAGS; // 7fe8h + UINT64 _CR3; // 7ff0h + UINT64 _CR0; // 7ff8h +} SMRAM_SAVE_STATE_MAP64; + +/// +/// Union of 32-bit and 64-bit SMRAM Save State Maps +/// +typedef union { + SMRAM_SAVE_STATE_MAP32 x86; + SMRAM_SAVE_STATE_MAP64 x64; +} SMRAM_SAVE_STATE_MAP; + +/// +/// Minimum SMM Revision ID that supports IOMisc field in SMRAM Save State= Map +/// +#define SMRAM_SAVE_STATE_MIN_REV_ID_IOMISC 0x30004 + +/// +/// SMRAM Save State Map IOMisc I/O Length Values +/// +#define SMM_IO_LENGTH_BYTE 0x01 +#define SMM_IO_LENGTH_WORD 0x02 +#define SMM_IO_LENGTH_DWORD 0x04 + +/// +/// SMRAM Save State Map IOMisc I/O Instruction Type Values +/// +#define SMM_IO_TYPE_IN_IMMEDIATE 0x9 +#define SMM_IO_TYPE_IN_DX 0x1 +#define SMM_IO_TYPE_OUT_IMMEDIATE 0x8 +#define SMM_IO_TYPE_OUT_DX 0x0 +#define SMM_IO_TYPE_INS 0x3 +#define SMM_IO_TYPE_OUTS 0x2 +#define SMM_IO_TYPE_REP_INS 0x7 +#define SMM_IO_TYPE_REP_OUTS 0x6 + +/// +/// SMRAM Save State Map IOMisc structure +/// +typedef union { + struct { + UINT32 SmiFlag:1; + UINT32 Length:3; + UINT32 Type:4; + UINT32 Reserved1:8; + UINT32 Port:16; + } Bits; + UINT32 Uint32; +} SMRAM_SAVE_STATE_IOMISC; + +#pragma pack () + +#endif diff --git a/MdePkg/Include/Register/Intel/StmApi.h b/MdePkg/Include/Regist= er/Intel/StmApi.h new file mode 100644 index 0000000000..63f215ca34 --- /dev/null +++ b/MdePkg/Include/Register/Intel/StmApi.h @@ -0,0 +1,948 @@ +/** @file + STM API definition + + Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent + + @par Specification Reference: + SMI Transfer Monitor (STM) User Guide Revision 1.00 + +**/ + +#ifndef _INTEL_STM_API_H_ +#define _INTEL_STM_API_H_ + +#include +#include +#include + +#pragma pack (1) + +/** + STM Header Structures +**/ + +typedef struct { + UINT32 Intel64ModeSupported :1; ///> bitfield + UINT32 EptSupported :1; ///> bitfield + UINT32 Reserved :30; ///> must be 0 +} STM_FEAT; + +#define STM_SPEC_VERSION_MAJOR 1 +#define STM_SPEC_VERSION_MINOR 0 + +typedef struct { + UINT8 StmSpecVerMajor; + UINT8 StmSpecVerMinor; + /// + /// Must be zero + /// + UINT16 Reserved; + UINT32 StaticImageSize; + UINT32 PerProcDynamicMemorySize; + UINT32 AdditionalDynamicMemorySize; + STM_FEAT StmFeatures; + UINT32 NumberOfRevIDs; + UINT32 StmSmmRevID[1]; + /// + /// The total STM_HEADER should be 4K. + /// +} SOFTWARE_STM_HEADER; + +typedef struct { + MSEG_HEADER HwStmHdr; + SOFTWARE_STM_HEADER SwStmHdr; +} STM_HEADER; + + +/** + VMCALL API Numbers + API number convention: BIOS facing VMCALL interfaces have bit 16 clear +**/ + +/** + StmMapAddressRange enables a SMM guest to create a non-1:1 virtual to + physical mapping of an address range into the SMM guest's virtual + memory space. + + @param EAX #STM_API_MAP_ADDRESS_RANGE (0x00000001) + @param EBX Low 32 bits of physical address of caller allocated + STM_MAP_ADDRESS_RANGE_DESCRIPTOR structure. + @param ECX High 32 bits of physical address of caller allocated + STM_MAP_ADDRESS_RANGE_DESCRIPTOR structure. If Intel64Mode = is + clear (0), ECX must be 0. + + @note All fields of STM_MAP_ADDRESS_RANGE_DESCRIPTOR are inputs only. T= hey + are not modified by StmMapAddressRange. + + @retval CF 0 + No error, EAX set to STM_SUCCESS. + The memory range was mapped as requested. + @retval CF 1 + An error occurred, EAX holds relevant error value. + @retval EAX #ERROR_STM_SECURITY_VIOLATION + The requested mapping contains a protected resource. + @retval EAX #ERROR_STM_CACHE_TYPE_NOT_SUPPORTED + The requested cache type could not be satisfied. + @retval EAX #ERROR_STM_PAGE_NOT_FOUND + Page count must not be zero. + @retval EAX #ERROR_STM_FUNCTION_NOT_SUPPORTED + STM supports EPT and has not implemented StmMapAddressRang= e(). + @retval EAX #ERROR_STM_UNSPECIFIED + An unspecified error occurred. + + @note All other registers unmodified. +**/ +#define STM_API_MAP_ADDRESS_RANGE 0x00000001 + +/** + STM Map Address Range Descriptor for #STM_API_MAP_ADDRESS_RANGE VMCALL +**/ +typedef struct { + UINT64 PhysicalAddress; + UINT64 VirtualAddress; + UINT32 PageCount; + UINT32 PatCacheType; +} STM_MAP_ADDRESS_RANGE_DESCRIPTOR; + +/** + Define values for PatCacheType field of #STM_MAP_ADDRESS_RANGE_DESCRIPTOR + @{ +**/ +#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_ST_UC 0x00 +#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_WC 0x01 +#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_WT 0x04 +#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_WP 0x05 +#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_WB 0x06 +#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_UC 0x07 +#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_FOLLOW_MTRR 0xFFFFFFFF +/// @} + +/** + StmUnmapAddressRange enables a SMM guest to remove mappings from its page + table. + + If TXT_PROCESSOR_SMM_DESCRIPTOR.EptEnabled bit is set by the STM, BIOS c= an + control its own page tables. In this case, the STM implementation may + optionally return ERROR_STM_FUNCTION_NOT_SUPPORTED. + + @param EAX #STM_API_UNMAP_ADDRESS_RANGE (0x00000002) + @param EBX Low 32 bits of virtual address of caller allocated + STM_UNMAP_ADDRESS_RANGE_DESCRIPTOR structure. + @param ECX High 32 bits of virtual address of caller allocated + STM_UNMAP_ADDRESS_RANGE_DESCRIPTOR structure. If Intel64Mod= e is + clear (0), ECX must be zero. + + @retval CF 0 + No error, EAX set to STM_SUCCESS. The memory range was unm= apped + as requested. + @retval CF 1 + An error occurred, EAX holds relevant error value. + @retval EAX #ERROR_STM_FUNCTION_NOT_SUPPORTED + STM supports EPT and has not implemented StmUnmapAddressRa= nge(). + @retval EAX #ERROR_STM_UNSPECIFIED + An unspecified error occurred. + + @note All other registers unmodified. +**/ +#define STM_API_UNMAP_ADDRESS_RANGE 0x00000002 + +/** + STM Unmap Address Range Descriptor for #STM_API_UNMAP_ADDRESS_RANGE VMCA= LL +**/ +typedef struct { + UINT64 VirtualAddress; + UINT32 Length; +} STM_UNMAP_ADDRESS_RANGE_DESCRIPTOR; + + +/** + Since the normal OS environment runs with a different set of page tables= than + the SMM guest, virtual mappings will certainly be different. In order to= do a + guest virtual to host physical translation of an address from the normal= OS + code (EIP for example), it is necessary to walk the page tables governin= g the + OS page mappings. Since the SMM guest has no direct access to the page t= ables, + it must ask the STM to do this page table walk. This is supported via the + StmAddressLookup VMCALL. All OS page table formats need to be supported, + (e.g. PAE, PSE, Intel64, EPT, etc.) + + StmAddressLookup takes a CR3 value and a virtual address from the interr= upted + code as input and returns the corresponding physical address. It also + optionally maps the physical address into the SMM guest's virtual address + space. This new mapping persists ONLY for the duration of the SMI and if + needed in subsequent SMIs it must be remapped. PAT cache types follow the + interrupted environment's page table. + + If EPT is enabled, OS CR3 only provides guest physical address informati= on, + but the SMM guest might also need to know the host physical address. Sin= ce + SMM does not have direct access rights to EPT (it is protected by the ST= M), + SMM can input InterruptedEptp to let STM help to walk through it, and ou= tput + the host physical address. + + @param EAX #STM_API_ADDRESS_LOOKUP (0x00000003) + @param EBX Low 32 bits of virtual address of caller allocated + STM_ADDRESS_LOOKUP_DESCRIPTOR structure. + @param ECX High 32 bits of virtual address of caller allocated + STM_ADDRESS_LOOKUP_DESCRIPTOR structure. If Intel64Mode is + clear (0), ECX must be zero. + + @retval CF 0 + No error, EAX set to STM_SUCCESS. PhysicalAddress contain= s the + host physical address determined by walking the interrupte= d SMM + guest's page tables. SmmGuestVirtualAddress contains the = SMM + guest's virtual mapping of the requested address. + @retval CF 1 + An error occurred, EAX holds relevant error value. + @retval EAX #ERROR_STM_SECURITY_VIOLATION + The requested page was a protected page. + @retval EAX #ERROR_STM_PAGE_NOT_FOUND + The requested virtual address did not exist in the page gi= ven + page table. + @retval EAX #ERROR_STM_BAD_CR3 + The CR3 input was invalid. CR3 values must be from one of = the + interrupted guest, or from the interrupted guest of another + processor. + @retval EAX #ERROR_STM_PHYSICAL_OVER_4G + The resulting physical address is greater than 4G and no v= irtual + address was supplied. The STM could not determine what add= ress + within the SMM guest's virtual address space to do the map= ping. + STM_ADDRESS_LOOKUP_DESCRIPTOR field PhysicalAddress contai= ns the + physical address determined by walking the interrupted + environment's page tables. + @retval EAX #ERROR_STM_VIRTUAL_SPACE_TOO_SMALL + A specific virtual mapping was requested, but + SmmGuestVirtualAddress + Length exceeds 4G and the SMI han= dler + is running in 32 bit mode. + @retval EAX #ERROR_STM_UNSPECIFIED + An unspecified error occurred. + + @note All other registers unmodified. +**/ +#define STM_API_ADDRESS_LOOKUP 0x00000003 + +/** + STM Lookup Address Range Descriptor for #STM_API_ADDRESS_LOOKUP VMCALL +**/ +typedef struct { + UINT64 InterruptedGuestVirtualAddress; + UINT32 Length; + UINT64 InterruptedCr3; + UINT64 InterruptedEptp; + UINT32 MapToSmmGuest:2; + UINT32 InterruptedCr4Pae:1; + UINT32 InterruptedCr4Pse:1; + UINT32 InterruptedIa32eMode:1; + UINT32 Reserved1:27; + UINT32 Reserved2; + UINT64 PhysicalAddress; + UINT64 SmmGuestVirtualAddress; +} STM_ADDRESS_LOOKUP_DESCRIPTOR; + +/** + Define values for the MapToSmmGuest field of #STM_ADDRESS_LOOKUP_DESCRIP= TOR + @{ +**/ +#define STM_ADDRESS_LOOKUP_DESCRIPTOR_DO_NOT_MAP 0 +#define STM_ADDRESS_LOOKUP_DESCRIPTOR_ONE_TO_ONE 1 +#define STM_ADDRESS_LOOKUP_DESCRIPTOR_VIRTUAL_ADDRESS_SPECIFIED 3 +/// @} + + +/** + When returning from a protection exception (see section 6.2), the SMM gu= est + can instruct the STM to take one of two paths. It can either request a v= alue + be logged to the TXT.ERRORCODE register and subsequently reset the machi= ne + (indicating it couldn't resolve the problem), or it can request that the= STM + resume the SMM guest again with the specified register state. + + Unlike other VMCALL interfaces, StmReturnFromProtectionException behaves= more + like a jump or an IRET instruction than a "call". It does not return dir= ectly + to the caller, but indirectly to a different location specified on the + caller's stack (see section 6.2) or not at all. + + If the SMM guest STM protection exception handler itself causes a protec= tion + exception (e.g. a single nested exception), or more than 100 un-nested + exceptions occur within the scope of a single SMI event, the STM must wr= ite + STM_CRASH_PROTECTION_EXCEPTION_FAILURE to the TXT.ERRORCODE register and + assert TXT.CMD.SYS_RESET. The reason for these restrictions is to simpli= fy + the code requirements while still enabling a reasonable debugging capabi= lity. + + @param EAX #STM_API_RETURN_FROM_PROTECTION_EXCEPTION (0x00000004) + @param EBX If 0, resume SMM guest using register state found on except= ion + stack. If in range 0x01..0x0F, EBX contains a BIOS error c= ode + which the STM must record in the TXT.ERRORCODE register and + subsequently reset the system via TXT.CMD.SYS_RESET. The va= lue + of the TXT.ERRORCODE register is calculated as follows: + + TXT.ERRORCODE =3D (EBX & 0x0F) | STM_CRASH_BIOS_PANIC + + Values 0x10..0xFFFFFFFF are reserved, do not use. + +**/ +#define STM_API_RETURN_FROM_PROTECTION_EXCEPTION 0x00000004 + + +/** + VMCALL API Numbers + API number convention: MLE facing VMCALL interfaces have bit 16 set. + + The STM configuration lifecycle is as follows: + 1. SENTER->SINIT->MLE: MLE begins execution with SMI disabled (masked). + 2. MLE invokes #STM_API_INITIALIZE_PROTECTION VMCALL to prepare STM for + setup of initial protection profile. This is done on a single CPU a= nd + has global effect. + 3. MLE invokes #STM_API_PROTECT_RESOURCE VMCALL to define the initial + protection profile. The protection profile is global across all CPU= s. + 4. MLE invokes #STM_API_START VMCALL to enable the STM to begin receiv= ing + SMI events. This must be done on every logical CPU. + 5. MLE may invoke #STM_API_PROTECT_RESOURCE VMCALL or + #STM_API_UNPROTECT_RESOURCE VMCALL during runtime as many times as + necessary. + 6. MLE invokes #STM_API_STOP VMCALL to disable the STM. SMI is again m= asked + following #STM_API_STOP VMCALL. +**/ + +/** + StartStmVmcall() is used to configure an STM that is present in MSEG. SM= Is + should remain disabled from the invocation of GETSEC[SENTER] until they = are + re-enabled by StartStmVMCALL(). When StartStmVMCALL() returns, SMI is + enabled and the STM has been started and is active. Prior to invoking + StartStmVMCALL(), the MLE root should first invoke + InitializeProtectionVMCALL() followed by as many iterations of + ProtectResourceVMCALL() as necessary to establish the initial protection + profile. StartStmVmcall() must be invoked on all processor threads. + + @param EAX #STM_API_START (0x00010001) + @param EDX STM configuration options. These provide the MLE with the + ability to pass configuration parameters to the STM. + + @retval CF 0 + No error, EAX set to STM_SUCCESS. The STM has been configu= red + and is now active and the guarding all requested resources. + @retval CF 1 + An error occurred, EAX holds relevant error value. + @retval EAX #ERROR_STM_ALREADY_STARTED + The STM is already configured and active. STM remains acti= ve and + guarding previously enabled resource list. + @retval EAX #ERROR_STM_WITHOUT_SMX_UNSUPPORTED + The StartStmVMCALL() was invoked from VMX root mode, but o= utside + of SMX. This error code indicates the STM or platform does= not + support the STM outside of SMX. The SMI handler remains ac= tive + and operates in legacy mode. See Appendix C + @retval EAX #ERROR_STM_UNSUPPORTED_MSR_BIT + The CPU doesn't support the MSR bit. The STM is not active. + @retval EAX #ERROR_STM_UNSPECIFIED + An unspecified error occurred. + + @note All other registers unmodified. +**/ +#define STM_API_START (BIT16 | 1) + +/** + Bit values for EDX input parameter to #STM_API_START VMCALL + @{ +**/ +#define STM_CONFIG_SMI_UNBLOCKING_BY_VMX_OFF BIT0 +/// @} + + +/** + The StopStmVMCALL() is invoked by the MLE to teardown an active STM. Thi= s is + normally done as part of a full teardown of the SMX environment when the + system is being shut down. At the time the call is invoked, SMI is enabl= ed + and the STM is active. When the call returns, the STM has been stopped = and + all STM context is discarded and SMI is disabled. + + @param EAX #STM_API_STOP (0x00010002) + + @retval CF 0 + No error, EAX set to STM_SUCCESS. The STM has been stopped= and + is no longer processing SMI events. SMI is blocked. + @retval CF 1 + An error occurred, EAX holds relevant error value. + @retval EAX #ERROR_STM_STOPPED + The STM was not active. + @retval EAX #ERROR_STM_UNSPECIFIED + An unspecified error occurred. + + @note All other registers unmodified. +**/ +#define STM_API_STOP (BIT16 | 2) + + +/** + The ProtectResourceVMCALL() is invoked by the MLE root to request protec= tion + of specific resources. The request is defined by a STM_RESOURCE_LIST, wh= ich + may contain more than one resource descriptor. Each resource descriptor = is + processed separately by the STM. Whether or not protection for any speci= fic + resource is granted is returned by the STM via the ReturnStatus bit in t= he + associated STM_RSC_DESC_HEADER. + + @param EAX #STM_API_PROTECT_RESOURCE (0x00010003) + @param EBX Low 32 bits of physical address of caller allocated + STM_RESOURCE_LIST. Bits 11:0 are ignored and assumed to be = zero, + making the buffer 4K aligned. + @param ECX High 32 bits of physical address of caller allocated + STM_RESOURCE_LIST. + + @note All fields of STM_RESOURCE_LIST are inputs only, except for the + ReturnStatus bit. On input, the ReturnStatus bit must be clear. On + return, the ReturnStatus bit is set for each resource request gra= nted, + and clear for each resource request denied. There are no other fi= elds + modified by ProtectResourceVMCALL(). The STM_RESOURCE_LIST must be + contained entirely within a single 4K page. + + @retval CF 0 + No error, EAX set to STM_SUCCESS. The STM has successfully + merged the entire protection request into the active prote= ction + profile. There is therefore no need to check the ReturnSt= atus + bits in the STM_RESOURCE_LIST. + @retval CF 1 + An error occurred, EAX holds relevant error value. + @retval EAX #ERROR_STM_UNPROTECTABLE_RESOURCE + At least one of the requested resource protections interse= cts a + BIOS required resource. Therefore, the caller must walk th= rough + the STM_RESOURCE_LIST to determine which of the requested + resources was not granted protection. The entire list must= be + traversed since there may be multiple failures. + @retval EAX #ERROR_STM_MALFORMED_RESOURCE_LIST + The resource list could not be parsed correctly, or did not + terminate before crossing a 4K page boundary. The caller m= ust + walk through the STM_RESOURCE_LIST to determine which of t= he + requested resources was not granted protection. The entire= list + must be traversed since there may be multiple failures. + @retval EAX #ERROR_STM_OUT_OF_RESOURCES + The STM has encountered an internal error and cannot compl= ete + the request. + @retval EAX #ERROR_STM_UNSPECIFIED + An unspecified error occurred. + + @note All other registers unmodified. +**/ +#define STM_API_PROTECT_RESOURCE (BIT16 | 3) + + +/** + The UnProtectResourceVMCALL() is invoked by the MLE root to request that= the + STM allow the SMI handler access to the specified resources. + + @param EAX #STM_API_UNPROTECT_RESOURCE (0x00010004) + @param EBX Low 32 bits of physical address of caller allocated + STM_RESOURCE_LIST. Bits 11:0 are ignored and assumed to be = zero, + making the buffer 4K aligned. + @param ECX High 32 bits of physical address of caller allocated + STM_RESOURCE_LIST. + + @note All fields of STM_RESOURCE_LIST are inputs only, except for the + ReturnStatus bit. On input, the ReturnStatus bit must be clear. On + return, the ReturnStatus bit is set for each resource processed. = For + a properly formed STM_RESOURCE_LIST, this should be all resources + listed. There are no other fields modified by + UnProtectResourceVMCALL(). The STM_RESOURCE_LIST must be contained + entirely within a single 4K page. + + @retval CF 0 + No error, EAX set to STM_SUCCESS. The requested resources = are + not being guarded by the STM. + @retval CF 1 + An error occurred, EAX holds relevant error value. + @retval EAX #ERROR_STM_MALFORMED_RESOURCE_LIST + The resource list could not be parsed correctly, or did not + terminate before crossing a 4K page boundary. The caller m= ust + walk through the STM_RESOURCE_LIST to determine which of t= he + requested resources were not able to be unprotected. The e= ntire + list must be traversed since there may be multiple failure= s. + @retval EAX #ERROR_STM_UNSPECIFIED + An unspecified error occurred. + + @note All other registers unmodified. +**/ +#define STM_API_UNPROTECT_RESOURCE (BIT16 | 4) + + +/** + The GetBiosResourcesVMCALL() is invoked by the MLE root to request the l= ist + of BIOS required resources from the STM. + + @param EAX #STM_API_GET_BIOS_RESOURCES (0x00010005) + @param EBX Low 32 bits of physical address of caller allocated destina= tion + buffer. Bits 11:0 are ignored and assumed to be zero, makin= g the + buffer 4K aligned. + @param ECX High 32 bits of physical address of caller allocated destin= ation + buffer. + @param EDX Indicates which page of the BIOS resource list to copy into= the + destination buffer. The first page is indicated by 0, the s= econd + page by 1, etc. + + @retval CF 0 + No error, EAX set to STM_SUCCESS. The destination buffer + contains the BIOS required resources. If the page retrieve= d is + the last page, EDX will be cleared to 0. If there are more= pages + to retrieve, EDX is incremented to the next page index. Ca= lling + software should iterate on GetBiosResourcesVMCALL() until = EDX is + returned cleared to 0. + @retval CF 1 + An error occurred, EAX holds relevant error value. + @retval EAX #ERROR_STM_PAGE_NOT_FOUND + The page index supplied in EDX input was out of range. + @retval EAX #ERROR_STM_UNSPECIFIED + An unspecified error occurred. + @retval EDX Page index of next page to read. A return of EDX=3D0 signi= fies + that the entire list has been read. + @note EDX is both an input and an output register. + + @note All other registers unmodified. +**/ +#define STM_API_GET_BIOS_RESOURCES (BIT16 | 5) + + +/** + The ManageVmcsDatabaseVMCALL() is invoked by the MLE root to add or remo= ve an + MLE guest (including the MLE root) from the list of protected domains. + + @param EAX #STM_API_MANAGE_VMCS_DATABASE (0x00010006) + @param EBX Low 32 bits of physical address of caller allocated + STM_VMCS_DATABASE_REQUEST. Bits 11:0 are ignored and assume= d to + be zero, making the buffer 4K aligned. + @param ECX High 32 bits of physical address of caller allocated + STM_VMCS_DATABASE_REQUEST. + + @note All fields of STM_VMCS_DATABASE_REQUEST are inputs only. They ar= e not + modified by ManageVmcsDatabaseVMCALL(). + + @retval CF 0 + No error, EAX set to STM_SUCCESS. + @retval CF 1 + An error occurred, EAX holds relevant error value. + @retval EAX #ERROR_STM_INVALID_VMCS + Indicates a request to remove a VMCS from the database was= made, + but the referenced VMCS was not found in the database. + @retval EAX #ERROR_STM_VMCS_PRESENT + Indicates a request to add a VMCS to the database was made= , but + the referenced VMCS was already present in the database. + @retval EAX #ERROR_INVALID_PARAMETER + Indicates non-zero reserved field. + @retval EAX #ERROR_STM_UNSPECIFIED + An unspecified error occurred + + @note All other registers unmodified. +**/ +#define STM_API_MANAGE_VMCS_DATABASE (BIT16 | 6) + +/** + STM VMCS Database Request for #STM_API_MANAGE_VMCS_DATABASE VMCALL +**/ +typedef struct { + /// + /// bits 11:0 are reserved and must be 0 + /// + UINT64 VmcsPhysPointer; + UINT32 DomainType :4; + UINT32 XStatePolicy :2; + UINT32 DegradationPolicy :4; + /// + /// Must be 0 + /// + UINT32 Reserved1 :22; + UINT32 AddOrRemove; +} STM_VMCS_DATABASE_REQUEST; + +/** + Values for the DomainType field of #STM_VMCS_DATABASE_REQUEST + @{ +**/ +#define DOMAIN_UNPROTECTED 0 +#define DOMAIN_DISALLOWED_IO_OUT BIT0 +#define DOMAIN_DISALLOWED_IO_IN BIT1 +#define DOMAIN_INTEGRITY BIT2 +#define DOMAIN_CONFIDENTIALITY BIT3 +#define DOMAIN_INTEGRITY_PROT_OUT_IN (DOMAIN_INTEGRITY) +#define DOMAIN_FULLY_PROT_OUT_IN (DOMAIN_CONFIDENTIALITY | DOMAIN_INT= EGRITY) +#define DOMAIN_FULLY_PROT (DOMAIN_FULLY_PROT_OUT_IN | DOMAIN_D= ISALLOWED_IO_IN | DOMAIN_DISALLOWED_IO_OUT) +/// @} + +/** + Values for the XStatePolicy field of #STM_VMCS_DATABASE_REQUEST + @{ +**/ +#define XSTATE_READWRITE 0x00 +#define XSTATE_READONLY 0x01 +#define XSTATE_SCRUB 0x03 +/// @} + +/** + Values for the AddOrRemove field of #STM_VMCS_DATABASE_REQUEST + @{ +**/ +#define STM_VMCS_DATABASE_REQUEST_ADD 1 +#define STM_VMCS_DATABASE_REQUEST_REMOVE 0 +/// @} + + +/** + InitializeProtectionVMCALL() prepares the STM for setup of the initial + protection profile which is subsequently communicated via one or more + invocations of ProtectResourceVMCALL(), prior to invoking StartStmVMCALL= (). + It is only necessary to invoke InitializeProtectionVMCALL() on one proce= ssor + thread. InitializeProtectionVMCALL() does not alter whether SMIs are ma= sked + or unmasked. The STM should return back to the MLE with "Blocking by SMI= " set + to 1 in the GUEST_INTERRUPTIBILITY field for the VMCS the STM created fo= r the + MLE guest. + + @param EAX #STM_API_INITIALIZE_PROTECTION (0x00010007) + + @retval CF 0 + No error, EAX set to STM_SUCCESS, EBX bits set to indicate= STM + capabilities as defined below. The STM has set up an empty + protection profile, except for the resources that it sets = up to + protect itself. The STM must not allow the SMI handler to = map + any pages from the MSEG Base to the top of TSEG. The STM m= ust + also not allow SMI handler access to those MSRs which the = STM + requires for its own protection. + @retval CF 1 + An error occurred, EAX holds relevant error value. + @retval EAX #ERROR_STM_ALREADY_STARTED + The STM is already configured and active. The STM remains = active + and guarding the previously enabled resource list. + @retval EAX #ERROR_STM_UNPROTECTABLE + The STM determines that based on the platform configuratio= n, the + STM is unable to protect itself. For example, the BIOS req= uired + resource list contains memory pages in MSEG. + @retval EAX #ERROR_STM_UNSPECIFIED + An unspecified error occurred. + + @note All other registers unmodified. +**/ +#define STM_API_INITIALIZE_PROTECTION (BIT16 | 7) + +/** + Byte granular support bits returned in EBX from #STM_API_INITIALIZE_PROT= ECTION + @{ +**/ +#define STM_RSC_BGI BIT1 +#define STM_RSC_BGM BIT2 +#define STM_RSC_MSR BIT3 +/// @} + + +/** + The ManageEventLogVMCALL() is invoked by the MLE root to control the log= ging + feature. It consists of several sub-functions to facilitate establishmen= t of + the log itself, configuring what events will be logged, and functions to + start, stop, and clear the log. + + @param EAX #STM_API_MANAGE_EVENT_LOG (0x00010008) + @param EBX Low 32 bits of physical address of caller allocated + STM_EVENT_LOG_MANAGEMENT_REQUEST. Bits 11:0 are ignored and + assumed to be zero, making the buffer 4K aligned. + @param ECX High 32 bits of physical address of caller allocated + STM_EVENT_LOG_MANAGEMENT_REQUEST. + + @retval CF=3D0 + No error, EAX set to STM_SUCCESS. + @retval CF=3D1 + An error occurred, EAX holds relevant error value. See subfunct= ion + descriptions below for details. + + @note All other registers unmodified. +**/ +#define STM_API_MANAGE_EVENT_LOG (BIT16 | 8) + +/// +/// STM Event Log Management Request for #STM_API_MANAGE_EVENT_LOG VMCALL +/// +typedef struct { + UINT32 SubFunctionIndex; + union { + struct { + UINT32 PageCount; + // + // number of elements is PageCount + // + UINT64 Pages[]; + } LogBuffer; + // + // bitmap of EVENT_TYPE + // + UINT32 EventEnableBitmap; + } Data; +} STM_EVENT_LOG_MANAGEMENT_REQUEST; + +/** + Defines values for the SubFunctionIndex field of + #STM_EVENT_LOG_MANAGEMENT_REQUEST + @{ +**/ +#define STM_EVENT_LOG_MANAGEMENT_REQUEST_NEW_LOG 1 +#define STM_EVENT_LOG_MANAGEMENT_REQUEST_CONFIGURE_LOG 2 +#define STM_EVENT_LOG_MANAGEMENT_REQUEST_START_LOG 3 +#define STM_EVENT_LOG_MANAGEMENT_REQUEST_STOP_LOG 4 +#define STM_EVENT_LOG_MANAGEMENT_REQUEST_CLEAR_LOG 5 +#define STM_EVENT_LOG_MANAGEMENT_REQUEST_DELETE_LOG 6 +/// @} + +/** + Log Entry Header +**/ +typedef struct { + UINT32 EventSerialNumber; + UINT16 Type; + UINT16 Lock :1; + UINT16 Valid :1; + UINT16 ReadByMle :1; + UINT16 Wrapped :1; + UINT16 Reserved :12; +} LOG_ENTRY_HEADER; + +/** + Enum values for the Type field of #LOG_ENTRY_HEADER +**/ +typedef enum { + EvtLogStarted, + EvtLogStopped, + EvtLogInvalidParameterDetected, + EvtHandledProtectionException, + /// + /// unhandled protection exceptions result in reset & cannot be logged + /// + EvtBiosAccessToUnclaimedResource, + EvtMleResourceProtectionGranted, + EvtMleResourceProtectionDenied, + EvtMleResourceUnprotect, + EvtMleResourceUnprotectError, + EvtMleDomainTypeDegraded, + /// + /// add more here + /// + EvtMleMax, + /// + /// Not used + /// + EvtInvalid =3D 0xFFFFFFFF, +} EVENT_TYPE; + +typedef struct { + UINT32 Reserved; +} ENTRY_EVT_LOG_STARTED; + +typedef struct { + UINT32 Reserved; +} ENTRY_EVT_LOG_STOPPED; + +typedef struct { + UINT32 VmcallApiNumber; +} ENTRY_EVT_LOG_INVALID_PARAM; + +typedef struct { + STM_RSC Resource; +} ENTRY_EVT_LOG_HANDLED_PROTECTION_EXCEPTION; + +typedef struct { + STM_RSC Resource; +} ENTRY_EVT_BIOS_ACCESS_UNCLAIMED_RSC; + +typedef struct { + STM_RSC Resource; +} ENTRY_EVT_MLE_RSC_PROT_GRANTED; + +typedef struct { + STM_RSC Resource; +} ENTRY_EVT_MLE_RSC_PROT_DENIED; + +typedef struct { + STM_RSC Resource; +} ENTRY_EVT_MLE_RSC_UNPROT; + +typedef struct { + STM_RSC Resource; +} ENTRY_EVT_MLE_RSC_UNPROT_ERROR; + +typedef struct { + UINT64 VmcsPhysPointer; + UINT8 ExpectedDomainType; + UINT8 DegradedDomainType; +} ENTRY_EVT_MLE_DOMAIN_TYPE_DEGRADED; + +typedef union { + ENTRY_EVT_LOG_STARTED Started; + ENTRY_EVT_LOG_STOPPED Stopped; + ENTRY_EVT_LOG_INVALID_PARAM InvalidParam; + ENTRY_EVT_LOG_HANDLED_PROTECTION_EXCEPTION HandledProtectionException; + ENTRY_EVT_BIOS_ACCESS_UNCLAIMED_RSC BiosUnclaimedRsc; + ENTRY_EVT_MLE_RSC_PROT_GRANTED MleRscProtGranted; + ENTRY_EVT_MLE_RSC_PROT_DENIED MleRscProtDenied; + ENTRY_EVT_MLE_RSC_UNPROT MleRscUnprot; + ENTRY_EVT_MLE_RSC_UNPROT_ERROR MleRscUnprotError; + ENTRY_EVT_MLE_DOMAIN_TYPE_DEGRADED MleDomainTypeDegraded; +} LOG_ENTRY_DATA; + +typedef struct { + LOG_ENTRY_HEADER Hdr; + LOG_ENTRY_DATA Data; +} STM_LOG_ENTRY; + +/** + Maximum STM Log Entry Size +**/ +#define STM_LOG_ENTRY_SIZE 256 + + +/** + STM Protection Exception Stack Frame Structures +**/ + +typedef struct { + UINT32 Rdi; + UINT32 Rsi; + UINT32 Rbp; + UINT32 Rdx; + UINT32 Rcx; + UINT32 Rbx; + UINT32 Rax; + UINT32 Cr3; + UINT32 Cr2; + UINT32 Cr0; + UINT32 VmcsExitInstructionInfo; + UINT32 VmcsExitInstructionLength; + UINT64 VmcsExitQualification; + /// + /// An TXT_SMM_PROTECTION_EXCEPTION_TYPE num value + /// + UINT32 ErrorCode; + UINT32 Rip; + UINT32 Cs; + UINT32 Rflags; + UINT32 Rsp; + UINT32 Ss; +} STM_PROTECTION_EXCEPTION_STACK_FRAME_IA32; + +typedef struct { + UINT64 R15; + UINT64 R14; + UINT64 R13; + UINT64 R12; + UINT64 R11; + UINT64 R10; + UINT64 R9; + UINT64 R8; + UINT64 Rdi; + UINT64 Rsi; + UINT64 Rbp; + UINT64 Rdx; + UINT64 Rcx; + UINT64 Rbx; + UINT64 Rax; + UINT64 Cr8; + UINT64 Cr3; + UINT64 Cr2; + UINT64 Cr0; + UINT64 VmcsExitInstructionInfo; + UINT64 VmcsExitInstructionLength; + UINT64 VmcsExitQualification; + /// + /// An TXT_SMM_PROTECTION_EXCEPTION_TYPE num value + /// + UINT64 ErrorCode; + UINT64 Rip; + UINT64 Cs; + UINT64 Rflags; + UINT64 Rsp; + UINT64 Ss; +} STM_PROTECTION_EXCEPTION_STACK_FRAME_X64; + +typedef union { + STM_PROTECTION_EXCEPTION_STACK_FRAME_IA32 *Ia32StackFrame; + STM_PROTECTION_EXCEPTION_STACK_FRAME_X64 *X64StackFrame; +} STM_PROTECTION_EXCEPTION_STACK_FRAME; + +/** + Enum values for the ErrorCode field in + #STM_PROTECTION_EXCEPTION_STACK_FRAME_IA32 and + #STM_PROTECTION_EXCEPTION_STACK_FRAME_X64 +**/ +typedef enum { + TxtSmmPageViolation =3D 1, + TxtSmmMsrViolation, + TxtSmmRegisterViolation, + TxtSmmIoViolation, + TxtSmmPciViolation +} TXT_SMM_PROTECTION_EXCEPTION_TYPE; + +/** + TXT Pocessor SMM Descriptor (PSD) structures +**/ + +typedef struct { + UINT64 SpeRip; + UINT64 SpeRsp; + UINT16 SpeSs; + UINT16 PageViolationException:1; + UINT16 MsrViolationException:1; + UINT16 RegisterViolationException:1; + UINT16 IoViolationException:1; + UINT16 PciViolationException:1; + UINT16 Reserved1:11; + UINT32 Reserved2; +} STM_PROTECTION_EXCEPTION_HANDLER; + +typedef struct { + UINT8 ExecutionDisableOutsideSmrr:1; + UINT8 Intel64Mode:1; + UINT8 Cr4Pae : 1; + UINT8 Cr4Pse : 1; + UINT8 Reserved1 : 4; +} STM_SMM_ENTRY_STATE; + +typedef struct { + UINT8 SmramToVmcsRestoreRequired : 1; ///> BIOS restore hint + UINT8 ReinitializeVmcsRequired : 1; ///> BIOS request + UINT8 Reserved2 : 6; +} STM_SMM_RESUME_STATE; + +typedef struct { + UINT8 DomainType : 4; ///> STM input to BIOS on each SMI + UINT8 XStatePolicy : 2; ///> STM input to BIOS on each SMI + UINT8 EptEnabled : 1; + UINT8 Reserved3 : 1; +} STM_SMM_STATE; + +#define TXT_SMM_PSD_OFFSET 0xfb00 +#define TXT_PROCESSOR_SMM_DESCRIPTOR_SIGNATURE SIGNATURE_64('T', 'X',= 'T', 'P', 'S', 'S', 'I', 'G') +#define TXT_PROCESSOR_SMM_DESCRIPTOR_VERSION_MAJOR 1 +#define TXT_PROCESSOR_SMM_DESCRIPTOR_VERSION_MINOR 0 + +typedef struct { + UINT64 Signature; + UINT16 Size; + UINT8 SmmDescriptorVerMajor; + UINT8 SmmDescriptorVerMinor; + UINT32 LocalApicId; + STM_SMM_ENTRY_STATE SmmEntryState; + STM_SMM_RESUME_STATE SmmResumeState; + STM_SMM_STATE StmSmmState; + UINT8 Reserved4; + UINT16 SmmCs; + UINT16 SmmDs; + UINT16 SmmSs; + UINT16 SmmOtherSegment; + UINT16 SmmTr; + UINT16 Reserved5; + UINT64 SmmCr3; + UINT64 SmmStmSetupRip; + UINT64 SmmStmTeardownRip; + UINT64 SmmSmiHandlerRip; + UINT64 SmmSmiHandlerRsp; + UINT64 SmmGdtPtr; + UINT32 SmmGdtSize; + UINT32 RequiredStmSmmRevId; + STM_PROTECTION_EXCEPTION_HANDLER StmProtectionExceptionHandler; + UINT64 Reserved6; + UINT64 BiosHwResourceRequirementsPtr; + // extend area + UINT64 AcpiRsdp; + UINT8 PhysicalAddressBits; +} TXT_PROCESSOR_SMM_DESCRIPTOR; + +#pragma pack () + +#endif diff --git a/UefiCpuPkg/Include/Register/StmResourceDescriptor.h b/MdePkg/I= nclude/Register/Intel/StmResourceDescriptor.h similarity index 92% rename from UefiCpuPkg/Include/Register/StmResourceDescriptor.h rename to MdePkg/Include/Register/Intel/StmResourceDescriptor.h index ec043c909e..da4c91d0f4 100644 --- a/UefiCpuPkg/Include/Register/StmResourceDescriptor.h +++ b/MdePkg/Include/Register/Intel/StmResourceDescriptor.h @@ -1,7 +1,7 @@ /** @file STM Resource Descriptor =20 - Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.
+ Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -9,8 +9,8 @@ =20 **/ =20 -#ifndef _STM_RESOURCE_DESCRIPTOR_H_ -#define _STM_RESOURCE_DESCRIPTOR_H_ +#ifndef _INTEL_STM_RESOURCE_DESCRIPTOR_H_ +#define _INTEL_STM_RESOURCE_DESCRIPTOR_H_ =20 #pragma pack (1) =20 diff --git a/UefiCpuPkg/Include/Register/StmStatusCode.h b/MdePkg/Include/R= egister/Intel/StmStatusCode.h similarity index 94% rename from UefiCpuPkg/Include/Register/StmStatusCode.h rename to MdePkg/Include/Register/Intel/StmStatusCode.h index 42f95fbda4..2460c12598 100644 --- a/UefiCpuPkg/Include/Register/StmStatusCode.h +++ b/MdePkg/Include/Register/Intel/StmStatusCode.h @@ -1,7 +1,7 @@ /** @file STM Status Codes =20 - Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.
+ Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Specification Reference: @@ -9,8 +9,8 @@ =20 **/ =20 -#ifndef _STM_STATUS_CODE_H_ -#define _STM_STATUS_CODE_H_ +#ifndef _INTEL_STM_STATUS_CODE_H_ +#define _INTEL_STM_STATUS_CODE_H_ =20 /** STM Status Codes diff --git a/UefiCpuPkg/Include/Register/ArchitecturalMsr.h b/UefiCpuPkg/In= clude/Register/ArchitecturalMsr.h index c2bd382000..15f8094a62 100644 --- a/UefiCpuPkg/Include/Register/ArchitecturalMsr.h +++ b/UefiCpuPkg/Include/Register/ArchitecturalMsr.h @@ -1,6572 +1,13 @@ /** @file - Architectural MSR Definitions. + Wrapper header file to include in Md= ePkg. =20 - Provides defines for Machine Specific Registers(MSR) indexes. Data struc= tures - are provided for MSRs that contain one or more bit fields. If the MSR v= alue - returned is a single 32-bit or 64-bit value, then a data structure is not - provided for that MSR. - - Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent - - @par Specification Reference: - Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume = 4, - May 2018, Volume 4: Model-Specific-Registers (MSR) - **/ =20 #ifndef __ARCHITECTURAL_MSR_H__ #define __ARCHITECTURAL_MSR_H__ =20 -/** - See Section 2.22, "MSRs in Pentium Processors.". Pentium Processor (05_0= 1H). - - @param ECX MSR_IA32_P5_MC_ADDR (0x00000000) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_P5_MC_ADDR); - AsmWriteMsr64 (MSR_IA32_P5_MC_ADDR, Msr); - @endcode - @note MSR_IA32_P5_MC_ADDR is defined as IA32_P5_MC_ADDR in SDM. -**/ -#define MSR_IA32_P5_MC_ADDR 0x00000000 - - -/** - See Section 2.22, "MSRs in Pentium Processors.". DF_DM =3D 05_01H. - - @param ECX MSR_IA32_P5_MC_TYPE (0x00000001) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_P5_MC_TYPE); - AsmWriteMsr64 (MSR_IA32_P5_MC_TYPE, Msr); - @endcode - @note MSR_IA32_P5_MC_TYPE is defined as IA32_P5_MC_TYPE in SDM. -**/ -#define MSR_IA32_P5_MC_TYPE 0x00000001 - - -/** - See Section 8.10.5, "Monitor/Mwait Address Range Determination.". Introd= uced - at Display Family / Display Model 0F_03H. - - @param ECX MSR_IA32_MONITOR_FILTER_SIZE (0x00000006) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MONITOR_FILTER_SIZE); - AsmWriteMsr64 (MSR_IA32_MONITOR_FILTER_SIZE, Msr); - @endcode - @note MSR_IA32_MONITOR_FILTER_SIZE is defined as IA32_MONITOR_FILTER_SIZ= E in SDM. -**/ -#define MSR_IA32_MONITOR_FILTER_SIZE 0x00000006 - - -/** - See Section 17.17, "Time-Stamp Counter.". Introduced at Display Family / - Display Model 05_01H. - - @param ECX MSR_IA32_TIME_STAMP_COUNTER (0x00000010) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_TIME_STAMP_COUNTER); - AsmWriteMsr64 (MSR_IA32_TIME_STAMP_COUNTER, Msr); - @endcode - @note MSR_IA32_TIME_STAMP_COUNTER is defined as IA32_TIME_STAMP_COUNTER = in SDM. -**/ -#define MSR_IA32_TIME_STAMP_COUNTER 0x00000010 - - -/** - Platform ID (RO) The operating system can use this MSR to determine "sl= ot" - information for the processor and the proper microcode update to load. - Introduced at Display Family / Display Model 06_01H. - - @param ECX MSR_IA32_PLATFORM_ID (0x00000017) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PLATFORM_ID_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PLATFORM_ID_REGISTER. - - Example usage - @code - MSR_IA32_PLATFORM_ID_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PLATFORM_ID); - @endcode - @note MSR_IA32_PLATFORM_ID is defined as IA32_PLATFORM_ID in SDM. -**/ -#define MSR_IA32_PLATFORM_ID 0x00000017 - -/** - MSR information returned for MSR index #MSR_IA32_PLATFORM_ID -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved1:32; - UINT32 Reserved2:18; - /// - /// [Bits 52:50] Platform Id (RO) Contains information concerning the - /// intended platform for the processor. - /// 52 51 50 - /// -- -- -- - /// 0 0 0 Processor Flag 0. - /// 0 0 1 Processor Flag 1 - /// 0 1 0 Processor Flag 2 - /// 0 1 1 Processor Flag 3 - /// 1 0 0 Processor Flag 4 - /// 1 0 1 Processor Flag 5 - /// 1 1 0 Processor Flag 6 - /// 1 1 1 Processor Flag 7 - /// - UINT32 PlatformId:3; - UINT32 Reserved3:11; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PLATFORM_ID_REGISTER; - - -/** - 06_01H. - - @param ECX MSR_IA32_APIC_BASE (0x0000001B) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_APIC_BASE_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_APIC_BASE_REGISTER. - - Example usage - @code - MSR_IA32_APIC_BASE_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_APIC_BASE); - AsmWriteMsr64 (MSR_IA32_APIC_BASE, Msr.Uint64); - @endcode - @note MSR_IA32_APIC_BASE is defined as IA32_APIC_BASE in SDM. -**/ -#define MSR_IA32_APIC_BASE 0x0000001B - -/** - MSR information returned for MSR index #MSR_IA32_APIC_BASE -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved1:8; - /// - /// [Bit 8] BSP flag (R/W). - /// - UINT32 BSP:1; - UINT32 Reserved2:1; - /// - /// [Bit 10] Enable x2APIC mode. Introduced at Display Family / Display - /// Model 06_1AH. - /// - UINT32 EXTD:1; - /// - /// [Bit 11] APIC Global Enable (R/W). - /// - UINT32 EN:1; - /// - /// [Bits 31:12] APIC Base (R/W). - /// - UINT32 ApicBase:20; - /// - /// [Bits 63:32] APIC Base (R/W). - /// - UINT32 ApicBaseHi:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_APIC_BASE_REGISTER; - - -/** - Control Features in Intel 64 Processor (R/W). If any one enumeration - condition for defined bit field holds. - - @param ECX MSR_IA32_FEATURE_CONTROL (0x0000003A) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_FEATURE_CONTROL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_FEATURE_CONTROL_REGISTER. - - Example usage - @code - MSR_IA32_FEATURE_CONTROL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_FEATURE_CONTROL); - AsmWriteMsr64 (MSR_IA32_FEATURE_CONTROL, Msr.Uint64); - @endcode - @note MSR_IA32_FEATURE_CONTROL is defined as IA32_FEATURE_CONTROL in SDM. -**/ -#define MSR_IA32_FEATURE_CONTROL 0x0000003A - -/** - MSR information returned for MSR index #MSR_IA32_FEATURE_CONTROL -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Lock bit (R/WO): (1 =3D locked). When set, locks this MSR = from - /// being written, writes to this bit will result in GP(0). Note: Once= the - /// Lock bit is set, the contents of this register cannot be modified. - /// Therefore the lock bit must be set after configuring support for I= ntel - /// Virtualization Technology and prior to transferring control to an - /// option ROM or the OS. Hence, once the Lock bit is set, the entire - /// IA32_FEATURE_CONTROL contents are preserved across RESET when PWRG= OOD - /// is not deasserted. If any one enumeration condition for defined bit - /// field position greater than bit 0 holds. - /// - UINT32 Lock:1; - /// - /// [Bit 1] Enable VMX inside SMX operation (R/WL): This bit enables a - /// system executive to use VMX in conjunction with SMX to support - /// Intel(R) Trusted Execution Technology. BIOS must set this bit only - /// when the CPUID function 1 returns VMX feature flag and SMX feature - /// flag set (ECX bits 5 and 6 respectively). If CPUID.01H:ECX[5] =3D = 1 && - /// CPUID.01H:ECX[6] =3D 1. - /// - UINT32 EnableVmxInsideSmx:1; - /// - /// [Bit 2] Enable VMX outside SMX operation (R/WL): This bit enables = VMX - /// for system executive that do not require SMX. BIOS must set this b= it - /// only when the CPUID function 1 returns VMX feature flag set (ECX b= it - /// 5). If CPUID.01H:ECX[5] =3D 1. - /// - UINT32 EnableVmxOutsideSmx:1; - UINT32 Reserved1:5; - /// - /// [Bits 14:8] SENTER Local Function Enables (R/WL): When set, each b= it - /// in the field represents an enable control for a corresponding SENT= ER - /// function. This bit is supported only if CPUID.1:ECX.[bit 6] is set= . If - /// CPUID.01H:ECX[6] =3D 1. - /// - UINT32 SenterLocalFunctionEnables:7; - /// - /// [Bit 15] SENTER Global Enable (R/WL): This bit must be set to enab= le - /// SENTER leaf functions. This bit is supported only if CPUID.1:ECX.[= bit - /// 6] is set. If CPUID.01H:ECX[6] =3D 1. - /// - UINT32 SenterGlobalEnable:1; - UINT32 Reserved2:1; - /// - /// [Bit 17] SGX Launch Control Enable (R/WL): This bit must be set to - /// enable runtime reconfiguration of SGX Launch Control via - /// IA32_SGXLEPUBKEYHASHn MSR. If CPUID.(EAX=3D07H, ECX=3D0H): ECX[30]= =3D 1. - /// - UINT32 SgxLaunchControlEnable:1; - /// - /// [Bit 18] SGX Global Enable (R/WL): This bit must be set to enable = SGX - /// leaf functions. If CPUID.(EAX=3D07H, ECX=3D0H): EBX[2] =3D 1. - /// - UINT32 SgxEnable:1; - UINT32 Reserved3:1; - /// - /// [Bit 20] LMCE On (R/WL): When set, system software can program the - /// MSRs associated with LMCE to configure delivery of some machine ch= eck - /// exceptions to a single logical processor. If IA32_MCG_CAP[27] =3D = 1. - /// - UINT32 LmceOn:1; - UINT32 Reserved4:11; - UINT32 Reserved5:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_FEATURE_CONTROL_REGISTER; - - -/** - Per Logical Processor TSC Adjust (R/Write to clear). If CPUID.(EAX=3D07H, - ECX=3D0H): EBX[1] =3D 1. THREAD_ADJUST: Local offset value of the IA32_= TSC for - a logical processor. Reset value is Zero. A write to IA32_TSC will modify - the local offset in IA32_TSC_ADJUST and the content of IA32_TSC, but does - not affect the internal invariant TSC hardware. - - @param ECX MSR_IA32_TSC_ADJUST (0x0000003B) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_TSC_ADJUST); - AsmWriteMsr64 (MSR_IA32_TSC_ADJUST, Msr); - @endcode - @note MSR_IA32_TSC_ADJUST is defined as IA32_TSC_ADJUST in SDM. -**/ -#define MSR_IA32_TSC_ADJUST 0x0000003B - - -/** - BIOS Update Trigger (W) Executing a WRMSR instruction to this MSR causes= a - microcode update to be loaded into the processor. See Section 9.11.6, - "Microcode Update Loader." A processor may prevent writing to this MSR w= hen - loading guest states on VM entries or saving guest states on VM exits. - Introduced at Display Family / Display Model 06_01H. - - @param ECX MSR_IA32_BIOS_UPDT_TRIG (0x00000079) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D 0; - AsmWriteMsr64 (MSR_IA32_BIOS_UPDT_TRIG, Msr); - @endcode - @note MSR_IA32_BIOS_UPDT_TRIG is defined as IA32_BIOS_UPDT_TRIG in SDM. -**/ -#define MSR_IA32_BIOS_UPDT_TRIG 0x00000079 - - -/** - BIOS Update Signature (RO) Returns the microcode update signature follow= ing - the execution of CPUID.01H. A processor may prevent writing to this MSR = when - loading guest states on VM entries or saving guest states on VM exits. - Introduced at Display Family / Display Model 06_01H. - - @param ECX MSR_IA32_BIOS_SIGN_ID (0x0000008B) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_BIOS_SIGN_ID_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_BIOS_SIGN_ID_REGISTER. - - Example usage - @code - MSR_IA32_BIOS_SIGN_ID_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_BIOS_SIGN_ID); - @endcode - @note MSR_IA32_BIOS_SIGN_ID is defined as IA32_BIOS_SIGN_ID in SDM. -**/ -#define MSR_IA32_BIOS_SIGN_ID 0x0000008B - -/** - MSR information returned for MSR index #MSR_IA32_BIOS_SIGN_ID -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved:32; - /// - /// [Bits 63:32] Microcode update signature. This field contains the - /// signature of the currently loaded microcode update when read follo= wing - /// the execution of the CPUID instruction, function 1. It is required - /// that this register field be pre-loaded with zero prior to executing - /// the CPUID, function 1. If the field remains equal to zero, then th= ere - /// is no microcode update loaded. Another nonzero value will be the - /// signature. - /// - UINT32 MicrocodeUpdateSignature:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_BIOS_SIGN_ID_REGISTER; - - -/** - IA32_SGXLEPUBKEYHASH[(64*n+63):(64*n)] (R/W) Bits (64*n+63):(64*n) of the - SHA256 digest of the SIGSTRUCT.MODULUS for SGX Launch Enclave. On reset,= the - default value is the digest of Intel's signing key. Read permitted If - CPUID.(EAX=3D12H,ECX=3D0H):EAX[0]=3D1, Write permitted if CPUID.(EAX=3D1= 2H,ECX=3D0H): - EAX[0]=3D1 && IA32_FEATURE_CONTROL[17] =3D 1 && IA32_FEATURE_CONTROL[0] = =3D 1. - - @param ECX MSR_IA32_SGXLEPUBKEYHASHn - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_SGXLEPUBKEYHASHn); - AsmWriteMsr64 (MSR_IA32_SGXLEPUBKEYHASHn, Msr); - @endcode - @note MSR_IA32_SGXLEPUBKEYHASH0 is defined as IA32_SGXLEPUBKEYHASH0 in S= DM. - MSR_IA32_SGXLEPUBKEYHASH1 is defined as IA32_SGXLEPUBKEYHASH1 in S= DM. - MSR_IA32_SGXLEPUBKEYHASH2 is defined as IA32_SGXLEPUBKEYHASH2 in S= DM. - MSR_IA32_SGXLEPUBKEYHASH3 is defined as IA32_SGXLEPUBKEYHASH3 in S= DM. - @{ -**/ -#define MSR_IA32_SGXLEPUBKEYHASH0 0x0000008C -#define MSR_IA32_SGXLEPUBKEYHASH1 0x0000008D -#define MSR_IA32_SGXLEPUBKEYHASH2 0x0000008E -#define MSR_IA32_SGXLEPUBKEYHASH3 0x0000008F -/// @} - - -/** - SMM Monitor Configuration (R/W). If CPUID.01H: ECX[5]=3D1 or CPUID.01H: = ECX[6] =3D - 1. - - @param ECX MSR_IA32_SMM_MONITOR_CTL (0x0000009B) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_SMM_MONITOR_CTL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_SMM_MONITOR_CTL_REGISTER. - - Example usage - @code - MSR_IA32_SMM_MONITOR_CTL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_SMM_MONITOR_CTL); - AsmWriteMsr64 (MSR_IA32_SMM_MONITOR_CTL, Msr.Uint64); - @endcode - @note MSR_IA32_SMM_MONITOR_CTL is defined as IA32_SMM_MONITOR_CTL in SDM. -**/ -#define MSR_IA32_SMM_MONITOR_CTL 0x0000009B - -/** - MSR information returned for MSR index #MSR_IA32_SMM_MONITOR_CTL -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Valid (R/W). The STM may be invoked using VMCALL only if = this - /// bit is 1. Because VMCALL is used to activate the dual-monitor trea= tment - /// (see Section 34.15.6), the dual-monitor treatment cannot be activa= ted - /// if the bit is 0. This bit is cleared when the logical processor is - /// reset. - /// - UINT32 Valid:1; - UINT32 Reserved1:1; - /// - /// [Bit 2] Controls SMI unblocking by VMXOFF (see Section 34.14.4). If - /// IA32_VMX_MISC[28]. - /// - UINT32 BlockSmi:1; - UINT32 Reserved2:9; - /// - /// [Bits 31:12] MSEG Base (R/W). - /// - UINT32 MsegBase:20; - UINT32 Reserved3:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_SMM_MONITOR_CTL_REGISTER; - -/** - MSEG header that is located at the physical address specified by the Mse= gBase - field of #MSR_IA32_SMM_MONITOR_CTL_REGISTER. -**/ -typedef struct { - /// - /// Different processors may use different MSEG revision identifiers. Th= ese - /// identifiers enable software to avoid using an MSEG header formatted = for - /// one processor on a processor that uses a different format. Software = can - /// discover the MSEG revision identifier that a processor uses by readi= ng - /// the VMX capability MSR IA32_VMX_MISC. - // - UINT32 MsegHeaderRevision; - /// - /// Bits 31:1 of this field are reserved and must be zero. Bit 0 of the = field - /// is the IA-32e mode SMM feature bit. It indicates whether the logical - /// processor will be in IA-32e mode after the STM is activated. - /// - UINT32 MonitorFeatures; - UINT32 GdtrLimit; - UINT32 GdtrBaseOffset; - UINT32 CsSelector; - UINT32 EipOffset; - UINT32 EspOffset; - UINT32 Cr3Offset; - /// - /// Pad header so total size is 2KB - /// - UINT8 Reserved[SIZE_2KB - 8 * sizeof (UINT32)]; -} MSEG_HEADER; - -/// -/// @{ Define values for the MonitorFeatures field of #MSEG_HEADER -/// -#define STM_FEATURES_IA32E 0x1 -/// -/// @} -/// - -/** - Base address of the logical processor's SMRAM image (RO, SMM only). If - IA32_VMX_MISC[15]. - - @param ECX MSR_IA32_SMBASE (0x0000009E) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_SMBASE); - @endcode - @note MSR_IA32_SMBASE is defined as IA32_SMBASE in SDM. -**/ -#define MSR_IA32_SMBASE 0x0000009E - - -/** - General Performance Counters (R/W). - MSR_IA32_PMCn is supported if CPUID.0AH: EAX[15:8] > n. - - @param ECX MSR_IA32_PMCn - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_PMC0); - AsmWriteMsr64 (MSR_IA32_PMC0, Msr); - @endcode - @note MSR_IA32_PMC0 is defined as IA32_PMC0 in SDM. - MSR_IA32_PMC1 is defined as IA32_PMC1 in SDM. - MSR_IA32_PMC2 is defined as IA32_PMC2 in SDM. - MSR_IA32_PMC3 is defined as IA32_PMC3 in SDM. - MSR_IA32_PMC4 is defined as IA32_PMC4 in SDM. - MSR_IA32_PMC5 is defined as IA32_PMC5 in SDM. - MSR_IA32_PMC6 is defined as IA32_PMC6 in SDM. - MSR_IA32_PMC7 is defined as IA32_PMC7 in SDM. - @{ -**/ -#define MSR_IA32_PMC0 0x000000C1 -#define MSR_IA32_PMC1 0x000000C2 -#define MSR_IA32_PMC2 0x000000C3 -#define MSR_IA32_PMC3 0x000000C4 -#define MSR_IA32_PMC4 0x000000C5 -#define MSR_IA32_PMC5 0x000000C6 -#define MSR_IA32_PMC6 0x000000C7 -#define MSR_IA32_PMC7 0x000000C8 -/// @} - - -/** - TSC Frequency Clock Counter (R/Write to clear). If CPUID.06H: ECX[0] =3D= 1. - C0_MCNT: C0 TSC Frequency Clock Count Increments at fixed interval (rela= tive - to TSC freq.) when the logical processor is in C0. Cleared upon overflow= / - wrap-around of IA32_APERF. - - @param ECX MSR_IA32_MPERF (0x000000E7) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MPERF); - AsmWriteMsr64 (MSR_IA32_MPERF, Msr); - @endcode - @note MSR_IA32_MPERF is defined as IA32_MPERF in SDM. -**/ -#define MSR_IA32_MPERF 0x000000E7 - - -/** - Actual Performance Clock Counter (R/Write to clear). If CPUID.06H: ECX[0= ] =3D - 1. C0_ACNT: C0 Actual Frequency Clock Count Accumulates core clock count= s at - the coordinated clock frequency, when the logical processor is in C0. - Cleared upon overflow / wrap-around of IA32_MPERF. - - @param ECX MSR_IA32_APERF (0x000000E8) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_APERF); - AsmWriteMsr64 (MSR_IA32_APERF, Msr); - @endcode - @note MSR_IA32_APERF is defined as IA32_APERF in SDM. -**/ -#define MSR_IA32_APERF 0x000000E8 - - -/** - MTRR Capability (RO) Section 11.11.2.1, "IA32_MTRR_DEF_TYPE MSR.". - Introduced at Display Family / Display Model 06_01H. - - @param ECX MSR_IA32_MTRRCAP (0x000000FE) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_MTRRCAP_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_MTRRCAP_REGISTER. - - Example usage - @code - MSR_IA32_MTRRCAP_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MTRRCAP); - @endcode - @note MSR_IA32_MTRRCAP is defined as IA32_MTRRCAP in SDM. -**/ -#define MSR_IA32_MTRRCAP 0x000000FE - -/** - MSR information returned for MSR index #MSR_IA32_MTRRCAP -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] VCNT: The number of variable memory type ranges in the - /// processor. - /// - UINT32 VCNT:8; - /// - /// [Bit 8] Fixed range MTRRs are supported when set. - /// - UINT32 FIX:1; - UINT32 Reserved1:1; - /// - /// [Bit 10] WC Supported when set. - /// - UINT32 WC:1; - /// - /// [Bit 11] SMRR Supported when set. - /// - UINT32 SMRR:1; - UINT32 Reserved2:20; - UINT32 Reserved3:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_MTRRCAP_REGISTER; - - -/** - SYSENTER_CS_MSR (R/W). Introduced at Display Family / Display Model 06_0= 1H. - - @param ECX MSR_IA32_SYSENTER_CS (0x00000174) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_SYSENTER_CS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_SYSENTER_CS_REGISTER. - - Example usage - @code - MSR_IA32_SYSENTER_CS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_SYSENTER_CS); - AsmWriteMsr64 (MSR_IA32_SYSENTER_CS, Msr.Uint64); - @endcode - @note MSR_IA32_SYSENTER_CS is defined as IA32_SYSENTER_CS in SDM. -**/ -#define MSR_IA32_SYSENTER_CS 0x00000174 - -/** - MSR information returned for MSR index #MSR_IA32_SYSENTER_CS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] CS Selector. - /// - UINT32 CS:16; - UINT32 Reserved1:16; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_SYSENTER_CS_REGISTER; - - -/** - SYSENTER_ESP_MSR (R/W). Introduced at Display Family / Display Model 06_= 01H. - - @param ECX MSR_IA32_SYSENTER_ESP (0x00000175) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_SYSENTER_ESP); - AsmWriteMsr64 (MSR_IA32_SYSENTER_ESP, Msr); - @endcode - @note MSR_IA32_SYSENTER_ESP is defined as IA32_SYSENTER_ESP in SDM. -**/ -#define MSR_IA32_SYSENTER_ESP 0x00000175 - - -/** - SYSENTER_EIP_MSR (R/W). Introduced at Display Family / Display Model 06_= 01H. - - @param ECX MSR_IA32_SYSENTER_EIP (0x00000176) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_SYSENTER_EIP); - AsmWriteMsr64 (MSR_IA32_SYSENTER_EIP, Msr); - @endcode - @note MSR_IA32_SYSENTER_EIP is defined as IA32_SYSENTER_EIP in SDM. -**/ -#define MSR_IA32_SYSENTER_EIP 0x00000176 - - -/** - Global Machine Check Capability (RO). Introduced at Display Family / Dis= play - Model 06_01H. - - @param ECX MSR_IA32_MCG_CAP (0x00000179) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_MCG_CAP_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_MCG_CAP_REGISTER. - - Example usage - @code - MSR_IA32_MCG_CAP_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MCG_CAP); - @endcode - @note MSR_IA32_MCG_CAP is defined as IA32_MCG_CAP in SDM. -**/ -#define MSR_IA32_MCG_CAP 0x00000179 - -/** - MSR information returned for MSR index #MSR_IA32_MCG_CAP -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Count: Number of reporting banks. - /// - UINT32 Count:8; - /// - /// [Bit 8] MCG_CTL_P: IA32_MCG_CTL is present if this bit is set. - /// - UINT32 MCG_CTL_P:1; - /// - /// [Bit 9] MCG_EXT_P: Extended machine check state registers are pres= ent - /// if this bit is set. - /// - UINT32 MCG_EXT_P:1; - /// - /// [Bit 10] MCP_CMCI_P: Support for corrected MC error event is prese= nt. - /// Introduced at Display Family / Display Model 06_01H. - /// - UINT32 MCP_CMCI_P:1; - /// - /// [Bit 11] MCG_TES_P: Threshold-based error status register are pres= ent - /// if this bit is set. - /// - UINT32 MCG_TES_P:1; - UINT32 Reserved1:4; - /// - /// [Bits 23:16] MCG_EXT_CNT: Number of extended machine check state - /// registers present. - /// - UINT32 MCG_EXT_CNT:8; - /// - /// [Bit 24] MCG_SER_P: The processor supports software error recovery= if - /// this bit is set. - /// - UINT32 MCG_SER_P:1; - UINT32 Reserved2:1; - /// - /// [Bit 26] MCG_ELOG_P: Indicates that the processor allows platform - /// firmware to be invoked when an error is detected so that it may - /// provide additional platform specific information in an ACPI format - /// "Generic Error Data Entry" that augments the data included in mach= ine - /// check bank registers. Introduced at Display Family / Display Model - /// 06_3EH. - /// - UINT32 MCG_ELOG_P:1; - /// - /// [Bit 27] MCG_LMCE_P: Indicates that the processor support extended - /// state in IA32_MCG_STATUS and associated MSR necessary to configure - /// Local Machine Check Exception (LMCE). Introduced at Display Family= / - /// Display Model 06_3EH. - /// - UINT32 MCG_LMCE_P:1; - UINT32 Reserved3:4; - UINT32 Reserved4:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_MCG_CAP_REGISTER; - - -/** - Global Machine Check Status (R/W0). Introduced at Display Family / Displ= ay - Model 06_01H. - - @param ECX MSR_IA32_MCG_STATUS (0x0000017A) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_MCG_STATUS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_MCG_STATUS_REGISTER. - - Example usage - @code - MSR_IA32_MCG_STATUS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MCG_STATUS); - AsmWriteMsr64 (MSR_IA32_MCG_STATUS, Msr.Uint64); - @endcode - @note MSR_IA32_MCG_STATUS is defined as IA32_MCG_STATUS in SDM. -**/ -#define MSR_IA32_MCG_STATUS 0x0000017A - -/** - MSR information returned for MSR index #MSR_IA32_MCG_STATUS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] RIPV. Restart IP valid. Introduced at Display Family / Dis= play - /// Model 06_01H. - /// - UINT32 RIPV:1; - /// - /// [Bit 1] EIPV. Error IP valid. Introduced at Display Family / Displ= ay - /// Model 06_01H. - /// - UINT32 EIPV:1; - /// - /// [Bit 2] MCIP. Machine check in progress. Introduced at Display Fam= ily - /// / Display Model 06_01H. - /// - UINT32 MCIP:1; - /// - /// [Bit 3] LMCE_S. If IA32_MCG_CAP.LMCE_P[2 7] =3D1. - /// - UINT32 LMCE_S:1; - UINT32 Reserved1:28; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_MCG_STATUS_REGISTER; - - -/** - Global Machine Check Control (R/W). If IA32_MCG_CAP.CTL_P[8] =3D1. - - @param ECX MSR_IA32_MCG_CTL (0x0000017B) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MCG_CTL); - AsmWriteMsr64 (MSR_IA32_MCG_CTL, Msr); - @endcode - @note MSR_IA32_MCG_CTL is defined as IA32_MCG_CTL in SDM. -**/ -#define MSR_IA32_MCG_CTL 0x0000017B - - -/** - Performance Event Select Register n (R/W). If CPUID.0AH: EAX[15:8] > n. - - @param ECX MSR_IA32_PERFEVTSELn - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PERFEVTSEL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PERFEVTSEL_REGISTER. - - Example usage - @code - MSR_IA32_PERFEVTSEL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERFEVTSEL0); - AsmWriteMsr64 (MSR_IA32_PERFEVTSEL0, Msr.Uint64); - @endcode - @note MSR_IA32_PERFEVTSEL0 is defined as IA32_PERFEVTSEL0 in SDM. - MSR_IA32_PERFEVTSEL1 is defined as IA32_PERFEVTSEL1 in SDM. - MSR_IA32_PERFEVTSEL2 is defined as IA32_PERFEVTSEL2 in SDM. - MSR_IA32_PERFEVTSEL3 is defined as IA32_PERFEVTSEL3 in SDM. - @{ -**/ -#define MSR_IA32_PERFEVTSEL0 0x00000186 -#define MSR_IA32_PERFEVTSEL1 0x00000187 -#define MSR_IA32_PERFEVTSEL2 0x00000188 -#define MSR_IA32_PERFEVTSEL3 0x00000189 -/// @} - -/** - MSR information returned for MSR indexes #MSR_IA32_PERFEVTSEL0 to - #MSR_IA32_PERFEVTSEL3 -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Event Select: Selects a performance event logic unit. - /// - UINT32 EventSelect:8; - /// - /// [Bits 15:8] UMask: Qualifies the microarchitectural condition to - /// detect on the selected event logic. - /// - UINT32 UMASK:8; - /// - /// [Bit 16] USR: Counts while in privilege level is not ring 0. - /// - UINT32 USR:1; - /// - /// [Bit 17] OS: Counts while in privilege level is ring 0. - /// - UINT32 OS:1; - /// - /// [Bit 18] Edge: Enables edge detection if set. - /// - UINT32 E:1; - /// - /// [Bit 19] PC: enables pin control. - /// - UINT32 PC:1; - /// - /// [Bit 20] INT: enables interrupt on counter overflow. - /// - UINT32 INT:1; - /// - /// [Bit 21] AnyThread: When set to 1, it enables counting the associa= ted - /// event conditions occurring across all logical processors sharing a - /// processor core. When set to 0, the counter only increments the - /// associated event conditions occurring in the logical processor whi= ch - /// programmed the MSR. - /// - UINT32 ANY:1; - /// - /// [Bit 22] EN: enables the corresponding performance counter to comm= ence - /// counting when this bit is set. - /// - UINT32 EN:1; - /// - /// [Bit 23] INV: invert the CMASK. - /// - UINT32 INV:1; - /// - /// [Bits 31:24] CMASK: When CMASK is not zero, the corresponding - /// performance counter increments each cycle if the event count is - /// greater than or equal to the CMASK. - /// - UINT32 CMASK:8; - UINT32 Reserved:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PERFEVTSEL_REGISTER; - - -/** - Current performance state(P-State) operating point (RO). Introduced at - Display Family / Display Model 0F_03H. - - @param ECX MSR_IA32_PERF_STATUS (0x00000198) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PERF_STATUS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PERF_STATUS_REGISTER. - - Example usage - @code - MSR_IA32_PERF_STATUS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_STATUS); - @endcode - @note MSR_IA32_PERF_STATUS is defined as IA32_PERF_STATUS in SDM. -**/ -#define MSR_IA32_PERF_STATUS 0x00000198 - -/** - MSR information returned for MSR index #MSR_IA32_PERF_STATUS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Current performance State Value. - /// - UINT32 State:16; - UINT32 Reserved1:16; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PERF_STATUS_REGISTER; - - -/** - (R/W). Introduced at Display Family / Display Model 0F_03H. - - @param ECX MSR_IA32_PERF_CTL (0x00000199) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PERF_CTL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PERF_CTL_REGISTER. - - Example usage - @code - MSR_IA32_PERF_CTL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_CTL); - AsmWriteMsr64 (MSR_IA32_PERF_CTL, Msr.Uint64); - @endcode - @note MSR_IA32_PERF_CTL is defined as IA32_PERF_CTL in SDM. -**/ -#define MSR_IA32_PERF_CTL 0x00000199 - -/** - MSR information returned for MSR index #MSR_IA32_PERF_CTL -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 15:0] Target performance State Value. - /// - UINT32 TargetState:16; - UINT32 Reserved1:16; - /// - /// [Bit 32] IDA Engage. (R/W) When set to 1: disengages IDA. 06_0FH - /// (Mobile only). - /// - UINT32 IDA:1; - UINT32 Reserved2:31; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PERF_CTL_REGISTER; - - -/** - Clock Modulation Control (R/W) See Section 14.7.3, "Software Controlled - Clock Modulation.". If CPUID.01H:EDX[22] =3D 1. - - @param ECX MSR_IA32_CLOCK_MODULATION (0x0000019A) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_CLOCK_MODULATION_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_CLOCK_MODULATION_REGISTER. - - Example usage - @code - MSR_IA32_CLOCK_MODULATION_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_CLOCK_MODULATION); - AsmWriteMsr64 (MSR_IA32_CLOCK_MODULATION, Msr.Uint64); - @endcode - @note MSR_IA32_CLOCK_MODULATION is defined as IA32_CLOCK_MODULATION in S= DM. -**/ -#define MSR_IA32_CLOCK_MODULATION 0x0000019A - -/** - MSR information returned for MSR index #MSR_IA32_CLOCK_MODULATION -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Extended On-Demand Clock Modulation Duty Cycle:. If - /// CPUID.06H:EAX[5] =3D 1. - /// - UINT32 ExtendedOnDemandClockModulationDutyCycle:1; - /// - /// [Bits 3:1] On-Demand Clock Modulation Duty Cycle: Specific encoded - /// values for target duty cycle modulation. If CPUID.01H:EDX[22] =3D = 1. - /// - UINT32 OnDemandClockModulationDutyCycle:3; - /// - /// [Bit 4] On-Demand Clock Modulation Enable: Set 1 to enable modulat= ion. - /// If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 OnDemandClockModulationEnable:1; - UINT32 Reserved1:27; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_CLOCK_MODULATION_REGISTER; - - -/** - Thermal Interrupt Control (R/W) Enables and disables the generation of an - interrupt on temperature transitions detected with the processor's therm= al - sensors and thermal monitor. See Section 14.7.2, "Thermal Monitor.". - If CPUID.01H:EDX[22] =3D 1 - - @param ECX MSR_IA32_THERM_INTERRUPT (0x0000019B) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_THERM_INTERRUPT_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_THERM_INTERRUPT_REGISTER. - - Example usage - @code - MSR_IA32_THERM_INTERRUPT_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_THERM_INTERRUPT); - AsmWriteMsr64 (MSR_IA32_THERM_INTERRUPT, Msr.Uint64); - @endcode - @note MSR_IA32_THERM_INTERRUPT is defined as IA32_THERM_INTERRUPT in SDM. -**/ -#define MSR_IA32_THERM_INTERRUPT 0x0000019B - -/** - MSR information returned for MSR index #MSR_IA32_THERM_INTERRUPT -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] High-Temperature Interrupt Enable. If CPUID.01H:EDX[22] = =3D 1. - /// - UINT32 HighTempEnable:1; - /// - /// [Bit 1] Low-Temperature Interrupt Enable. If CPUID.01H:EDX[22] =3D= 1. - /// - UINT32 LowTempEnable:1; - /// - /// [Bit 2] PROCHOT# Interrupt Enable. If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 PROCHOT_Enable:1; - /// - /// [Bit 3] FORCEPR# Interrupt Enable. If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 FORCEPR_Enable:1; - /// - /// [Bit 4] Critical Temperature Interrupt Enable. - /// If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 CriticalTempEnable:1; - UINT32 Reserved1:3; - /// - /// [Bits 14:8] Threshold #1 Value. If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 Threshold1:7; - /// - /// [Bit 15] Threshold #1 Interrupt Enable. If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 Threshold1Enable:1; - /// - /// [Bits 22:16] Threshold #2 Value. If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 Threshold2:7; - /// - /// [Bit 23] Threshold #2 Interrupt Enable. If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 Threshold2Enable:1; - /// - /// [Bit 24] Power Limit Notification Enable. If CPUID.06H:EAX[4] =3D = 1. - /// - UINT32 PowerLimitNotificationEnable:1; - UINT32 Reserved2:7; - UINT32 Reserved3:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_THERM_INTERRUPT_REGISTER; - - -/** - Thermal Status Information (RO) Contains status information about the - processor's thermal sensor and automatic thermal monitoring facilities. = See - Section 14.7.2, "Thermal Monitor". If CPUID.01H:EDX[22] =3D 1. - - @param ECX MSR_IA32_THERM_STATUS (0x0000019C) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_THERM_STATUS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_THERM_STATUS_REGISTER. - - Example usage - @code - MSR_IA32_THERM_STATUS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_THERM_STATUS); - @endcode - @note MSR_IA32_THERM_STATUS is defined as IA32_THERM_STATUS in SDM. -**/ -#define MSR_IA32_THERM_STATUS 0x0000019C - -/** - MSR information returned for MSR index #MSR_IA32_THERM_STATUS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Thermal Status (RO):. If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 ThermalStatus:1; - /// - /// [Bit 1] Thermal Status Log (R/W):. If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 ThermalStatusLog:1; - /// - /// [Bit 2] PROCHOT # or FORCEPR# event (RO). If CPUID.01H:EDX[22] =3D= 1. - /// - UINT32 PROCHOT_FORCEPR_Event:1; - /// - /// [Bit 3] PROCHOT # or FORCEPR# log (R/WC0). If CPUID.01H:EDX[22] = =3D 1. - /// - UINT32 PROCHOT_FORCEPR_Log:1; - /// - /// [Bit 4] Critical Temperature Status (RO). If CPUID.01H:EDX[22] =3D= 1. - /// - UINT32 CriticalTempStatus:1; - /// - /// [Bit 5] Critical Temperature Status log (R/WC0). - /// If CPUID.01H:EDX[22] =3D 1. - /// - UINT32 CriticalTempStatusLog:1; - /// - /// [Bit 6] Thermal Threshold #1 Status (RO). If CPUID.01H:ECX[8] =3D = 1. - /// - UINT32 ThermalThreshold1Status:1; - /// - /// [Bit 7] Thermal Threshold #1 log (R/WC0). If CPUID.01H:ECX[8] =3D = 1. - /// - UINT32 ThermalThreshold1Log:1; - /// - /// [Bit 8] Thermal Threshold #2 Status (RO). If CPUID.01H:ECX[8] =3D = 1. - /// - UINT32 ThermalThreshold2Status:1; - /// - /// [Bit 9] Thermal Threshold #2 log (R/WC0). If CPUID.01H:ECX[8] =3D = 1. - /// - UINT32 ThermalThreshold2Log:1; - /// - /// [Bit 10] Power Limitation Status (RO). If CPUID.06H:EAX[4] =3D 1. - /// - UINT32 PowerLimitStatus:1; - /// - /// [Bit 11] Power Limitation log (R/WC0). If CPUID.06H:EAX[4] =3D 1. - /// - UINT32 PowerLimitLog:1; - /// - /// [Bit 12] Current Limit Status (RO). If CPUID.06H:EAX[7] =3D 1. - /// - UINT32 CurrentLimitStatus:1; - /// - /// [Bit 13] Current Limit log (R/WC0). If CPUID.06H:EAX[7] =3D 1. - /// - UINT32 CurrentLimitLog:1; - /// - /// [Bit 14] Cross Domain Limit Status (RO). If CPUID.06H:EAX[7] =3D 1. - /// - UINT32 CrossDomainLimitStatus:1; - /// - /// [Bit 15] Cross Domain Limit log (R/WC0). If CPUID.06H:EAX[7] =3D 1. - /// - UINT32 CrossDomainLimitLog:1; - /// - /// [Bits 22:16] Digital Readout (RO). If CPUID.06H:EAX[0] =3D 1. - /// - UINT32 DigitalReadout:7; - UINT32 Reserved1:4; - /// - /// [Bits 30:27] Resolution in Degrees Celsius (RO). If CPUID.06H:EAX[= 0] =3D - /// 1. - /// - UINT32 ResolutionInDegreesCelsius:4; - /// - /// [Bit 31] Reading Valid (RO). If CPUID.06H:EAX[0] =3D 1. - /// - UINT32 ReadingValid:1; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_THERM_STATUS_REGISTER; - - -/** - Enable Misc. Processor Features (R/W) Allows a variety of processor - functions to be enabled and disabled. - - @param ECX MSR_IA32_MISC_ENABLE (0x000001A0) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_MISC_ENABLE_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_MISC_ENABLE_REGISTER. - - Example usage - @code - MSR_IA32_MISC_ENABLE_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MISC_ENABLE); - AsmWriteMsr64 (MSR_IA32_MISC_ENABLE, Msr.Uint64); - @endcode - @note MSR_IA32_MISC_ENABLE is defined as IA32_MISC_ENABLE in SDM. -**/ -#define MSR_IA32_MISC_ENABLE 0x000001A0 - -/** - MSR information returned for MSR index #MSR_IA32_MISC_ENABLE -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Fast-Strings Enable When set, the fast-strings feature (for - /// REP MOVS and REP STORS) is enabled (default); when clear, fast-str= ings - /// are disabled. Introduced at Display Family / Display Model 0F_0H. - /// - UINT32 FastStrings:1; - UINT32 Reserved1:2; - /// - /// [Bit 3] Automatic Thermal Control Circuit Enable (R/W) 1 =3D Sett= ing - /// this bit enables the thermal control circuit (TCC) portion of the - /// Intel Thermal Monitor feature. This allows the processor to - /// automatically reduce power consumption in response to TCC activati= on. - /// 0 =3D Disabled. Note: In some products clearing this bit might be - /// ignored in critical thermal conditions, and TM1, TM2 and adaptive - /// thermal throttling will still be activated. The default value of t= his - /// field varies with product. See respective tables where default val= ue is - /// listed. Introduced at Display Family / Display Model 0F_0H. - /// - UINT32 AutomaticThermalControlCircuit:1; - UINT32 Reserved2:3; - /// - /// [Bit 7] Performance Monitoring Available (R) 1 =3D Performance - /// monitoring enabled 0 =3D Performance monitoring disabled. Introduc= ed at - /// Display Family / Display Model 0F_0H. - /// - UINT32 PerformanceMonitoring:1; - UINT32 Reserved3:3; - /// - /// [Bit 11] Branch Trace Storage Unavailable (RO) 1 =3D Processor doe= sn't - /// support branch trace storage (BTS) 0 =3D BTS is supported. Introdu= ced at - /// Display Family / Display Model 0F_0H. - /// - UINT32 BTS:1; - /// - /// [Bit 12] Processor Event Based Sampling (PEBS) Unavailable (RO) = 1 =3D - /// PEBS is not supported; 0 =3D PEBS is supported. Introduced at Disp= lay - /// Family / Display Model 06_0FH. - /// - UINT32 PEBS:1; - UINT32 Reserved4:3; - /// - /// [Bit 16] Enhanced Intel SpeedStep Technology Enable (R/W) 0=3D En= hanced - /// Intel SpeedStep Technology disabled 1 =3D Enhanced Intel SpeedStep - /// Technology enabled. If CPUID.01H: ECX[7] =3D1. - /// - UINT32 EIST:1; - UINT32 Reserved5:1; - /// - /// [Bit 18] ENABLE MONITOR FSM (R/W) When this bit is set to 0, the - /// MONITOR feature flag is not set (CPUID.01H:ECX[bit 3] =3D 0). This - /// indicates that MONITOR/MWAIT are not supported. Software attempts = to - /// execute MONITOR/MWAIT will cause #UD when this bit is 0. When this= bit - /// is set to 1 (default), MONITOR/MWAIT are supported (CPUID.01H:ECX[= bit - /// 3] =3D 1). If the SSE3 feature flag ECX[0] is not set (CPUID.01H:E= CX[bit - /// 0] =3D 0), the OS must not attempt to alter this bit. BIOS must le= ave it - /// in the default state. Writing this bit when the SSE3 feature flag = is - /// set to 0 may generate a #GP exception. Introduced at Display Famil= y / - /// Display Model 0F_03H. - /// - UINT32 MONITOR:1; - UINT32 Reserved6:3; - /// - /// [Bit 22] Limit CPUID Maxval (R/W) When this bit is set to 1, CPUID= .00H - /// returns a maximum value in EAX[7:0] of 2. BIOS should contain a se= tup - /// question that allows users to specify when the installed OS does n= ot - /// support CPUID functions greater than 2. Before setting this bit, B= IOS - /// must execute the CPUID.0H and examine the maximum value returned in - /// EAX[7:0]. If the maximum value is greater than 2, this bit is - /// supported. Otherwise, this bit is not supported. Setting this bit = when - /// the maximum value is not greater than 2 may generate a #GP excepti= on. - /// Setting this bit may cause unexpected behavior in software that - /// depends on the availability of CPUID leaves greater than 2. Introd= uced - /// at Display Family / Display Model 0F_03H. - /// - UINT32 LimitCpuidMaxval:1; - /// - /// [Bit 23] xTPR Message Disable (R/W) When set to 1, xTPR messages a= re - /// disabled. xTPR messages are optional messages that allow the proce= ssor - /// to inform the chipset of its priority. if CPUID.01H:ECX[14] =3D 1. - /// - UINT32 xTPR_Message_Disable:1; - UINT32 Reserved7:8; - UINT32 Reserved8:2; - /// - /// [Bit 34] XD Bit Disable (R/W) When set to 1, the Execute Disable B= it - /// feature (XD Bit) is disabled and the XD Bit extended feature flag = will - /// be clear (CPUID.80000001H: EDX[20]=3D0). When set to a 0 (default)= , the - /// Execute Disable Bit feature (if available) allows the OS to enable= PAE - /// paging and take advantage of data only pages. BIOS must not alter = the - /// contents of this bit location, if XD bit is not supported. Writing - /// this bit to 1 when the XD Bit extended feature flag is set to 0 may - /// generate a #GP exception. if CPUID.80000001H:EDX[2 0] =3D 1. - /// - UINT32 XD:1; - UINT32 Reserved9:29; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_MISC_ENABLE_REGISTER; - - -/** - Performance Energy Bias Hint (R/W). if CPUID.6H:ECX[3] =3D 1. - - @param ECX MSR_IA32_ENERGY_PERF_BIAS (0x000001B0) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_ENERGY_PERF_BIAS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_ENERGY_PERF_BIAS_REGISTER. - - Example usage - @code - MSR_IA32_ENERGY_PERF_BIAS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_ENERGY_PERF_BIAS); - AsmWriteMsr64 (MSR_IA32_ENERGY_PERF_BIAS, Msr.Uint64); - @endcode - @note MSR_IA32_ENERGY_PERF_BIAS is defined as IA32_ENERGY_PERF_BIAS in S= DM. -**/ -#define MSR_IA32_ENERGY_PERF_BIAS 0x000001B0 - -/** - MSR information returned for MSR index #MSR_IA32_ENERGY_PERF_BIAS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 3:0] Power Policy Preference: 0 indicates preference to high= est - /// performance. 15 indicates preference to maximize energy saving. - /// - UINT32 PowerPolicyPreference:4; - UINT32 Reserved1:28; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_ENERGY_PERF_BIAS_REGISTER; - - -/** - Package Thermal Status Information (RO) Contains status information about - the package's thermal sensor. See Section 14.8, "Package Level Thermal - Management.". If CPUID.06H: EAX[6] =3D 1. - - @param ECX MSR_IA32_PACKAGE_THERM_STATUS (0x000001B1) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PACKAGE_THERM_STATUS_REGISTE= R. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PACKAGE_THERM_STATUS_REGISTE= R. - - Example usage - @code - MSR_IA32_PACKAGE_THERM_STATUS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PACKAGE_THERM_STATUS); - @endcode - @note MSR_IA32_PACKAGE_THERM_STATUS is defined as IA32_PACKAGE_THERM_STA= TUS in SDM. -**/ -#define MSR_IA32_PACKAGE_THERM_STATUS 0x000001B1 - -/** - MSR information returned for MSR index #MSR_IA32_PACKAGE_THERM_STATUS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Pkg Thermal Status (RO):. - /// - UINT32 ThermalStatus:1; - /// - /// [Bit 1] Pkg Thermal Status Log (R/W):. - /// - UINT32 ThermalStatusLog:1; - /// - /// [Bit 2] Pkg PROCHOT # event (RO). - /// - UINT32 PROCHOT_Event:1; - /// - /// [Bit 3] Pkg PROCHOT # log (R/WC0). - /// - UINT32 PROCHOT_Log:1; - /// - /// [Bit 4] Pkg Critical Temperature Status (RO). - /// - UINT32 CriticalTempStatus:1; - /// - /// [Bit 5] Pkg Critical Temperature Status log (R/WC0). - /// - UINT32 CriticalTempStatusLog:1; - /// - /// [Bit 6] Pkg Thermal Threshold #1 Status (RO). - /// - UINT32 ThermalThreshold1Status:1; - /// - /// [Bit 7] Pkg Thermal Threshold #1 log (R/WC0). - /// - UINT32 ThermalThreshold1Log:1; - /// - /// [Bit 8] Pkg Thermal Threshold #2 Status (RO). - /// - UINT32 ThermalThreshold2Status:1; - /// - /// [Bit 9] Pkg Thermal Threshold #1 log (R/WC0). - /// - UINT32 ThermalThreshold2Log:1; - /// - /// [Bit 10] Pkg Power Limitation Status (RO). - /// - UINT32 PowerLimitStatus:1; - /// - /// [Bit 11] Pkg Power Limitation log (R/WC0). - /// - UINT32 PowerLimitLog:1; - UINT32 Reserved1:4; - /// - /// [Bits 22:16] Pkg Digital Readout (RO). - /// - UINT32 DigitalReadout:7; - UINT32 Reserved2:9; - UINT32 Reserved3:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PACKAGE_THERM_STATUS_REGISTER; - - -/** - Pkg Thermal Interrupt Control (R/W) Enables and disables the generation = of - an interrupt on temperature transitions detected with the package's ther= mal - sensor. See Section 14.8, "Package Level Thermal Management.". If CPUID.= 06H: - EAX[6] =3D 1. - - @param ECX MSR_IA32_PACKAGE_THERM_INTERRUPT (0x000001B2) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PACKAGE_THERM_INTERRUPT_REGI= STER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PACKAGE_THERM_INTERRUPT_REGI= STER. - - Example usage - @code - MSR_IA32_PACKAGE_THERM_INTERRUPT_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PACKAGE_THERM_INTERRUPT); - AsmWriteMsr64 (MSR_IA32_PACKAGE_THERM_INTERRUPT, Msr.Uint64); - @endcode - @note MSR_IA32_PACKAGE_THERM_INTERRUPT is defined as IA32_PACKAGE_THERM_= INTERRUPT in SDM. -**/ -#define MSR_IA32_PACKAGE_THERM_INTERRUPT 0x000001B2 - -/** - MSR information returned for MSR index #MSR_IA32_PACKAGE_THERM_INTERRUPT -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Pkg High-Temperature Interrupt Enable. - /// - UINT32 HighTempEnable:1; - /// - /// [Bit 1] Pkg Low-Temperature Interrupt Enable. - /// - UINT32 LowTempEnable:1; - /// - /// [Bit 2] Pkg PROCHOT# Interrupt Enable. - /// - UINT32 PROCHOT_Enable:1; - UINT32 Reserved1:1; - /// - /// [Bit 4] Pkg Overheat Interrupt Enable. - /// - UINT32 OverheatEnable:1; - UINT32 Reserved2:3; - /// - /// [Bits 14:8] Pkg Threshold #1 Value. - /// - UINT32 Threshold1:7; - /// - /// [Bit 15] Pkg Threshold #1 Interrupt Enable. - /// - UINT32 Threshold1Enable:1; - /// - /// [Bits 22:16] Pkg Threshold #2 Value. - /// - UINT32 Threshold2:7; - /// - /// [Bit 23] Pkg Threshold #2 Interrupt Enable. - /// - UINT32 Threshold2Enable:1; - /// - /// [Bit 24] Pkg Power Limit Notification Enable. - /// - UINT32 PowerLimitNotificationEnable:1; - UINT32 Reserved3:7; - UINT32 Reserved4:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PACKAGE_THERM_INTERRUPT_REGISTER; - - -/** - Trace/Profile Resource Control (R/W). Introduced at Display Family / Dis= play - Model 06_0EH. - - @param ECX MSR_IA32_DEBUGCTL (0x000001D9) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_DEBUGCTL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_DEBUGCTL_REGISTER. - - Example usage - @code - MSR_IA32_DEBUGCTL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_DEBUGCTL); - AsmWriteMsr64 (MSR_IA32_DEBUGCTL, Msr.Uint64); - @endcode - @note MSR_IA32_DEBUGCTL is defined as IA32_DEBUGCTL in SDM. -**/ -#define MSR_IA32_DEBUGCTL 0x000001D9 - -/** - MSR information returned for MSR index #MSR_IA32_DEBUGCTL -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] LBR: Setting this bit to 1 enables the processor to record= a - /// running trace of the most recent branches taken by the processor in - /// the LBR stack. Introduced at Display Family / Display Model 06_01H. - /// - UINT32 LBR:1; - /// - /// [Bit 1] BTF: Setting this bit to 1 enables the processor to treat - /// EFLAGS.TF as single-step on branches instead of single-step on - /// instructions. Introduced at Display Family / Display Model 06_01H. - /// - UINT32 BTF:1; - UINT32 Reserved1:4; - /// - /// [Bit 6] TR: Setting this bit to 1 enables branch trace messages to= be - /// sent. Introduced at Display Family / Display Model 06_0EH. - /// - UINT32 TR:1; - /// - /// [Bit 7] BTS: Setting this bit enables branch trace messages (BTMs)= to - /// be logged in a BTS buffer. Introduced at Display Family / Display - /// Model 06_0EH. - /// - UINT32 BTS:1; - /// - /// [Bit 8] BTINT: When clear, BTMs are logged in a BTS buffer in circ= ular - /// fashion. When this bit is set, an interrupt is generated by the BTS - /// facility when the BTS buffer is full. Introduced at Display Family= / - /// Display Model 06_0EH. - /// - UINT32 BTINT:1; - /// - /// [Bit 9] BTS_OFF_OS: When set, BTS or BTM is skipped if CPL =3D 0. - /// Introduced at Display Family / Display Model 06_0FH. - /// - UINT32 BTS_OFF_OS:1; - /// - /// [Bit 10] BTS_OFF_USR: When set, BTS or BTM is skipped if CPL > 0. - /// Introduced at Display Family / Display Model 06_0FH. - /// - UINT32 BTS_OFF_USR:1; - /// - /// [Bit 11] FREEZE_LBRS_ON_PMI: When set, the LBR stack is frozen on a - /// PMI request. If CPUID.01H: ECX[15] =3D 1 && CPUID.0AH: EAX[7:0] > = 1. - /// - UINT32 FREEZE_LBRS_ON_PMI:1; - /// - /// [Bit 12] FREEZE_PERFMON_ON_PMI: When set, each ENABLE bit of the - /// global counter control MSR are frozen (address 38FH) on a PMI requ= est. - /// If CPUID.01H: ECX[15] =3D 1 && CPUID.0AH: EAX[7:0] > 1. - /// - UINT32 FREEZE_PERFMON_ON_PMI:1; - /// - /// [Bit 13] ENABLE_UNCORE_PMI: When set, enables the logical processo= r to - /// receive and generate PMI on behalf of the uncore. Introduced at - /// Display Family / Display Model 06_1AH. - /// - UINT32 ENABLE_UNCORE_PMI:1; - /// - /// [Bit 14] FREEZE_WHILE_SMM: When set, freezes perfmon and trace - /// messages while in SMM. If IA32_PERF_CAPABILITIES[ 12] =3D 1. - /// - UINT32 FREEZE_WHILE_SMM:1; - /// - /// [Bit 15] RTM_DEBUG: When set, enables DR7 debug bit on XBEGIN. If - /// (CPUID.(EAX=3D07H, ECX=3D0):EBX[11] =3D 1). - /// - UINT32 RTM_DEBUG:1; - UINT32 Reserved2:16; - UINT32 Reserved3:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_DEBUGCTL_REGISTER; - - -/** - SMRR Base Address (Writeable only in SMM) Base address of SMM memory ra= nge. - If IA32_MTRRCAP.SMRR[11] =3D 1. - - @param ECX MSR_IA32_SMRR_PHYSBASE (0x000001F2) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_SMRR_PHYSBASE_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_SMRR_PHYSBASE_REGISTER. - - Example usage - @code - MSR_IA32_SMRR_PHYSBASE_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_SMRR_PHYSBASE); - AsmWriteMsr64 (MSR_IA32_SMRR_PHYSBASE, Msr.Uint64); - @endcode - @note MSR_IA32_SMRR_PHYSBASE is defined as IA32_SMRR_PHYSBASE in SDM. -**/ -#define MSR_IA32_SMRR_PHYSBASE 0x000001F2 - -/** - MSR information returned for MSR index #MSR_IA32_SMRR_PHYSBASE -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Type. Specifies memory type of the range. - /// - UINT32 Type:8; - UINT32 Reserved1:4; - /// - /// [Bits 31:12] PhysBase. SMRR physical Base Address. - /// - UINT32 PhysBase:20; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_SMRR_PHYSBASE_REGISTER; - - -/** - SMRR Range Mask (Writeable only in SMM) Range Mask of SMM memory range. = If - IA32_MTRRCAP[SMRR] =3D 1. - - @param ECX MSR_IA32_SMRR_PHYSMASK (0x000001F3) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_SMRR_PHYSMASK_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_SMRR_PHYSMASK_REGISTER. - - Example usage - @code - MSR_IA32_SMRR_PHYSMASK_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_SMRR_PHYSMASK); - AsmWriteMsr64 (MSR_IA32_SMRR_PHYSMASK, Msr.Uint64); - @endcode - @note MSR_IA32_SMRR_PHYSMASK is defined as IA32_SMRR_PHYSMASK in SDM. -**/ -#define MSR_IA32_SMRR_PHYSMASK 0x000001F3 - -/** - MSR information returned for MSR index #MSR_IA32_SMRR_PHYSMASK -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved1:11; - /// - /// [Bit 11] Valid Enable range mask. - /// - UINT32 Valid:1; - /// - /// [Bits 31:12] PhysMask SMRR address range mask. - /// - UINT32 PhysMask:20; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_SMRR_PHYSMASK_REGISTER; - - -/** - DCA Capability (R). If CPUID.01H: ECX[18] =3D 1. - - @param ECX MSR_IA32_PLATFORM_DCA_CAP (0x000001F8) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_PLATFORM_DCA_CAP); - @endcode - @note MSR_IA32_PLATFORM_DCA_CAP is defined as IA32_PLATFORM_DCA_CAP in S= DM. -**/ -#define MSR_IA32_PLATFORM_DCA_CAP 0x000001F8 - - -/** - If set, CPU supports Prefetch-Hint type. If CPUID.01H: ECX[18] =3D 1. - - @param ECX MSR_IA32_CPU_DCA_CAP (0x000001F9) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_CPU_DCA_CAP); - AsmWriteMsr64 (MSR_IA32_CPU_DCA_CAP, Msr); - @endcode - @note MSR_IA32_CPU_DCA_CAP is defined as IA32_CPU_DCA_CAP in SDM. -**/ -#define MSR_IA32_CPU_DCA_CAP 0x000001F9 - - -/** - DCA type 0 Status and Control register. If CPUID.01H: ECX[18] =3D 1. - - @param ECX MSR_IA32_DCA_0_CAP (0x000001FA) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_DCA_0_CAP_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_DCA_0_CAP_REGISTER. - - Example usage - @code - MSR_IA32_DCA_0_CAP_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_DCA_0_CAP); - AsmWriteMsr64 (MSR_IA32_DCA_0_CAP, Msr.Uint64); - @endcode - @note MSR_IA32_DCA_0_CAP is defined as IA32_DCA_0_CAP in SDM. -**/ -#define MSR_IA32_DCA_0_CAP 0x000001FA - -/** - MSR information returned for MSR index #MSR_IA32_DCA_0_CAP -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] DCA_ACTIVE: Set by HW when DCA is fuseenabled and no - /// defeatures are set. - /// - UINT32 DCA_ACTIVE:1; - /// - /// [Bits 2:1] TRANSACTION. - /// - UINT32 TRANSACTION:2; - /// - /// [Bits 6:3] DCA_TYPE. - /// - UINT32 DCA_TYPE:4; - /// - /// [Bits 10:7] DCA_QUEUE_SIZE. - /// - UINT32 DCA_QUEUE_SIZE:4; - UINT32 Reserved1:2; - /// - /// [Bits 16:13] DCA_DELAY: Writes will update the register but have n= o HW - /// side-effect. - /// - UINT32 DCA_DELAY:4; - UINT32 Reserved2:7; - /// - /// [Bit 24] SW_BLOCK: SW can request DCA block by setting this bit. - /// - UINT32 SW_BLOCK:1; - UINT32 Reserved3:1; - /// - /// [Bit 26] HW_BLOCK: Set when DCA is blocked by HW (e.g. CR0.CD =3D = 1). - /// - UINT32 HW_BLOCK:1; - UINT32 Reserved4:5; - UINT32 Reserved5:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_DCA_0_CAP_REGISTER; - - -/** - MTRRphysBasen. See Section 11.11.2.3, "Variable Range MTRRs". - If CPUID.01H: EDX.MTRR[12] =3D 1 and IA32_MTRRCAP[7:0] > n. - - @param ECX MSR_IA32_MTRR_PHYSBASEn - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_MTRR_PHYSBASE_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_MTRR_PHYSBASE_REGISTER. - - Example usage - @code - MSR_IA32_MTRR_PHYSBASE_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MTRR_PHYSBASE0); - AsmWriteMsr64 (MSR_IA32_MTRR_PHYSBASE0, Msr.Uint64); - @endcode - @note MSR_IA32_MTRR_PHYSBASE0 is defined as IA32_MTRR_PHYSBASE0 in SDM. - MSR_IA32_MTRR_PHYSBASE1 is defined as IA32_MTRR_PHYSBASE1 in SDM. - MSR_IA32_MTRR_PHYSBASE2 is defined as IA32_MTRR_PHYSBASE2 in SDM. - MSR_IA32_MTRR_PHYSBASE3 is defined as IA32_MTRR_PHYSBASE3 in SDM. - MSR_IA32_MTRR_PHYSBASE4 is defined as IA32_MTRR_PHYSBASE4 in SDM. - MSR_IA32_MTRR_PHYSBASE5 is defined as IA32_MTRR_PHYSBASE5 in SDM. - MSR_IA32_MTRR_PHYSBASE6 is defined as IA32_MTRR_PHYSBASE6 in SDM. - MSR_IA32_MTRR_PHYSBASE7 is defined as IA32_MTRR_PHYSBASE7 in SDM. - MSR_IA32_MTRR_PHYSBASE8 is defined as IA32_MTRR_PHYSBASE8 in SDM. - MSR_IA32_MTRR_PHYSBASE9 is defined as IA32_MTRR_PHYSBASE9 in SDM. - @{ -**/ -#define MSR_IA32_MTRR_PHYSBASE0 0x00000200 -#define MSR_IA32_MTRR_PHYSBASE1 0x00000202 -#define MSR_IA32_MTRR_PHYSBASE2 0x00000204 -#define MSR_IA32_MTRR_PHYSBASE3 0x00000206 -#define MSR_IA32_MTRR_PHYSBASE4 0x00000208 -#define MSR_IA32_MTRR_PHYSBASE5 0x0000020A -#define MSR_IA32_MTRR_PHYSBASE6 0x0000020C -#define MSR_IA32_MTRR_PHYSBASE7 0x0000020E -#define MSR_IA32_MTRR_PHYSBASE8 0x00000210 -#define MSR_IA32_MTRR_PHYSBASE9 0x00000212 -/// @} - -/** - MSR information returned for MSR indexes #MSR_IA32_MTRR_PHYSBASE0 to - #MSR_IA32_MTRR_PHYSBASE9 -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Type. Specifies memory type of the range. - /// - UINT32 Type:8; - UINT32 Reserved1:4; - /// - /// [Bits 31:12] PhysBase. MTRR physical Base Address. - /// - UINT32 PhysBase:20; - /// - /// [Bits MAXPHYSADDR:32] PhysBase. Upper bits of MTRR physical Base = Address. - /// MAXPHYADDR: The bit position indicated by MAXPHYADDR depends on the - /// maximum physical address range supported by the processor. It is - /// reported by CPUID leaf function 80000008H. If CPUID does not suppo= rt - /// leaf 80000008H, the processor supports 36-bit physical address siz= e, - /// then bit PhysMask consists of bits 35:12, and bits 63:36 are reser= ved. - /// - UINT32 PhysBaseHi:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_MTRR_PHYSBASE_REGISTER; - - -/** - MTRRphysMaskn. See Section 11.11.2.3, "Variable Range MTRRs". - If CPUID.01H: EDX.MTRR[12] =3D 1 and IA32_MTRRCAP[7:0] > n. - - @param ECX MSR_IA32_MTRR_PHYSMASKn - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_MTRR_PHYSMASK_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_MTRR_PHYSMASK_REGISTER. - - Example usage - @code - MSR_IA32_MTRR_PHYSMASK_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MTRR_PHYSMASK0); - AsmWriteMsr64 (MSR_IA32_MTRR_PHYSMASK0, Msr.Uint64); - @endcode - @note MSR_IA32_MTRR_PHYSMASK0 is defined as IA32_MTRR_PHYSMASK0 in SDM. - MSR_IA32_MTRR_PHYSMASK1 is defined as IA32_MTRR_PHYSMASK1 in SDM. - MSR_IA32_MTRR_PHYSMASK2 is defined as IA32_MTRR_PHYSMASK2 in SDM. - MSR_IA32_MTRR_PHYSMASK3 is defined as IA32_MTRR_PHYSMASK3 in SDM. - MSR_IA32_MTRR_PHYSMASK4 is defined as IA32_MTRR_PHYSMASK4 in SDM. - MSR_IA32_MTRR_PHYSMASK5 is defined as IA32_MTRR_PHYSMASK5 in SDM. - MSR_IA32_MTRR_PHYSMASK6 is defined as IA32_MTRR_PHYSMASK6 in SDM. - MSR_IA32_MTRR_PHYSMASK7 is defined as IA32_MTRR_PHYSMASK7 in SDM. - MSR_IA32_MTRR_PHYSMASK8 is defined as IA32_MTRR_PHYSMASK8 in SDM. - MSR_IA32_MTRR_PHYSMASK9 is defined as IA32_MTRR_PHYSMASK9 in SDM. - @{ -**/ -#define MSR_IA32_MTRR_PHYSMASK0 0x00000201 -#define MSR_IA32_MTRR_PHYSMASK1 0x00000203 -#define MSR_IA32_MTRR_PHYSMASK2 0x00000205 -#define MSR_IA32_MTRR_PHYSMASK3 0x00000207 -#define MSR_IA32_MTRR_PHYSMASK4 0x00000209 -#define MSR_IA32_MTRR_PHYSMASK5 0x0000020B -#define MSR_IA32_MTRR_PHYSMASK6 0x0000020D -#define MSR_IA32_MTRR_PHYSMASK7 0x0000020F -#define MSR_IA32_MTRR_PHYSMASK8 0x00000211 -#define MSR_IA32_MTRR_PHYSMASK9 0x00000213 -/// @} - -/** - MSR information returned for MSR indexes #MSR_IA32_MTRR_PHYSMASK0 to - #MSR_IA32_MTRR_PHYSMASK9 -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved1:11; - /// - /// [Bit 11] Valid Enable range mask. - /// - UINT32 V:1; - /// - /// [Bits 31:12] PhysMask. MTRR address range mask. - /// - UINT32 PhysMask:20; - /// - /// [Bits MAXPHYSADDR:32] PhysMask. Upper bits of MTRR address range = mask. - /// MAXPHYADDR: The bit position indicated by MAXPHYADDR depends on the - /// maximum physical address range supported by the processor. It is - /// reported by CPUID leaf function 80000008H. If CPUID does not suppo= rt - /// leaf 80000008H, the processor supports 36-bit physical address siz= e, - /// then bit PhysMask consists of bits 35:12, and bits 63:36 are reser= ved. - /// - UINT32 PhysMaskHi:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_MTRR_PHYSMASK_REGISTER; - - -/** - MTRRfix64K_00000. If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_FIX64K_00000 (0x00000250) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX64K_00000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX64K_00000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX64K_00000 is defined as IA32_MTRR_FIX64K_00000 in= SDM. -**/ -#define MSR_IA32_MTRR_FIX64K_00000 0x00000250 - - -/** - MTRRfix16K_80000. If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_FIX16K_80000 (0x00000258) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX16K_80000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX16K_80000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX16K_80000 is defined as IA32_MTRR_FIX16K_80000 in= SDM. -**/ -#define MSR_IA32_MTRR_FIX16K_80000 0x00000258 - - -/** - MTRRfix16K_A0000. If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_FIX16K_A0000 (0x00000259) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX16K_A0000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX16K_A0000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX16K_A0000 is defined as IA32_MTRR_FIX16K_A0000 in= SDM. -**/ -#define MSR_IA32_MTRR_FIX16K_A0000 0x00000259 - - -/** - See Section 11.11.2.2, "Fixed Range MTRRs.". If CPUID.01H: EDX.MTRR[12] = =3D1. - - @param ECX MSR_IA32_MTRR_FIX4K_C0000 (0x00000268) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_C0000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_C0000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX4K_C0000 is defined as IA32_MTRR_FIX4K_C0000 in S= DM. -**/ -#define MSR_IA32_MTRR_FIX4K_C0000 0x00000268 - - -/** - MTRRfix4K_C8000. If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_FIX4K_C8000 (0x00000269) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_C8000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_C8000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX4K_C8000 is defined as IA32_MTRR_FIX4K_C8000 in S= DM. -**/ -#define MSR_IA32_MTRR_FIX4K_C8000 0x00000269 - - -/** - MTRRfix4K_D0000. If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_FIX4K_D0000 (0x0000026A) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_D0000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_D0000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX4K_D0000 is defined as IA32_MTRR_FIX4K_D0000 in S= DM. -**/ -#define MSR_IA32_MTRR_FIX4K_D0000 0x0000026A - - -/** - MTRRfix4K_D8000. If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_FIX4K_D8000 (0x0000026B) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_D8000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_D8000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX4K_D8000 is defined as IA32_MTRR_FIX4K_D8000 in S= DM. -**/ -#define MSR_IA32_MTRR_FIX4K_D8000 0x0000026B - - -/** - MTRRfix4K_E0000. If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_FIX4K_E0000 (0x0000026C) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_E0000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_E0000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX4K_E0000 is defined as IA32_MTRR_FIX4K_E0000 in S= DM. -**/ -#define MSR_IA32_MTRR_FIX4K_E0000 0x0000026C - - -/** - MTRRfix4K_E8000. If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_FIX4K_E8000 (0x0000026D) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_E8000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_E8000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX4K_E8000 is defined as IA32_MTRR_FIX4K_E8000 in S= DM. -**/ -#define MSR_IA32_MTRR_FIX4K_E8000 0x0000026D - - -/** - MTRRfix4K_F0000. If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_FIX4K_F0000 (0x0000026E) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_F0000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_F0000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX4K_F0000 is defined as IA32_MTRR_FIX4K_F0000 in S= DM. -**/ -#define MSR_IA32_MTRR_FIX4K_F0000 0x0000026E - - -/** - MTRRfix4K_F8000. If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_FIX4K_F8000 (0x0000026F) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MTRR_FIX4K_F8000); - AsmWriteMsr64 (MSR_IA32_MTRR_FIX4K_F8000, Msr); - @endcode - @note MSR_IA32_MTRR_FIX4K_F8000 is defined as IA32_MTRR_FIX4K_F8000 in S= DM. -**/ -#define MSR_IA32_MTRR_FIX4K_F8000 0x0000026F - - -/** - IA32_PAT (R/W). If CPUID.01H: EDX.MTRR[16] =3D1. - - @param ECX MSR_IA32_PAT (0x00000277) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PAT_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PAT_REGISTER. - - Example usage - @code - MSR_IA32_PAT_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PAT); - AsmWriteMsr64 (MSR_IA32_PAT, Msr.Uint64); - @endcode - @note MSR_IA32_PAT is defined as IA32_PAT in SDM. -**/ -#define MSR_IA32_PAT 0x00000277 - -/** - MSR information returned for MSR index #MSR_IA32_PAT -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 2:0] PA0. - /// - UINT32 PA0:3; - UINT32 Reserved1:5; - /// - /// [Bits 10:8] PA1. - /// - UINT32 PA1:3; - UINT32 Reserved2:5; - /// - /// [Bits 18:16] PA2. - /// - UINT32 PA2:3; - UINT32 Reserved3:5; - /// - /// [Bits 26:24] PA3. - /// - UINT32 PA3:3; - UINT32 Reserved4:5; - /// - /// [Bits 34:32] PA4. - /// - UINT32 PA4:3; - UINT32 Reserved5:5; - /// - /// [Bits 42:40] PA5. - /// - UINT32 PA5:3; - UINT32 Reserved6:5; - /// - /// [Bits 50:48] PA6. - /// - UINT32 PA6:3; - UINT32 Reserved7:5; - /// - /// [Bits 58:56] PA7. - /// - UINT32 PA7:3; - UINT32 Reserved8:5; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PAT_REGISTER; - - -/** - Provides the programming interface to use corrected MC error signaling - capability (R/W). If IA32_MCG_CAP[10] =3D 1 && IA32_MCG_CAP[7:0] > n. - - @param ECX MSR_IA32_MCn_CTL2 - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_MC_CTL2_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_MC_CTL2_REGISTER. - - Example usage - @code - MSR_IA32_MC_CTL2_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MC0_CTL2); - AsmWriteMsr64 (MSR_IA32_MC0_CTL2, Msr.Uint64); - @endcode - @note MSR_IA32_MC0_CTL2 is defined as IA32_MC0_CTL2 in SDM. - MSR_IA32_MC1_CTL2 is defined as IA32_MC1_CTL2 in SDM. - MSR_IA32_MC2_CTL2 is defined as IA32_MC2_CTL2 in SDM. - MSR_IA32_MC3_CTL2 is defined as IA32_MC3_CTL2 in SDM. - MSR_IA32_MC4_CTL2 is defined as IA32_MC4_CTL2 in SDM. - MSR_IA32_MC5_CTL2 is defined as IA32_MC5_CTL2 in SDM. - MSR_IA32_MC6_CTL2 is defined as IA32_MC6_CTL2 in SDM. - MSR_IA32_MC7_CTL2 is defined as IA32_MC7_CTL2 in SDM. - MSR_IA32_MC8_CTL2 is defined as IA32_MC8_CTL2 in SDM. - MSR_IA32_MC9_CTL2 is defined as IA32_MC9_CTL2 in SDM. - MSR_IA32_MC10_CTL2 is defined as IA32_MC10_CTL2 in SDM. - MSR_IA32_MC11_CTL2 is defined as IA32_MC11_CTL2 in SDM. - MSR_IA32_MC12_CTL2 is defined as IA32_MC12_CTL2 in SDM. - MSR_IA32_MC13_CTL2 is defined as IA32_MC13_CTL2 in SDM. - MSR_IA32_MC14_CTL2 is defined as IA32_MC14_CTL2 in SDM. - MSR_IA32_MC15_CTL2 is defined as IA32_MC15_CTL2 in SDM. - MSR_IA32_MC16_CTL2 is defined as IA32_MC16_CTL2 in SDM. - MSR_IA32_MC17_CTL2 is defined as IA32_MC17_CTL2 in SDM. - MSR_IA32_MC18_CTL2 is defined as IA32_MC18_CTL2 in SDM. - MSR_IA32_MC19_CTL2 is defined as IA32_MC19_CTL2 in SDM. - MSR_IA32_MC20_CTL2 is defined as IA32_MC20_CTL2 in SDM. - MSR_IA32_MC21_CTL2 is defined as IA32_MC21_CTL2 in SDM. - MSR_IA32_MC22_CTL2 is defined as IA32_MC22_CTL2 in SDM. - MSR_IA32_MC23_CTL2 is defined as IA32_MC23_CTL2 in SDM. - MSR_IA32_MC24_CTL2 is defined as IA32_MC24_CTL2 in SDM. - MSR_IA32_MC25_CTL2 is defined as IA32_MC25_CTL2 in SDM. - MSR_IA32_MC26_CTL2 is defined as IA32_MC26_CTL2 in SDM. - MSR_IA32_MC27_CTL2 is defined as IA32_MC27_CTL2 in SDM. - MSR_IA32_MC28_CTL2 is defined as IA32_MC28_CTL2 in SDM. - MSR_IA32_MC29_CTL2 is defined as IA32_MC29_CTL2 in SDM. - MSR_IA32_MC30_CTL2 is defined as IA32_MC30_CTL2 in SDM. - MSR_IA32_MC31_CTL2 is defined as IA32_MC31_CTL2 in SDM. - @{ -**/ -#define MSR_IA32_MC0_CTL2 0x00000280 -#define MSR_IA32_MC1_CTL2 0x00000281 -#define MSR_IA32_MC2_CTL2 0x00000282 -#define MSR_IA32_MC3_CTL2 0x00000283 -#define MSR_IA32_MC4_CTL2 0x00000284 -#define MSR_IA32_MC5_CTL2 0x00000285 -#define MSR_IA32_MC6_CTL2 0x00000286 -#define MSR_IA32_MC7_CTL2 0x00000287 -#define MSR_IA32_MC8_CTL2 0x00000288 -#define MSR_IA32_MC9_CTL2 0x00000289 -#define MSR_IA32_MC10_CTL2 0x0000028A -#define MSR_IA32_MC11_CTL2 0x0000028B -#define MSR_IA32_MC12_CTL2 0x0000028C -#define MSR_IA32_MC13_CTL2 0x0000028D -#define MSR_IA32_MC14_CTL2 0x0000028E -#define MSR_IA32_MC15_CTL2 0x0000028F -#define MSR_IA32_MC16_CTL2 0x00000290 -#define MSR_IA32_MC17_CTL2 0x00000291 -#define MSR_IA32_MC18_CTL2 0x00000292 -#define MSR_IA32_MC19_CTL2 0x00000293 -#define MSR_IA32_MC20_CTL2 0x00000294 -#define MSR_IA32_MC21_CTL2 0x00000295 -#define MSR_IA32_MC22_CTL2 0x00000296 -#define MSR_IA32_MC23_CTL2 0x00000297 -#define MSR_IA32_MC24_CTL2 0x00000298 -#define MSR_IA32_MC25_CTL2 0x00000299 -#define MSR_IA32_MC26_CTL2 0x0000029A -#define MSR_IA32_MC27_CTL2 0x0000029B -#define MSR_IA32_MC28_CTL2 0x0000029C -#define MSR_IA32_MC29_CTL2 0x0000029D -#define MSR_IA32_MC30_CTL2 0x0000029E -#define MSR_IA32_MC31_CTL2 0x0000029F -/// @} - -/** - MSR information returned for MSR indexes #MSR_IA32_MC0_CTL2 - to #MSR_IA32_MC31_CTL2 -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 14:0] Corrected error count threshold. - /// - UINT32 CorrectedErrorCountThreshold:15; - UINT32 Reserved1:15; - /// - /// [Bit 30] CMCI_EN. - /// - UINT32 CMCI_EN:1; - UINT32 Reserved2:1; - UINT32 Reserved3:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_MC_CTL2_REGISTER; - - -/** - MTRRdefType (R/W). If CPUID.01H: EDX.MTRR[12] =3D1. - - @param ECX MSR_IA32_MTRR_DEF_TYPE (0x000002FF) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_MTRR_DEF_TYPE_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_MTRR_DEF_TYPE_REGISTER. - - Example usage - @code - MSR_IA32_MTRR_DEF_TYPE_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MTRR_DEF_TYPE); - AsmWriteMsr64 (MSR_IA32_MTRR_DEF_TYPE, Msr.Uint64); - @endcode - @note MSR_IA32_MTRR_DEF_TYPE is defined as IA32_MTRR_DEF_TYPE in SDM. -**/ -#define MSR_IA32_MTRR_DEF_TYPE 0x000002FF - -/** - MSR information returned for MSR index #MSR_IA32_MTRR_DEF_TYPE -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 2:0] Default Memory Type. - /// - UINT32 Type:3; - UINT32 Reserved1:7; - /// - /// [Bit 10] Fixed Range MTRR Enable. - /// - UINT32 FE:1; - /// - /// [Bit 11] MTRR Enable. - /// - UINT32 E:1; - UINT32 Reserved2:20; - UINT32 Reserved3:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_MTRR_DEF_TYPE_REGISTER; - - -/** - Fixed-Function Performance Counter 0 (R/W): Counts Instr_Retired.Any. If - CPUID.0AH: EDX[4:0] > 0. - - @param ECX MSR_IA32_FIXED_CTR0 (0x00000309) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_FIXED_CTR0); - AsmWriteMsr64 (MSR_IA32_FIXED_CTR0, Msr); - @endcode - @note MSR_IA32_FIXED_CTR0 is defined as IA32_FIXED_CTR0 in SDM. -**/ -#define MSR_IA32_FIXED_CTR0 0x00000309 - - -/** - Fixed-Function Performance Counter 1 (R/W): Counts CPU_CLK_Unhalted.Core= . If - CPUID.0AH: EDX[4:0] > 1. - - @param ECX MSR_IA32_FIXED_CTR1 (0x0000030A) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_FIXED_CTR1); - AsmWriteMsr64 (MSR_IA32_FIXED_CTR1, Msr); - @endcode - @note MSR_IA32_FIXED_CTR1 is defined as IA32_FIXED_CTR1 in SDM. -**/ -#define MSR_IA32_FIXED_CTR1 0x0000030A - - -/** - Fixed-Function Performance Counter 2 (R/W): Counts CPU_CLK_Unhalted.Ref.= If - CPUID.0AH: EDX[4:0] > 2. - - @param ECX MSR_IA32_FIXED_CTR2 (0x0000030B) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_FIXED_CTR2); - AsmWriteMsr64 (MSR_IA32_FIXED_CTR2, Msr); - @endcode - @note MSR_IA32_FIXED_CTR2 is defined as IA32_FIXED_CTR2 in SDM. -**/ -#define MSR_IA32_FIXED_CTR2 0x0000030B - - -/** - RO. If CPUID.01H: ECX[15] =3D 1. - - @param ECX MSR_IA32_PERF_CAPABILITIES (0x00000345) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PERF_CAPABILITIES_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PERF_CAPABILITIES_REGISTER. - - Example usage - @code - MSR_IA32_PERF_CAPABILITIES_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_CAPABILITIES); - AsmWriteMsr64 (MSR_IA32_PERF_CAPABILITIES, Msr.Uint64); - @endcode - @note MSR_IA32_PERF_CAPABILITIES is defined as IA32_PERF_CAPABILITIES in= SDM. -**/ -#define MSR_IA32_PERF_CAPABILITIES 0x00000345 - -/** - MSR information returned for MSR index #MSR_IA32_PERF_CAPABILITIES -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 5:0] LBR format. - /// - UINT32 LBR_FMT:6; - /// - /// [Bit 6] PEBS Trap. - /// - UINT32 PEBS_TRAP:1; - /// - /// [Bit 7] PEBSSaveArchRegs. - /// - UINT32 PEBS_ARCH_REG:1; - /// - /// [Bits 11:8] PEBS Record Format. - /// - UINT32 PEBS_REC_FMT:4; - /// - /// [Bit 12] 1: Freeze while SMM is supported. - /// - UINT32 SMM_FREEZE:1; - /// - /// [Bit 13] 1: Full width of counter writable via IA32_A_PMCx. - /// - UINT32 FW_WRITE:1; - UINT32 Reserved1:18; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PERF_CAPABILITIES_REGISTER; - - -/** - Fixed-Function Performance Counter Control (R/W) Counter increments while - the results of ANDing respective enable bit in IA32_PERF_GLOBAL_CTRL with - the corresponding OS or USR bits in this MSR is true. If CPUID.0AH: EAX[= 7:0] - > 1. - - @param ECX MSR_IA32_FIXED_CTR_CTRL (0x0000038D) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_FIXED_CTR_CTRL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_FIXED_CTR_CTRL_REGISTER. - - Example usage - @code - MSR_IA32_FIXED_CTR_CTRL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_FIXED_CTR_CTRL); - AsmWriteMsr64 (MSR_IA32_FIXED_CTR_CTRL, Msr.Uint64); - @endcode - @note MSR_IA32_FIXED_CTR_CTRL is defined as IA32_FIXED_CTR_CTRL in SDM. -**/ -#define MSR_IA32_FIXED_CTR_CTRL 0x0000038D - -/** - MSR information returned for MSR index #MSR_IA32_FIXED_CTR_CTRL -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] EN0_OS: Enable Fixed Counter 0 to count while CPL =3D 0. - /// - UINT32 EN0_OS:1; - /// - /// [Bit 1] EN0_Usr: Enable Fixed Counter 0 to count while CPL > 0. - /// - UINT32 EN0_Usr:1; - /// - /// [Bit 2] AnyThread: When set to 1, it enables counting the associat= ed - /// event conditions occurring across all logical processors sharing a - /// processor core. When set to 0, the counter only increments the - /// associated event conditions occurring in the logical processor whi= ch - /// programmed the MSR. If CPUID.0AH: EAX[7:0] > 2. - /// - UINT32 AnyThread0:1; - /// - /// [Bit 3] EN0_PMI: Enable PMI when fixed counter 0 overflows. - /// - UINT32 EN0_PMI:1; - /// - /// [Bit 4] EN1_OS: Enable Fixed Counter 1 to count while CPL =3D 0. - /// - UINT32 EN1_OS:1; - /// - /// [Bit 5] EN1_Usr: Enable Fixed Counter 1 to count while CPL > 0. - /// - UINT32 EN1_Usr:1; - /// - /// [Bit 6] AnyThread: When set to 1, it enables counting the associat= ed - /// event conditions occurring across all logical processors sharing a - /// processor core. When set to 0, the counter only increments the - /// associated event conditions occurring in the logical processor whi= ch - /// programmed the MSR. If CPUID.0AH: EAX[7:0] > 2. - /// - UINT32 AnyThread1:1; - /// - /// [Bit 7] EN1_PMI: Enable PMI when fixed counter 1 overflows. - /// - UINT32 EN1_PMI:1; - /// - /// [Bit 8] EN2_OS: Enable Fixed Counter 2 to count while CPL =3D 0. - /// - UINT32 EN2_OS:1; - /// - /// [Bit 9] EN2_Usr: Enable Fixed Counter 2 to count while CPL > 0. - /// - UINT32 EN2_Usr:1; - /// - /// [Bit 10] AnyThread: When set to 1, it enables counting the associa= ted - /// event conditions occurring across all logical processors sharing a - /// processor core. When set to 0, the counter only increments the - /// associated event conditions occurring in the logical processor whi= ch - /// programmed the MSR. If CPUID.0AH: EAX[7:0] > 2. - /// - UINT32 AnyThread2:1; - /// - /// [Bit 11] EN2_PMI: Enable PMI when fixed counter 2 overflows. - /// - UINT32 EN2_PMI:1; - UINT32 Reserved1:20; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_FIXED_CTR_CTRL_REGISTER; - - -/** - Global Performance Counter Status (RO). If CPUID.0AH: EAX[7:0] > 0. - - @param ECX MSR_IA32_PERF_GLOBAL_STATUS (0x0000038E) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_STATUS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_STATUS_REGISTER. - - Example usage - @code - MSR_IA32_PERF_GLOBAL_STATUS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_STATUS); - @endcode - @note MSR_IA32_PERF_GLOBAL_STATUS is defined as IA32_PERF_GLOBAL_STATUS = in SDM. -**/ -#define MSR_IA32_PERF_GLOBAL_STATUS 0x0000038E - -/** - MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_STATUS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Ovf_PMC0: Overflow status of IA32_PMC0. If CPUID.0AH: - /// EAX[15:8] > 0. - /// - UINT32 Ovf_PMC0:1; - /// - /// [Bit 1] Ovf_PMC1: Overflow status of IA32_PMC1. If CPUID.0AH: - /// EAX[15:8] > 1. - /// - UINT32 Ovf_PMC1:1; - /// - /// [Bit 2] Ovf_PMC2: Overflow status of IA32_PMC2. If CPUID.0AH: - /// EAX[15:8] > 2. - /// - UINT32 Ovf_PMC2:1; - /// - /// [Bit 3] Ovf_PMC3: Overflow status of IA32_PMC3. If CPUID.0AH: - /// EAX[15:8] > 3. - /// - UINT32 Ovf_PMC3:1; - UINT32 Reserved1:28; - /// - /// [Bit 32] Ovf_FixedCtr0: Overflow status of IA32_FIXED_CTR0. If - /// CPUID.0AH: EAX[7:0] > 1. - /// - UINT32 Ovf_FixedCtr0:1; - /// - /// [Bit 33] Ovf_FixedCtr1: Overflow status of IA32_FIXED_CTR1. If - /// CPUID.0AH: EAX[7:0] > 1. - /// - UINT32 Ovf_FixedCtr1:1; - /// - /// [Bit 34] Ovf_FixedCtr2: Overflow status of IA32_FIXED_CTR2. If - /// CPUID.0AH: EAX[7:0] > 1. - /// - UINT32 Ovf_FixedCtr2:1; - UINT32 Reserved2:20; - /// - /// [Bit 55] Trace_ToPA_PMI: A PMI occurred due to a ToPA entry memory - /// buffer was completely filled. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[2= 5] =3D 1) - /// && IA32_RTIT_CTL.ToPA =3D 1. - /// - UINT32 Trace_ToPA_PMI:1; - UINT32 Reserved3:2; - /// - /// [Bit 58] LBR_Frz: LBRs are frozen due to - - /// IA32_DEBUGCTL.FREEZE_LBR_ON_PMI=3D1, - The LBR stack overflowed. = If - /// CPUID.0AH: EAX[7:0] > 3. - /// - UINT32 LBR_Frz:1; - /// - /// [Bit 59] CTR_Frz: Performance counters in the core PMU are frozen = due - /// to - IA32_DEBUGCTL.FREEZE_PERFMON_ON_ PMI=3D1, - one or more cor= e PMU - /// counters overflowed. If CPUID.0AH: EAX[7:0] > 3. - /// - UINT32 CTR_Frz:1; - /// - /// [Bit 60] ASCI: Data in the performance counters in the core PMU may - /// include contributions from the direct or indirect operation intel = SGX - /// to protect an enclave. If CPUID.(EAX=3D07H, ECX=3D0):EBX[2] =3D 1. - /// - UINT32 ASCI:1; - /// - /// [Bit 61] Ovf_Uncore: Uncore counter overflow status. If CPUID.0AH: - /// EAX[7:0] > 2. - /// - UINT32 Ovf_Uncore:1; - /// - /// [Bit 62] OvfBuf: DS SAVE area Buffer overflow status. If CPUID.0AH: - /// EAX[7:0] > 0. - /// - UINT32 OvfBuf:1; - /// - /// [Bit 63] CondChgd: status bits of this register has changed. If - /// CPUID.0AH: EAX[7:0] > 0. - /// - UINT32 CondChgd:1; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PERF_GLOBAL_STATUS_REGISTER; - - -/** - Global Performance Counter Control (R/W) Counter increments while the re= sult - of ANDing respective enable bit in this MSR with the corresponding OS or= USR - bits in the general-purpose or fixed counter control MSR is true. If - CPUID.0AH: EAX[7:0] > 0. - - @param ECX MSR_IA32_PERF_GLOBAL_CTRL (0x0000038F) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_CTRL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_CTRL_REGISTER. - - Example usage - @code - MSR_IA32_PERF_GLOBAL_CTRL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_CTRL); - AsmWriteMsr64 (MSR_IA32_PERF_GLOBAL_CTRL, Msr.Uint64); - @endcode - @note MSR_IA32_PERF_GLOBAL_CTRL is defined as IA32_PERF_GLOBAL_CTRL in S= DM. -**/ -#define MSR_IA32_PERF_GLOBAL_CTRL 0x0000038F - -/** - MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_CTRL -**/ -typedef union { - /// - /// Individual bit fields -/// - struct { - /// - /// [Bits 31:0] EN_PMCn. If CPUID.0AH: EAX[15:8] > n. - /// Enable bitmask. Only the first n-1 bits are valid. - /// Bits n..31 are reserved. - /// - UINT32 EN_PMCn:32; - /// - /// [Bits 63:32] EN_FIXED_CTRn. If CPUID.0AH: EDX[4:0] > n. - /// Enable bitmask. Only the first n-1 bits are valid. - /// Bits 31:n are reserved. - /// - UINT32 EN_FIXED_CTRn:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PERF_GLOBAL_CTRL_REGISTER; - - -/** - Global Performance Counter Overflow Control (R/W). If CPUID.0AH: EAX[7:0= ] > - 0 && CPUID.0AH: EAX[7:0] <=3D 3. - - @param ECX MSR_IA32_PERF_GLOBAL_OVF_CTRL (0x00000390) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_OVF_CTRL_REGISTE= R. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_OVF_CTRL_REGISTE= R. - - Example usage - @code - MSR_IA32_PERF_GLOBAL_OVF_CTRL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_OVF_CTRL); - AsmWriteMsr64 (MSR_IA32_PERF_GLOBAL_OVF_CTRL, Msr.Uint64); - @endcode - @note MSR_IA32_PERF_GLOBAL_OVF_CTRL is defined as IA32_PERF_GLOBAL_OVF_C= TRL in SDM. -**/ -#define MSR_IA32_PERF_GLOBAL_OVF_CTRL 0x00000390 - -/** - MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_OVF_CTRL -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 31:0] Set 1 to Clear Ovf_PMC0 bit. If CPUID.0AH: EAX[15:8] >= n. - /// Clear bitmask. Only the first n-1 bits are valid. - /// Bits 31:n are reserved. - /// - UINT32 Ovf_PMCn:32; - /// - /// [Bits 54:32] Set 1 to Clear Ovf_FIXED_CTR0 bit. - /// If CPUID.0AH: EDX[4:0] > n. - /// Clear bitmask. Only the first n-1 bits are valid. - /// Bits 22:n are reserved. - /// - UINT32 Ovf_FIXED_CTRn:23; - /// - /// [Bit 55] Set 1 to Clear Trace_ToPA_PMI bit. If (CPUID.(EAX=3D07H, - /// ECX=3D0):EBX[25] =3D 1) && IA32_RTIT_CTL.ToPA =3D 1. - /// - UINT32 Trace_ToPA_PMI:1; - UINT32 Reserved2:5; - /// - /// [Bit 61] Set 1 to Clear Ovf_Uncore bit. Introduced at Display Fami= ly / - /// Display Model 06_2EH. - /// - UINT32 Ovf_Uncore:1; - /// - /// [Bit 62] Set 1 to Clear OvfBuf: bit. If CPUID.0AH: EAX[7:0] > 0. - /// - UINT32 OvfBuf:1; - /// - /// [Bit 63] Set to 1to clear CondChgd: bit. If CPUID.0AH: EAX[7:0] > = 0. - /// - UINT32 CondChgd:1; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PERF_GLOBAL_OVF_CTRL_REGISTER; - - -/** - Global Performance Counter Overflow Reset Control (R/W). If CPUID.0AH: - EAX[7:0] > 3. - - @param ECX MSR_IA32_PERF_GLOBAL_STATUS_RESET (0x00000390) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_STATUS_RESET_REG= ISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_STATUS_RESET_REG= ISTER. - - Example usage - @code - MSR_IA32_PERF_GLOBAL_STATUS_RESET_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_STATUS_RESET); - AsmWriteMsr64 (MSR_IA32_PERF_GLOBAL_STATUS_RESET, Msr.Uint64); - @endcode - @note MSR_IA32_PERF_GLOBAL_STATUS_RESET is defined as IA32_PERF_GLOBAL_S= TATUS_RESET in SDM. -**/ -#define MSR_IA32_PERF_GLOBAL_STATUS_RESET 0x00000390 - -/** - MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_STATUS_RESET -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 31:0] Set 1 to Clear Ovf_PMC0 bit. If CPUID.0AH: EAX[15:8] >= n. - /// Clear bitmask. Only the first n-1 bits are valid. - /// Bits 31:n are reserved. - /// - UINT32 Ovf_PMCn:32; - /// - /// [Bits 54:32] Set 1 to Clear Ovf_FIXED_CTR0 bit. - /// If CPUID.0AH: EDX[4:0] > n. - /// Clear bitmask. Only the first n-1 bits are valid. - /// Bits 22:n are reserved. - /// - UINT32 Ovf_FIXED_CTRn:23; - /// - /// [Bit 55] Set 1 to Clear Trace_ToPA_PMI bit. If (CPUID.(EAX=3D07H, - /// ECX=3D0):EBX[25] =3D 1) && IA32_RTIT_CTL.ToPA[8] =3D 1. - /// - UINT32 Trace_ToPA_PMI:1; - UINT32 Reserved2:2; - /// - /// [Bit 58] Set 1 to Clear LBR_Frz bit. If CPUID.0AH: EAX[7:0] > 3. - /// - UINT32 LBR_Frz:1; - /// - /// [Bit 59] Set 1 to Clear CTR_Frz bit. If CPUID.0AH: EAX[7:0] > 3. - /// - UINT32 CTR_Frz:1; - /// - /// [Bit 60] Set 1 to Clear ASCI bit. If CPUID.0AH: EAX[7:0] > 3. - /// - UINT32 ASCI:1; - /// - /// [Bit 61] Set 1 to Clear Ovf_Uncore bit. Introduced at Display Fami= ly / - /// Display Model 06_2EH. - /// - UINT32 Ovf_Uncore:1; - /// - /// [Bit 62] Set 1 to Clear OvfBuf: bit. If CPUID.0AH: EAX[7:0] > 0. - /// - UINT32 OvfBuf:1; - /// - /// [Bit 63] Set to 1to clear CondChgd: bit. If CPUID.0AH: EAX[7:0] > = 0. - /// - UINT32 CondChgd:1; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PERF_GLOBAL_STATUS_RESET_REGISTER; - - -/** - Global Performance Counter Overflow Set Control (R/W). If CPUID.0AH: - EAX[7:0] > 3. - - @param ECX MSR_IA32_PERF_GLOBAL_STATUS_SET (0x00000391) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_STATUS_SET_REGIS= TER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_STATUS_SET_REGIS= TER. - - Example usage - @code - MSR_IA32_PERF_GLOBAL_STATUS_SET_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_STATUS_SET); - AsmWriteMsr64 (MSR_IA32_PERF_GLOBAL_STATUS_SET, Msr.Uint64); - @endcode - @note MSR_IA32_PERF_GLOBAL_STATUS_SET is defined as IA32_PERF_GLOBAL_STA= TUS_SET in SDM. -**/ -#define MSR_IA32_PERF_GLOBAL_STATUS_SET 0x00000391 - -/** - MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_STATUS_SET -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 31:0] Set 1 to cause Ovf_PMCn =3D 1. If CPUID.0AH: EAX[7:0] = > n. - /// Set bitmask. Only the first n-1 bits are valid. - /// Bits 31:n are reserved. - /// - UINT32 Ovf_PMCn:32; - /// - /// [Bits 54:32] Set 1 to cause Ovf_FIXED_CTRn =3D 1. - /// If CPUID.0AH: EAX[7:0] > n. - /// Set bitmask. Only the first n-1 bits are valid. - /// Bits 22:n are reserved. - /// - UINT32 Ovf_FIXED_CTRn:23; - /// - /// [Bit 55] Set 1 to cause Trace_ToPA_PMI =3D 1. If CPUID.0AH: EAX[7:= 0] > 3. - /// - UINT32 Trace_ToPA_PMI:1; - UINT32 Reserved2:2; - /// - /// [Bit 58] Set 1 to cause LBR_Frz =3D 1. If CPUID.0AH: EAX[7:0] > 3. - /// - UINT32 LBR_Frz:1; - /// - /// [Bit 59] Set 1 to cause CTR_Frz =3D 1. If CPUID.0AH: EAX[7:0] > 3. - /// - UINT32 CTR_Frz:1; - /// - /// [Bit 60] Set 1 to cause ASCI =3D 1. If CPUID.0AH: EAX[7:0] > 3. - /// - UINT32 ASCI:1; - /// - /// [Bit 61] Set 1 to cause Ovf_Uncore =3D 1. If CPUID.0AH: EAX[7:0] >= 3. - /// - UINT32 Ovf_Uncore:1; - /// - /// [Bit 62] Set 1 to cause OvfBuf =3D 1. If CPUID.0AH: EAX[7:0] > 3. - /// - UINT32 OvfBuf:1; - UINT32 Reserved3:1; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PERF_GLOBAL_STATUS_SET_REGISTER; - - -/** - Indicator of core perfmon interface is in use (RO). If CPUID.0AH: EAX[7:= 0] > - 3. - - @param ECX MSR_IA32_PERF_GLOBAL_INUSE (0x00000392) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_INUSE_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PERF_GLOBAL_INUSE_REGISTER. - - Example usage - @code - MSR_IA32_PERF_GLOBAL_INUSE_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PERF_GLOBAL_INUSE); - @endcode - @note MSR_IA32_PERF_GLOBAL_INUSE is defined as IA32_PERF_GLOBAL_INUSE in= SDM. -**/ -#define MSR_IA32_PERF_GLOBAL_INUSE 0x00000392 - -/** - MSR information returned for MSR index #MSR_IA32_PERF_GLOBAL_INUSE -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 31:0] IA32_PERFEVTSELn in use. If CPUID.0AH: EAX[7:0] > n. - /// Status bitmask. Only the first n-1 bits are valid. - /// Bits 31:n are reserved. - /// - UINT32 IA32_PERFEVTSELn:32; - /// - /// [Bits 62:32] IA32_FIXED_CTRn in use. - /// If CPUID.0AH: EAX[7:0] > n. - /// Status bitmask. Only the first n-1 bits are valid. - /// Bits 30:n are reserved. - /// - UINT32 IA32_FIXED_CTRn:31; - /// - /// [Bit 63] PMI in use. - /// - UINT32 PMI:1; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PERF_GLOBAL_INUSE_REGISTER; - - -/** - PEBS Control (R/W). - - @param ECX MSR_IA32_PEBS_ENABLE (0x000003F1) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PEBS_ENABLE_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PEBS_ENABLE_REGISTER. - - Example usage - @code - MSR_IA32_PEBS_ENABLE_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PEBS_ENABLE); - AsmWriteMsr64 (MSR_IA32_PEBS_ENABLE, Msr.Uint64); - @endcode - @note MSR_IA32_PEBS_ENABLE is defined as IA32_PEBS_ENABLE in SDM. -**/ -#define MSR_IA32_PEBS_ENABLE 0x000003F1 - -/** - MSR information returned for MSR index #MSR_IA32_PEBS_ENABLE -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Enable PEBS on IA32_PMC0. Introduced at Display Family / - /// Display Model 06_0FH. - /// - UINT32 Enable:1; - /// - /// [Bits 3:1] Reserved or Model specific. - /// - UINT32 Reserved1:3; - UINT32 Reserved2:28; - /// - /// [Bits 35:32] Reserved or Model specific. - /// - UINT32 Reserved3:4; - UINT32 Reserved4:28; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PEBS_ENABLE_REGISTER; - - -/** - MCn_CTL. If IA32_MCG_CAP.CNT > n. - - @param ECX MSR_IA32_MCn_CTL - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MC0_CTL); - AsmWriteMsr64 (MSR_IA32_MC0_CTL, Msr); - @endcode - @note MSR_IA32_MC0_CTL is defined as IA32_MC0_CTL in SDM. - MSR_IA32_MC1_CTL is defined as IA32_MC1_CTL in SDM. - MSR_IA32_MC2_CTL is defined as IA32_MC2_CTL in SDM. - MSR_IA32_MC3_CTL is defined as IA32_MC3_CTL in SDM. - MSR_IA32_MC4_CTL is defined as IA32_MC4_CTL in SDM. - MSR_IA32_MC5_CTL is defined as IA32_MC5_CTL in SDM. - MSR_IA32_MC6_CTL is defined as IA32_MC6_CTL in SDM. - MSR_IA32_MC7_CTL is defined as IA32_MC7_CTL in SDM. - MSR_IA32_MC8_CTL is defined as IA32_MC8_CTL in SDM. - MSR_IA32_MC9_CTL is defined as IA32_MC9_CTL in SDM. - MSR_IA32_MC10_CTL is defined as IA32_MC10_CTL in SDM. - MSR_IA32_MC11_CTL is defined as IA32_MC11_CTL in SDM. - MSR_IA32_MC12_CTL is defined as IA32_MC12_CTL in SDM. - MSR_IA32_MC13_CTL is defined as IA32_MC13_CTL in SDM. - MSR_IA32_MC14_CTL is defined as IA32_MC14_CTL in SDM. - MSR_IA32_MC15_CTL is defined as IA32_MC15_CTL in SDM. - MSR_IA32_MC16_CTL is defined as IA32_MC16_CTL in SDM. - MSR_IA32_MC17_CTL is defined as IA32_MC17_CTL in SDM. - MSR_IA32_MC18_CTL is defined as IA32_MC18_CTL in SDM. - MSR_IA32_MC19_CTL is defined as IA32_MC19_CTL in SDM. - MSR_IA32_MC20_CTL is defined as IA32_MC20_CTL in SDM. - MSR_IA32_MC21_CTL is defined as IA32_MC21_CTL in SDM. - MSR_IA32_MC22_CTL is defined as IA32_MC22_CTL in SDM. - MSR_IA32_MC23_CTL is defined as IA32_MC23_CTL in SDM. - MSR_IA32_MC24_CTL is defined as IA32_MC24_CTL in SDM. - MSR_IA32_MC25_CTL is defined as IA32_MC25_CTL in SDM. - MSR_IA32_MC26_CTL is defined as IA32_MC26_CTL in SDM. - MSR_IA32_MC27_CTL is defined as IA32_MC27_CTL in SDM. - MSR_IA32_MC28_CTL is defined as IA32_MC28_CTL in SDM. - @{ -**/ -#define MSR_IA32_MC0_CTL 0x00000400 -#define MSR_IA32_MC1_CTL 0x00000404 -#define MSR_IA32_MC2_CTL 0x00000408 -#define MSR_IA32_MC3_CTL 0x0000040C -#define MSR_IA32_MC4_CTL 0x00000410 -#define MSR_IA32_MC5_CTL 0x00000414 -#define MSR_IA32_MC6_CTL 0x00000418 -#define MSR_IA32_MC7_CTL 0x0000041C -#define MSR_IA32_MC8_CTL 0x00000420 -#define MSR_IA32_MC9_CTL 0x00000424 -#define MSR_IA32_MC10_CTL 0x00000428 -#define MSR_IA32_MC11_CTL 0x0000042C -#define MSR_IA32_MC12_CTL 0x00000430 -#define MSR_IA32_MC13_CTL 0x00000434 -#define MSR_IA32_MC14_CTL 0x00000438 -#define MSR_IA32_MC15_CTL 0x0000043C -#define MSR_IA32_MC16_CTL 0x00000440 -#define MSR_IA32_MC17_CTL 0x00000444 -#define MSR_IA32_MC18_CTL 0x00000448 -#define MSR_IA32_MC19_CTL 0x0000044C -#define MSR_IA32_MC20_CTL 0x00000450 -#define MSR_IA32_MC21_CTL 0x00000454 -#define MSR_IA32_MC22_CTL 0x00000458 -#define MSR_IA32_MC23_CTL 0x0000045C -#define MSR_IA32_MC24_CTL 0x00000460 -#define MSR_IA32_MC25_CTL 0x00000464 -#define MSR_IA32_MC26_CTL 0x00000468 -#define MSR_IA32_MC27_CTL 0x0000046C -#define MSR_IA32_MC28_CTL 0x00000470 -/// @} - - -/** - MCn_STATUS. If IA32_MCG_CAP.CNT > n. - - @param ECX MSR_IA32_MCn_STATUS - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MC0_STATUS); - AsmWriteMsr64 (MSR_IA32_MC0_STATUS, Msr); - @endcode - @note MSR_IA32_MC0_STATUS is defined as IA32_MC0_STATUS in SDM. - MSR_IA32_MC1_STATUS is defined as IA32_MC1_STATUS in SDM. - MSR_IA32_MC2_STATUS is defined as IA32_MC2_STATUS in SDM. - MSR_IA32_MC3_STATUS is defined as IA32_MC3_STATUS in SDM. - MSR_IA32_MC4_STATUS is defined as IA32_MC4_STATUS in SDM. - MSR_IA32_MC5_STATUS is defined as IA32_MC5_STATUS in SDM. - MSR_IA32_MC6_STATUS is defined as IA32_MC6_STATUS in SDM. - MSR_IA32_MC7_STATUS is defined as IA32_MC7_STATUS in SDM. - MSR_IA32_MC8_STATUS is defined as IA32_MC8_STATUS in SDM. - MSR_IA32_MC9_STATUS is defined as IA32_MC9_STATUS in SDM. - MSR_IA32_MC10_STATUS is defined as IA32_MC10_STATUS in SDM. - MSR_IA32_MC11_STATUS is defined as IA32_MC11_STATUS in SDM. - MSR_IA32_MC12_STATUS is defined as IA32_MC12_STATUS in SDM. - MSR_IA32_MC13_STATUS is defined as IA32_MC13_STATUS in SDM. - MSR_IA32_MC14_STATUS is defined as IA32_MC14_STATUS in SDM. - MSR_IA32_MC15_STATUS is defined as IA32_MC15_STATUS in SDM. - MSR_IA32_MC16_STATUS is defined as IA32_MC16_STATUS in SDM. - MSR_IA32_MC17_STATUS is defined as IA32_MC17_STATUS in SDM. - MSR_IA32_MC18_STATUS is defined as IA32_MC18_STATUS in SDM. - MSR_IA32_MC19_STATUS is defined as IA32_MC19_STATUS in SDM. - MSR_IA32_MC20_STATUS is defined as IA32_MC20_STATUS in SDM. - MSR_IA32_MC21_STATUS is defined as IA32_MC21_STATUS in SDM. - MSR_IA32_MC22_STATUS is defined as IA32_MC22_STATUS in SDM. - MSR_IA32_MC23_STATUS is defined as IA32_MC23_STATUS in SDM. - MSR_IA32_MC24_STATUS is defined as IA32_MC24_STATUS in SDM. - MSR_IA32_MC25_STATUS is defined as IA32_MC25_STATUS in SDM. - MSR_IA32_MC26_STATUS is defined as IA32_MC26_STATUS in SDM. - MSR_IA32_MC27_STATUS is defined as IA32_MC27_STATUS in SDM. - MSR_IA32_MC28_STATUS is defined as IA32_MC28_STATUS in SDM. - @{ -**/ -#define MSR_IA32_MC0_STATUS 0x00000401 -#define MSR_IA32_MC1_STATUS 0x00000405 -#define MSR_IA32_MC2_STATUS 0x00000409 -#define MSR_IA32_MC3_STATUS 0x0000040D -#define MSR_IA32_MC4_STATUS 0x00000411 -#define MSR_IA32_MC5_STATUS 0x00000415 -#define MSR_IA32_MC6_STATUS 0x00000419 -#define MSR_IA32_MC7_STATUS 0x0000041D -#define MSR_IA32_MC8_STATUS 0x00000421 -#define MSR_IA32_MC9_STATUS 0x00000425 -#define MSR_IA32_MC10_STATUS 0x00000429 -#define MSR_IA32_MC11_STATUS 0x0000042D -#define MSR_IA32_MC12_STATUS 0x00000431 -#define MSR_IA32_MC13_STATUS 0x00000435 -#define MSR_IA32_MC14_STATUS 0x00000439 -#define MSR_IA32_MC15_STATUS 0x0000043D -#define MSR_IA32_MC16_STATUS 0x00000441 -#define MSR_IA32_MC17_STATUS 0x00000445 -#define MSR_IA32_MC18_STATUS 0x00000449 -#define MSR_IA32_MC19_STATUS 0x0000044D -#define MSR_IA32_MC20_STATUS 0x00000451 -#define MSR_IA32_MC21_STATUS 0x00000455 -#define MSR_IA32_MC22_STATUS 0x00000459 -#define MSR_IA32_MC23_STATUS 0x0000045D -#define MSR_IA32_MC24_STATUS 0x00000461 -#define MSR_IA32_MC25_STATUS 0x00000465 -#define MSR_IA32_MC26_STATUS 0x00000469 -#define MSR_IA32_MC27_STATUS 0x0000046D -#define MSR_IA32_MC28_STATUS 0x00000471 -/// @} - - -/** - MCn_ADDR. If IA32_MCG_CAP.CNT > n. - - @param ECX MSR_IA32_MCn_ADDR - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MC0_ADDR); - AsmWriteMsr64 (MSR_IA32_MC0_ADDR, Msr); - @endcode - @note MSR_IA32_MC0_ADDR is defined as IA32_MC0_ADDR in SDM. - MSR_IA32_MC1_ADDR is defined as IA32_MC1_ADDR in SDM. - MSR_IA32_MC2_ADDR is defined as IA32_MC2_ADDR in SDM. - MSR_IA32_MC3_ADDR is defined as IA32_MC3_ADDR in SDM. - MSR_IA32_MC4_ADDR is defined as IA32_MC4_ADDR in SDM. - MSR_IA32_MC5_ADDR is defined as IA32_MC5_ADDR in SDM. - MSR_IA32_MC6_ADDR is defined as IA32_MC6_ADDR in SDM. - MSR_IA32_MC7_ADDR is defined as IA32_MC7_ADDR in SDM. - MSR_IA32_MC8_ADDR is defined as IA32_MC8_ADDR in SDM. - MSR_IA32_MC9_ADDR is defined as IA32_MC9_ADDR in SDM. - MSR_IA32_MC10_ADDR is defined as IA32_MC10_ADDR in SDM. - MSR_IA32_MC11_ADDR is defined as IA32_MC11_ADDR in SDM. - MSR_IA32_MC12_ADDR is defined as IA32_MC12_ADDR in SDM. - MSR_IA32_MC13_ADDR is defined as IA32_MC13_ADDR in SDM. - MSR_IA32_MC14_ADDR is defined as IA32_MC14_ADDR in SDM. - MSR_IA32_MC15_ADDR is defined as IA32_MC15_ADDR in SDM. - MSR_IA32_MC16_ADDR is defined as IA32_MC16_ADDR in SDM. - MSR_IA32_MC17_ADDR is defined as IA32_MC17_ADDR in SDM. - MSR_IA32_MC18_ADDR is defined as IA32_MC18_ADDR in SDM. - MSR_IA32_MC19_ADDR is defined as IA32_MC19_ADDR in SDM. - MSR_IA32_MC20_ADDR is defined as IA32_MC20_ADDR in SDM. - MSR_IA32_MC21_ADDR is defined as IA32_MC21_ADDR in SDM. - MSR_IA32_MC22_ADDR is defined as IA32_MC22_ADDR in SDM. - MSR_IA32_MC23_ADDR is defined as IA32_MC23_ADDR in SDM. - MSR_IA32_MC24_ADDR is defined as IA32_MC24_ADDR in SDM. - MSR_IA32_MC25_ADDR is defined as IA32_MC25_ADDR in SDM. - MSR_IA32_MC26_ADDR is defined as IA32_MC26_ADDR in SDM. - MSR_IA32_MC27_ADDR is defined as IA32_MC27_ADDR in SDM. - MSR_IA32_MC28_ADDR is defined as IA32_MC28_ADDR in SDM. - @{ -**/ -#define MSR_IA32_MC0_ADDR 0x00000402 -#define MSR_IA32_MC1_ADDR 0x00000406 -#define MSR_IA32_MC2_ADDR 0x0000040A -#define MSR_IA32_MC3_ADDR 0x0000040E -#define MSR_IA32_MC4_ADDR 0x00000412 -#define MSR_IA32_MC5_ADDR 0x00000416 -#define MSR_IA32_MC6_ADDR 0x0000041A -#define MSR_IA32_MC7_ADDR 0x0000041E -#define MSR_IA32_MC8_ADDR 0x00000422 -#define MSR_IA32_MC9_ADDR 0x00000426 -#define MSR_IA32_MC10_ADDR 0x0000042A -#define MSR_IA32_MC11_ADDR 0x0000042E -#define MSR_IA32_MC12_ADDR 0x00000432 -#define MSR_IA32_MC13_ADDR 0x00000436 -#define MSR_IA32_MC14_ADDR 0x0000043A -#define MSR_IA32_MC15_ADDR 0x0000043E -#define MSR_IA32_MC16_ADDR 0x00000442 -#define MSR_IA32_MC17_ADDR 0x00000446 -#define MSR_IA32_MC18_ADDR 0x0000044A -#define MSR_IA32_MC19_ADDR 0x0000044E -#define MSR_IA32_MC20_ADDR 0x00000452 -#define MSR_IA32_MC21_ADDR 0x00000456 -#define MSR_IA32_MC22_ADDR 0x0000045A -#define MSR_IA32_MC23_ADDR 0x0000045E -#define MSR_IA32_MC24_ADDR 0x00000462 -#define MSR_IA32_MC25_ADDR 0x00000466 -#define MSR_IA32_MC26_ADDR 0x0000046A -#define MSR_IA32_MC27_ADDR 0x0000046E -#define MSR_IA32_MC28_ADDR 0x00000472 -/// @} - - -/** - MCn_MISC. If IA32_MCG_CAP.CNT > n. - - @param ECX MSR_IA32_MCn_MISC - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_MC0_MISC); - AsmWriteMsr64 (MSR_IA32_MC0_MISC, Msr); - @endcode - @note MSR_IA32_MC0_MISC is defined as IA32_MC0_MISC in SDM. - MSR_IA32_MC1_MISC is defined as IA32_MC1_MISC in SDM. - MSR_IA32_MC2_MISC is defined as IA32_MC2_MISC in SDM. - MSR_IA32_MC3_MISC is defined as IA32_MC3_MISC in SDM. - MSR_IA32_MC4_MISC is defined as IA32_MC4_MISC in SDM. - MSR_IA32_MC5_MISC is defined as IA32_MC5_MISC in SDM. - MSR_IA32_MC6_MISC is defined as IA32_MC6_MISC in SDM. - MSR_IA32_MC7_MISC is defined as IA32_MC7_MISC in SDM. - MSR_IA32_MC8_MISC is defined as IA32_MC8_MISC in SDM. - MSR_IA32_MC9_MISC is defined as IA32_MC9_MISC in SDM. - MSR_IA32_MC10_MISC is defined as IA32_MC10_MISC in SDM. - MSR_IA32_MC11_MISC is defined as IA32_MC11_MISC in SDM. - MSR_IA32_MC12_MISC is defined as IA32_MC12_MISC in SDM. - MSR_IA32_MC13_MISC is defined as IA32_MC13_MISC in SDM. - MSR_IA32_MC14_MISC is defined as IA32_MC14_MISC in SDM. - MSR_IA32_MC15_MISC is defined as IA32_MC15_MISC in SDM. - MSR_IA32_MC16_MISC is defined as IA32_MC16_MISC in SDM. - MSR_IA32_MC17_MISC is defined as IA32_MC17_MISC in SDM. - MSR_IA32_MC18_MISC is defined as IA32_MC18_MISC in SDM. - MSR_IA32_MC19_MISC is defined as IA32_MC19_MISC in SDM. - MSR_IA32_MC20_MISC is defined as IA32_MC20_MISC in SDM. - MSR_IA32_MC21_MISC is defined as IA32_MC21_MISC in SDM. - MSR_IA32_MC22_MISC is defined as IA32_MC22_MISC in SDM. - MSR_IA32_MC23_MISC is defined as IA32_MC23_MISC in SDM. - MSR_IA32_MC24_MISC is defined as IA32_MC24_MISC in SDM. - MSR_IA32_MC25_MISC is defined as IA32_MC25_MISC in SDM. - MSR_IA32_MC26_MISC is defined as IA32_MC26_MISC in SDM. - MSR_IA32_MC27_MISC is defined as IA32_MC27_MISC in SDM. - MSR_IA32_MC28_MISC is defined as IA32_MC28_MISC in SDM. - @{ -**/ -#define MSR_IA32_MC0_MISC 0x00000403 -#define MSR_IA32_MC1_MISC 0x00000407 -#define MSR_IA32_MC2_MISC 0x0000040B -#define MSR_IA32_MC3_MISC 0x0000040F -#define MSR_IA32_MC4_MISC 0x00000413 -#define MSR_IA32_MC5_MISC 0x00000417 -#define MSR_IA32_MC6_MISC 0x0000041B -#define MSR_IA32_MC7_MISC 0x0000041F -#define MSR_IA32_MC8_MISC 0x00000423 -#define MSR_IA32_MC9_MISC 0x00000427 -#define MSR_IA32_MC10_MISC 0x0000042B -#define MSR_IA32_MC11_MISC 0x0000042F -#define MSR_IA32_MC12_MISC 0x00000433 -#define MSR_IA32_MC13_MISC 0x00000437 -#define MSR_IA32_MC14_MISC 0x0000043B -#define MSR_IA32_MC15_MISC 0x0000043F -#define MSR_IA32_MC16_MISC 0x00000443 -#define MSR_IA32_MC17_MISC 0x00000447 -#define MSR_IA32_MC18_MISC 0x0000044B -#define MSR_IA32_MC19_MISC 0x0000044F -#define MSR_IA32_MC20_MISC 0x00000453 -#define MSR_IA32_MC21_MISC 0x00000457 -#define MSR_IA32_MC22_MISC 0x0000045B -#define MSR_IA32_MC23_MISC 0x0000045F -#define MSR_IA32_MC24_MISC 0x00000463 -#define MSR_IA32_MC25_MISC 0x00000467 -#define MSR_IA32_MC26_MISC 0x0000046B -#define MSR_IA32_MC27_MISC 0x0000046F -#define MSR_IA32_MC28_MISC 0x00000473 -/// @} - - -/** - Reporting Register of Basic VMX Capabilities (R/O) See Appendix A.1, "B= asic - VMX Information.". If CPUID.01H:ECX.[5] =3D 1. - - @param ECX MSR_IA32_VMX_BASIC (0x00000480) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - MSR_IA32_VMX_BASIC_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_VMX_BASIC); - @endcode - @note MSR_IA32_VMX_BASIC is defined as IA32_VMX_BASIC in SDM. -**/ -#define MSR_IA32_VMX_BASIC 0x00000480 - -/** - MSR information returned for MSR index #MSR_IA32_VMX_BASIC -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 30:0] VMCS revision identifier used by the processor. Proce= ssors - /// that use the same VMCS revision identifier use the same size for V= MCS - /// regions (see subsequent item on bits 44:32). - /// - /// @note Earlier versions of this manual specified that the VMCS revi= sion - /// identifier was a 32-bit field in bits 31:0 of this MSR. For all - /// processors produced prior to this change, bit 31 of this MSR was r= ead - /// as 0. - /// - UINT32 VmcsRevisonId:31; - UINT32 MustBeZero:1; - /// - /// [Bit 44:32] Reports the number of bytes that software should alloc= ate - /// for the VMXON region and any VMCS region. It is a value greater t= han - /// 0 and at most 4096(bit 44 is set if and only if bits 43:32 are cle= ar). - /// - UINT32 VmcsSize:13; - UINT32 Reserved1:3; - /// - /// [Bit 48] Indicates the width of the physical addresses that may be= used - /// for the VMXON region, each VMCS, and data structures referenced by - /// pointers in a VMCS (I/O bitmaps, virtual-APIC page, MSR areas for = VMX - /// transitions). If the bit is 0, these addresses are limited to the - /// processor's physical-address width. If the bit is 1, these addres= ses - /// are limited to 32 bits. This bit is always 0 for processors that - /// support Intel 64 architecture. - /// - /// @note On processors that support Intel 64 architecture, the pointer - /// must not set bits beyond the processor's physical address width. - /// - UINT32 VmcsAddressWidth:1; - /// - /// [Bit 49] If bit 49 is read as 1, the logical processor supports the - /// dual-monitor treatment of system-management interrupts and - /// system-management mode. See Section 34.15 for details of this trea= tment. - /// - UINT32 DualMonitor:1; - /// - /// [Bit 53:50] report the memory type that should be used for the VMC= S, - /// for data structures referenced by pointers in the VMCS (I/O bitmap= s, - /// virtual-APIC page, MSR areas for VMX transitions), and for the MSEG - /// header. If software needs to access these data structures (e.g., to - /// modify the contents of the MSR bitmaps), it can configure the pagi= ng - /// structures to map them into the linear-address space. If it does s= o, - /// it should establish mappings that use the memory type reported bits - /// 53:50 in this MSR. - /// - /// As of this writing, all processors that support VMX operation indi= cate - /// the write-back type. - /// - /// If software needs to access these data structures (e.g., to modify - /// the contents of the MSR bitmaps), it can configure the paging - /// structures to map them into the linear-address space. If it does s= o, - /// it should establish mappings that use the memory type reported in = this - /// MSR. - /// - /// @note Alternatively, software may map any of these regions or - /// structures with the UC memory type. (This may be necessary for the= MSEG - /// header.) Doing so is discouraged unless necessary as it will cause= the - /// performance of software accesses to those structures to suffer. - /// - /// - UINT32 MemoryType:4; - /// - /// [Bit 54] If bit 54 is read as 1, the processor reports information= in - /// the VM-exit instruction-information field on VM exitsdue to execut= ion - /// of the INS and OUTS instructions (see Section 27.2.4). This report= ing - /// is done only if this bit is read as 1. - /// - UINT32 InsOutsReporting:1; - /// - /// [Bit 55] Bit 55 is read as 1 if any VMX controls that default to 1= may - /// be cleared to 0. See Appendix A.2 for details. It also reports sup= port - /// for the VMX capability MSRs IA32_VMX_TRUE_PINBASED_CTLS, - /// IA32_VMX_TRUE_PROCBASED_CTLS, IA32_VMX_TRUE_EXIT_CTLS, and - /// IA32_VMX_TRUE_ENTRY_CTLS. See Appendix A.3.1, Appendix A.3.2, - /// Appendix A.4, and Appendix A.5 for details. - /// - UINT32 VmxControls:1; - UINT32 Reserved2:8; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_VMX_BASIC_REGISTER; - -/// -/// @{ Define value for bit field MSR_IA32_VMX_BASIC_REGISTER.MemoryType -/// -#define MSR_IA32_VMX_BASIC_REGISTER_MEMORY_TYPE_UNCACHEABLE 0x00 -#define MSR_IA32_VMX_BASIC_REGISTER_MEMORY_TYPE_WRITE_BACK 0x06 -/// -/// @} -/// - - -/** - Capability Reporting Register of Pinbased VM-execution Controls (R/O) See - Appendix A.3.1, "Pin-Based VMExecution Controls.". If CPUID.01H:ECX.[5] = =3D 1. - - @param ECX MSR_IA32_VMX_PINBASED_CTLS (0x00000481) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_PINBASED_CTLS); - @endcode - @note MSR_IA32_VMX_PINBASED_CTLS is defined as IA32_VMX_PINBASED_CTLS in= SDM. -**/ -#define MSR_IA32_VMX_PINBASED_CTLS 0x00000481 - - -/** - Capability Reporting Register of Primary Processor-based VM-execution - Controls (R/O) See Appendix A.3.2, "Primary Processor- Based VM-Execution - Controls.". If CPUID.01H:ECX.[5] =3D 1. - - @param ECX MSR_IA32_VMX_PROCBASED_CTLS (0x00000482) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_PROCBASED_CTLS); - @endcode - @note MSR_IA32_VMX_PROCBASED_CTLS is defined as IA32_VMX_PROCBASED_CTLS = in SDM. -**/ -#define MSR_IA32_VMX_PROCBASED_CTLS 0x00000482 - - -/** - Capability Reporting Register of VM-exit Controls (R/O) See Appendix A.= 4, - "VM-Exit Controls.". If CPUID.01H:ECX.[5] =3D 1. - - @param ECX MSR_IA32_VMX_EXIT_CTLS (0x00000483) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_EXIT_CTLS); - @endcode - @note MSR_IA32_VMX_EXIT_CTLS is defined as IA32_VMX_EXIT_CTLS in SDM. -**/ -#define MSR_IA32_VMX_EXIT_CTLS 0x00000483 - - -/** - Capability Reporting Register of VMentry Controls (R/O) See Appendix A.5, - "VM-Entry Controls.". If CPUID.01H:ECX.[5] =3D 1. - - @param ECX MSR_IA32_VMX_ENTRY_CTLS (0x00000484) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_ENTRY_CTLS); - @endcode - @note MSR_IA32_VMX_ENTRY_CTLS is defined as IA32_VMX_ENTRY_CTLS in SDM. -**/ -#define MSR_IA32_VMX_ENTRY_CTLS 0x00000484 - - -/** - Reporting Register of Miscellaneous VMX Capabilities (R/O) See Appendix = A.6, - "Miscellaneous Data.". If CPUID.01H:ECX.[5] =3D 1. - - @param ECX MSR_IA32_VMX_MISC (0x00000485) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - IA32_VMX_MISC_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_VMX_MISC); - @endcode - @note MSR_IA32_VMX_MISC is defined as IA32_VMX_MISC in SDM. -**/ -#define MSR_IA32_VMX_MISC 0x00000485 - -/** - MSR information returned for MSR index #IA32_VMX_MISC -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 4:0] Reports a value X that specifies the relationship betwe= en the - /// rate of the VMX-preemption timer and that of the timestamp counter= (TSC). - /// Specifically, the VMX-preemption timer (if it is active) counts do= wn by - /// 1 every time bit X in the TSC changes due to a TSC increment. - /// - UINT32 VmxTimerRatio:5; - /// - /// [Bit 5] If bit 5 is read as 1, VM exits store the value of IA32_EF= ER.LMA - /// into the "IA-32e mode guest" VM-entry control;see Section 27.2 for= more - /// details. This bit is read as 1 on any logical processor that suppo= rts - /// the 1-setting of the "unrestricted guest" VM-execution control. - /// - UINT32 VmExitEferLma:1; - /// - /// [Bit 6] reports (if set) the support for activity state 1 (HLT). - /// - UINT32 HltActivityStateSupported:1; - /// - /// [Bit 7] reports (if set) the support for activity state 2 (shutdow= n). - /// - UINT32 ShutdownActivityStateSupported:1; - /// - /// [Bit 8] reports (if set) the support for activity state 3 (wait-fo= r-SIPI). - /// - UINT32 WaitForSipiActivityStateSupported:1; - UINT32 Reserved1:5; - /// - /// [Bit 14] If read as 1, Intel(R) Processor Trace (Intel PT) can be = used - /// in VMX operation. If the processor supports Intel PT but does not = allow - /// it to be used in VMX operation, execution of VMXON clears - /// IA32_RTIT_CTL.TraceEn (see "VMXON-Enter VMX Operation" in Chapter = 30); - /// any attempt to set that bit while in VMX operation (including VMX = root - /// operation) using the WRMSR instruction causes a general-protection - /// exception. - /// - UINT32 ProcessorTraceSupported:1; - /// - /// [Bit 15] If read as 1, the RDMSR instruction can be used in system- - /// management mode (SMM) to read the IA32_SMBASE MSR (MSR address 9EH= ). - /// See Section 34.15.6.3. - /// - UINT32 SmBaseMsrSupported:1; - /// - /// [Bits 24:16] Indicate the number of CR3-target values supported by= the - /// processor. This number is a value between 0 and 256, inclusive (bi= t 24 - /// is set if and only if bits 23:16 are clear). - /// - UINT32 NumberOfCr3TargetValues:9; - /// - /// [Bit 27:25] Bits 27:25 is used to compute the recommended maximum - /// number of MSRs that should appear in the VM-exit MSR-store list, t= he - /// VM-exit MSR-load list, or the VM-entry MSR-load list. Specifically= , if - /// the value bits 27:25 of IA32_VMX_MISC is N, then 512 * (N + 1) is = the - /// recommended maximum number of MSRs to be included in each list. If= the - /// limit is exceeded, undefined processor behavior may result (includ= ing a - /// machine check during the VMX transition). - /// - UINT32 MsrStoreListMaximum:3; - /// - /// [Bit 28] If read as 1, bit 2 of the IA32_SMM_MONITOR_CTL can be set - /// to 1. VMXOFF unblocks SMIs unless IA32_SMM_MONITOR_CTL[bit 2] is 1 - /// (see Section 34.14.4). - /// - UINT32 BlockSmiSupported:1; - /// - /// [Bit 29] read as 1, software can use VMWRITE to write to any suppo= rted - /// field in the VMCS; otherwise, VMWRITE cannot be used to modify VM-= exit - /// information fields. - /// - UINT32 VmWriteSupported:1; - /// - /// [Bit 30] If read as 1, VM entry allows injection of a software - /// interrupt, software exception, or privileged software exception wi= th an - /// instruction length of 0. - /// - UINT32 VmInjectSupported:1; - UINT32 Reserved2:1; - /// - /// [Bits 63:32] Reports the 32-bit MSEG revision identifier used by t= he - /// processor. - /// - UINT32 MsegRevisionIdentifier:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} IA32_VMX_MISC_REGISTER; - - -/** - Capability Reporting Register of CR0 Bits Fixed to 0 (R/O) See Appendix = A.7, - "VMX-Fixed Bits in CR0.". If CPUID.01H:ECX.[5] =3D 1. - - @param ECX MSR_IA32_VMX_CR0_FIXED0 (0x00000486) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_CR0_FIXED0); - @endcode - @note MSR_IA32_VMX_CR0_FIXED0 is defined as IA32_VMX_CR0_FIXED0 in SDM. -**/ -#define MSR_IA32_VMX_CR0_FIXED0 0x00000486 - - -/** - Capability Reporting Register of CR0 Bits Fixed to 1 (R/O) See Appendix = A.7, - "VMX-Fixed Bits in CR0.". If CPUID.01H:ECX.[5] =3D 1. - - @param ECX MSR_IA32_VMX_CR0_FIXED1 (0x00000487) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_CR0_FIXED1); - @endcode - @note MSR_IA32_VMX_CR0_FIXED1 is defined as IA32_VMX_CR0_FIXED1 in SDM. -**/ -#define MSR_IA32_VMX_CR0_FIXED1 0x00000487 - - -/** - Capability Reporting Register of CR4 Bits Fixed to 0 (R/O) See Appendix = A.8, - "VMX-Fixed Bits in CR4.". If CPUID.01H:ECX.[5] =3D 1. - - @param ECX MSR_IA32_VMX_CR4_FIXED0 (0x00000488) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_CR4_FIXED0); - @endcode - @note MSR_IA32_VMX_CR4_FIXED0 is defined as IA32_VMX_CR4_FIXED0 in SDM. -**/ -#define MSR_IA32_VMX_CR4_FIXED0 0x00000488 - - -/** - Capability Reporting Register of CR4 Bits Fixed to 1 (R/O) See Appendix = A.8, - "VMX-Fixed Bits in CR4.". If CPUID.01H:ECX.[5] =3D 1. - - @param ECX MSR_IA32_VMX_CR4_FIXED1 (0x00000489) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_CR4_FIXED1); - @endcode - @note MSR_IA32_VMX_CR4_FIXED1 is defined as IA32_VMX_CR4_FIXED1 in SDM. -**/ -#define MSR_IA32_VMX_CR4_FIXED1 0x00000489 - - -/** - Capability Reporting Register of VMCS Field Enumeration (R/O) See Append= ix - A.9, "VMCS Enumeration.". If CPUID.01H:ECX.[5] =3D 1. - - @param ECX MSR_IA32_VMX_VMCS_ENUM (0x0000048A) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_VMCS_ENUM); - @endcode - @note MSR_IA32_VMX_VMCS_ENUM is defined as IA32_VMX_VMCS_ENUM in SDM. -**/ -#define MSR_IA32_VMX_VMCS_ENUM 0x0000048A - - -/** - Capability Reporting Register of Secondary Processor-based VM-execution - Controls (R/O) See Appendix A.3.3, "Secondary Processor- Based VM-Execut= ion - Controls.". If ( CPUID.01H:ECX.[5] && IA32_VMX_PROCBASED_C TLS[63]). - - @param ECX MSR_IA32_VMX_PROCBASED_CTLS2 (0x0000048B) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_PROCBASED_CTLS2); - @endcode - @note MSR_IA32_VMX_PROCBASED_CTLS2 is defined as IA32_VMX_PROCBASED_CTLS= 2 in SDM. -**/ -#define MSR_IA32_VMX_PROCBASED_CTLS2 0x0000048B - - -/** - Capability Reporting Register of EPT and VPID (R/O) See Appendix A.10, - "VPID and EPT Capabilities.". If ( CPUID.01H:ECX.[5] && IA32_VMX_PROCBAS= ED_C - TLS[63] && ( IA32_VMX_PROCBASED_C TLS2[33] IA32_VMX_PROCBASED_C TLS2[37]= ) ). - - @param ECX MSR_IA32_VMX_EPT_VPID_CAP (0x0000048C) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_EPT_VPID_CAP); - @endcode - @note MSR_IA32_VMX_EPT_VPID_CAP is defined as IA32_VMX_EPT_VPID_CAP in S= DM. -**/ -#define MSR_IA32_VMX_EPT_VPID_CAP 0x0000048C - - -/** - Capability Reporting Register of Pinbased VM-execution Flex Controls (R/= O) - See Appendix A.3.1, "Pin-Based VMExecution Controls.". If ( - CPUID.01H:ECX.[5] =3D 1 && IA32_VMX_BASIC[55] ). - - @param ECX MSR_IA32_VMX_TRUE_PINBASED_CTLS (0x0000048D) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_TRUE_PINBASED_CTLS); - @endcode - @note MSR_IA32_VMX_TRUE_PINBASED_CTLS is defined as IA32_VMX_TRUE_PINBAS= ED_CTLS in SDM. -**/ -#define MSR_IA32_VMX_TRUE_PINBASED_CTLS 0x0000048D - - -/** - Capability Reporting Register of Primary Processor-based VM-execution F= lex - Controls (R/O) See Appendix A.3.2, "Primary Processor- Based VM-Execution - Controls.". If( CPUID.01H:ECX.[5] =3D 1 && IA32_VMX_BASIC[55] ). - - @param ECX MSR_IA32_VMX_TRUE_PROCBASED_CTLS (0x0000048E) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_TRUE_PROCBASED_CTLS); - @endcode - @note MSR_IA32_VMX_TRUE_PROCBASED_CTLS is defined as IA32_VMX_TRUE_PROCB= ASED_CTLS in SDM. -**/ -#define MSR_IA32_VMX_TRUE_PROCBASED_CTLS 0x0000048E - - -/** - Capability Reporting Register of VM-exit Flex Controls (R/O) See Append= ix - A.4, "VM-Exit Controls.". If( CPUID.01H:ECX.[5] =3D 1 && IA32_VMX_BASIC[= 55] ). - - @param ECX MSR_IA32_VMX_TRUE_EXIT_CTLS (0x0000048F) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_TRUE_EXIT_CTLS); - @endcode - @note MSR_IA32_VMX_TRUE_EXIT_CTLS is defined as IA32_VMX_TRUE_EXIT_CTLS = in SDM. -**/ -#define MSR_IA32_VMX_TRUE_EXIT_CTLS 0x0000048F - - -/** - Capability Reporting Register of VMentry Flex Controls (R/O) See Appendix - A.5, "VM-Entry Controls.". If( CPUID.01H:ECX.[5] =3D 1 && IA32_VMX_BASIC= [55] ). - - @param ECX MSR_IA32_VMX_TRUE_ENTRY_CTLS (0x00000490) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_TRUE_ENTRY_CTLS); - @endcode - @note MSR_IA32_VMX_TRUE_ENTRY_CTLS is defined as IA32_VMX_TRUE_ENTRY_CTL= S in SDM. -**/ -#define MSR_IA32_VMX_TRUE_ENTRY_CTLS 0x00000490 - - -/** - Capability Reporting Register of VMfunction Controls (R/O). If( - CPUID.01H:ECX.[5] =3D 1 && IA32_VMX_BASIC[55] ). - - @param ECX MSR_IA32_VMX_VMFUNC (0x00000491) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_VMX_VMFUNC); - @endcode - @note MSR_IA32_VMX_VMFUNC is defined as IA32_VMX_VMFUNC in SDM. -**/ -#define MSR_IA32_VMX_VMFUNC 0x00000491 - - -/** - Full Width Writable IA32_PMCn Alias (R/W). (If CPUID.0AH: EAX[15:8] > n)= && - IA32_PERF_CAPABILITIES[ 13] =3D 1. - - @param ECX MSR_IA32_A_PMCn - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_A_PMC0); - AsmWriteMsr64 (MSR_IA32_A_PMC0, Msr); - @endcode - @note MSR_IA32_A_PMC0 is defined as IA32_A_PMC0 in SDM. - MSR_IA32_A_PMC1 is defined as IA32_A_PMC1 in SDM. - MSR_IA32_A_PMC2 is defined as IA32_A_PMC2 in SDM. - MSR_IA32_A_PMC3 is defined as IA32_A_PMC3 in SDM. - MSR_IA32_A_PMC4 is defined as IA32_A_PMC4 in SDM. - MSR_IA32_A_PMC5 is defined as IA32_A_PMC5 in SDM. - MSR_IA32_A_PMC6 is defined as IA32_A_PMC6 in SDM. - MSR_IA32_A_PMC7 is defined as IA32_A_PMC7 in SDM. - @{ -**/ -#define MSR_IA32_A_PMC0 0x000004C1 -#define MSR_IA32_A_PMC1 0x000004C2 -#define MSR_IA32_A_PMC2 0x000004C3 -#define MSR_IA32_A_PMC3 0x000004C4 -#define MSR_IA32_A_PMC4 0x000004C5 -#define MSR_IA32_A_PMC5 0x000004C6 -#define MSR_IA32_A_PMC6 0x000004C7 -#define MSR_IA32_A_PMC7 0x000004C8 -/// @} - - -/** - (R/W). If IA32_MCG_CAP.LMCE_P =3D1. - - @param ECX MSR_IA32_MCG_EXT_CTL (0x000004D0) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_MCG_EXT_CTL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_MCG_EXT_CTL_REGISTER. - - Example usage - @code - MSR_IA32_MCG_EXT_CTL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_MCG_EXT_CTL); - AsmWriteMsr64 (MSR_IA32_MCG_EXT_CTL, Msr.Uint64); - @endcode - @note MSR_IA32_MCG_EXT_CTL is defined as IA32_MCG_EXT_CTL in SDM. -**/ -#define MSR_IA32_MCG_EXT_CTL 0x000004D0 - -/** - MSR information returned for MSR index #MSR_IA32_MCG_EXT_CTL -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] LMCE_EN. - /// - UINT32 LMCE_EN:1; - UINT32 Reserved1:31; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_MCG_EXT_CTL_REGISTER; - - -/** - Status and SVN Threshold of SGX Support for ACM (RO). If CPUID.(EAX=3D07= H, - ECX=3D0H): EBX[2] =3D 1. - - @param ECX MSR_IA32_SGX_SVN_STATUS (0x00000500) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_SGX_SVN_STATUS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_SGX_SVN_STATUS_REGISTER. - - Example usage - @code - MSR_IA32_SGX_SVN_STATUS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_SGX_SVN_STATUS); - @endcode - @note MSR_IA32_SGX_SVN_STATUS is defined as IA32_SGX_SVN_STATUS in SDM. -**/ -#define MSR_IA32_SGX_SVN_STATUS 0x00000500 - -/** - MSR information returned for MSR index #MSR_IA32_SGX_SVN_STATUS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Lock. See Section 41.11.3, "Interactions with Authenticated - /// Code Modules (ACMs)". - /// - UINT32 Lock:1; - UINT32 Reserved1:15; - /// - /// [Bits 23:16] SGX_SVN_SINIT. See Section 41.11.3, "Interactions with - /// Authenticated Code Modules (ACMs)". - /// - UINT32 SGX_SVN_SINIT:8; - UINT32 Reserved2:8; - UINT32 Reserved3:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_SGX_SVN_STATUS_REGISTER; - - -/** - Trace Output Base Register (R/W). If ((CPUID.(EAX=3D07H, ECX=3D0):EBX[25= ] =3D 1) - && ( (CPUID.(EAX=3D14H,ECX=3D0): ECX[0] =3D 1) (CPUID.(EAX=3D14H,ECX=3D0= ): ECX[2] =3D 1) - ) ). - - @param ECX MSR_IA32_RTIT_OUTPUT_BASE (0x00000560) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_OUTPUT_BASE_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_OUTPUT_BASE_REGISTER. - - Example usage - @code - MSR_IA32_RTIT_OUTPUT_BASE_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_OUTPUT_BASE); - AsmWriteMsr64 (MSR_IA32_RTIT_OUTPUT_BASE, Msr.Uint64); - @endcode - @note MSR_IA32_RTIT_OUTPUT_BASE is defined as IA32_RTIT_OUTPUT_BASE in S= DM. -**/ -#define MSR_IA32_RTIT_OUTPUT_BASE 0x00000560 - -/** - MSR information returned for MSR index #MSR_IA32_RTIT_OUTPUT_BASE -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved:7; - /// - /// [Bits 31:7] Base physical address. - /// - UINT32 Base:25; - /// - /// [Bits 63:32] Base physical address. - /// - UINT32 BaseHi:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_RTIT_OUTPUT_BASE_REGISTER; - - -/** - Trace Output Mask Pointers Register (R/W). If ((CPUID.(EAX=3D07H, - ECX=3D0):EBX[25] =3D 1) && ( (CPUID.(EAX=3D14H,ECX=3D0): ECX[0] =3D 1) - (CPUID.(EAX=3D14H,ECX=3D0): ECX[2] =3D 1) ) ). - - @param ECX MSR_IA32_RTIT_OUTPUT_MASK_PTRS (0x00000561) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_OUTPUT_MASK_PTRS_REGIST= ER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_OUTPUT_MASK_PTRS_REGIST= ER. - - Example usage - @code - MSR_IA32_RTIT_OUTPUT_MASK_PTRS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_OUTPUT_MASK_PTRS); - AsmWriteMsr64 (MSR_IA32_RTIT_OUTPUT_MASK_PTRS, Msr.Uint64); - @endcode - @note MSR_IA32_RTIT_OUTPUT_MASK_PTRS is defined as IA32_RTIT_OUTPUT_MASK= _PTRS in SDM. -**/ -#define MSR_IA32_RTIT_OUTPUT_MASK_PTRS 0x00000561 - -/** - MSR information returned for MSR index #MSR_IA32_RTIT_OUTPUT_MASK_PTRS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved:7; - /// - /// [Bits 31:7] MaskOrTableOffset. - /// - UINT32 MaskOrTableOffset:25; - /// - /// [Bits 63:32] Output Offset. - /// - UINT32 OutputOffset:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_RTIT_OUTPUT_MASK_PTRS_REGISTER; - -/** - Format of ToPA table entries. -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] END. See Section 35.2.6.2, "Table of Physical Addresses (T= oPA)". - /// - UINT32 END:1; - UINT32 Reserved1:1; - /// - /// [Bit 2] INT. See Section 35.2.6.2, "Table of Physical Addresses (T= oPA)". - /// - UINT32 INT:1; - UINT32 Reserved2:1; - /// - /// [Bit 4] STOP. See Section 35.2.6.2, "Table of Physical Addresses (= ToPA)". - /// - UINT32 STOP:1; - UINT32 Reserved3:1; - /// - /// [Bit 6:9] Indicates the size of the associated output region. See = Section - /// 35.2.6.2, "Table of Physical Addresses (ToPA)". - /// - UINT32 Size:4; - UINT32 Reserved4:2; - /// - /// [Bit 12:31] Output Region Base Physical Address low part. - /// [Bit 12:31] Output Region Base Physical Address [12:63] value to m= atch. - /// ATTENTION: The size of the address field is determined by the proc= essor's - /// physical-address width (MAXPHYADDR) in bits, as reported in - /// CPUID.80000008H:EAX[7:0]. the above part of address reserved. - /// True address field is [12:MAXPHYADDR-1], [MAXPHYADDR:63] is reserv= ed part. - /// Detail see Section 35.2.6.2, "Table of Physical Addresses (ToPA)". - /// - UINT32 Base:20; - /// - /// [Bit 32:63] Output Region Base Physical Address high part. - /// [Bit 32:63] Output Region Base Physical Address [12:63] value to m= atch. - /// ATTENTION: The size of the address field is determined by the proc= essor's - /// physical-address width (MAXPHYADDR) in bits, as reported in - /// CPUID.80000008H:EAX[7:0]. the above part of address reserved. - /// True address field is [12:MAXPHYADDR-1], [MAXPHYADDR:63] is reserv= ed part. - /// Detail see Section 35.2.6.2, "Table of Physical Addresses (ToPA)". - /// - UINT32 BaseHi:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} RTIT_TOPA_TABLE_ENTRY; - -/// -/// The size of the associated output region usd by Topa. -/// -typedef enum { - RtitTopaMemorySize4K =3D 0, - RtitTopaMemorySize8K, - RtitTopaMemorySize16K, - RtitTopaMemorySize32K, - RtitTopaMemorySize64K, - RtitTopaMemorySize128K, - RtitTopaMemorySize256K, - RtitTopaMemorySize512K, - RtitTopaMemorySize1M, - RtitTopaMemorySize2M, - RtitTopaMemorySize4M, - RtitTopaMemorySize8M, - RtitTopaMemorySize16M, - RtitTopaMemorySize32M, - RtitTopaMemorySize64M, - RtitTopaMemorySize128M -} RTIT_TOPA_MEMORY_SIZE; - -/** - Trace Control Register (R/W). If (CPUID.(EAX=3D07H, ECX=3D0):EBX[25] =3D= 1). - - @param ECX MSR_IA32_RTIT_CTL (0x00000570) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_CTL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_CTL_REGISTER. - - Example usage - @code - MSR_IA32_RTIT_CTL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_CTL); - AsmWriteMsr64 (MSR_IA32_RTIT_CTL, Msr.Uint64); - @endcode - @note MSR_IA32_RTIT_CTL is defined as IA32_RTIT_CTL in SDM. -**/ -#define MSR_IA32_RTIT_CTL 0x00000570 - -/** - MSR information returned for MSR index #MSR_IA32_RTIT_CTL -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] TraceEn. - /// - UINT32 TraceEn:1; - /// - /// [Bit 1] CYCEn. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[1] =3D 1). - /// - UINT32 CYCEn:1; - /// - /// [Bit 2] OS. - /// - UINT32 OS:1; - /// - /// [Bit 3] User. - /// - UINT32 User:1; - /// - /// [Bit 4] PwrEvtEn. - /// - UINT32 PwrEvtEn:1; - /// - /// [Bit 5] FUPonPTW. - /// - UINT32 FUPonPTW:1; - /// - /// [Bit 6] FabricEn. If (CPUID.(EAX=3D07H, ECX=3D0):ECX[3] =3D 1). - /// - UINT32 FabricEn:1; - /// - /// [Bit 7] CR3 filter. - /// - UINT32 CR3:1; - /// - /// [Bit 8] ToPA. - /// - UINT32 ToPA:1; - /// - /// [Bit 9] MTCEn. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[3] =3D 1). - /// - UINT32 MTCEn:1; - /// - /// [Bit 10] TSCEn. - /// - UINT32 TSCEn:1; - /// - /// [Bit 11] DisRETC. - /// - UINT32 DisRETC:1; - /// - /// [Bit 12] PTWEn. - /// - UINT32 PTWEn:1; - /// - /// [Bit 13] BranchEn. - /// - UINT32 BranchEn:1; - /// - /// [Bits 17:14] MTCFreq. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[3] =3D 1). - /// - UINT32 MTCFreq:4; - UINT32 Reserved3:1; - /// - /// [Bits 22:19] CYCThresh. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[1] =3D = 1). - /// - UINT32 CYCThresh:4; - UINT32 Reserved4:1; - /// - /// [Bits 27:24] PSBFreq. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[1] =3D 1). - /// - UINT32 PSBFreq:4; - UINT32 Reserved5:4; - /// - /// [Bits 35:32] ADDR0_CFG. If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > = 0). - /// - UINT32 ADDR0_CFG:4; - /// - /// [Bits 39:36] ADDR1_CFG. If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > = 1). - /// - UINT32 ADDR1_CFG:4; - /// - /// [Bits 43:40] ADDR2_CFG. If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > = 2). - /// - UINT32 ADDR2_CFG:4; - /// - /// [Bits 47:44] ADDR3_CFG. If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > = 3). - /// - UINT32 ADDR3_CFG:4; - UINT32 Reserved6:16; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_RTIT_CTL_REGISTER; - - -/** - Tracing Status Register (R/W). If (CPUID.(EAX=3D07H, ECX=3D0):EBX[25] = =3D 1). - - @param ECX MSR_IA32_RTIT_STATUS (0x00000571) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_STATUS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_STATUS_REGISTER. - - Example usage - @code - MSR_IA32_RTIT_STATUS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_STATUS); - AsmWriteMsr64 (MSR_IA32_RTIT_STATUS, Msr.Uint64); - @endcode - @note MSR_IA32_RTIT_STATUS is defined as IA32_RTIT_STATUS in SDM. -**/ -#define MSR_IA32_RTIT_STATUS 0x00000571 - -/** - MSR information returned for MSR index #MSR_IA32_RTIT_STATUS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] FilterEn, (writes ignored). - /// If (CPUID.(EAX=3D07H, ECX=3D0):EBX[2] =3D 1). - /// - UINT32 FilterEn:1; - /// - /// [Bit 1] ContexEn, (writes ignored). - /// - UINT32 ContexEn:1; - /// - /// [Bit 2] TriggerEn, (writes ignored). - /// - UINT32 TriggerEn:1; - UINT32 Reserved1:1; - /// - /// [Bit 4] Error. - /// - UINT32 Error:1; - /// - /// [Bit 5] Stopped. - /// - UINT32 Stopped:1; - UINT32 Reserved2:26; - /// - /// [Bits 48:32] PacketByteCnt. If (CPUID.(EAX=3D07H, ECX=3D0):EBX[1] = > 3). - /// - UINT32 PacketByteCnt:17; - UINT32 Reserved3:15; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_RTIT_STATUS_REGISTER; - - -/** - Trace Filter CR3 Match Register (R/W). - If (CPUID.(EAX=3D07H, ECX=3D0):EBX[25] =3D 1). - - @param ECX MSR_IA32_RTIT_CR3_MATCH (0x00000572) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_CR3_MATCH_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_CR3_MATCH_REGISTER. - - Example usage - @code - MSR_IA32_RTIT_CR3_MATCH_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_CR3_MATCH); - AsmWriteMsr64 (MSR_IA32_RTIT_CR3_MATCH, Msr.Uint64); - @endcode - @note MSR_IA32_RTIT_CR3_MATCH is defined as IA32_RTIT_CR3_MATCH in SDM. -**/ -#define MSR_IA32_RTIT_CR3_MATCH 0x00000572 - -/** - MSR information returned for MSR index #MSR_IA32_RTIT_CR3_MATCH -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved:5; - /// - /// [Bits 31:5] CR3[63:5] value to match. - /// - UINT32 Cr3:27; - /// - /// [Bits 63:32] CR3[63:5] value to match. - /// - UINT32 Cr3Hi:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_RTIT_CR3_MATCH_REGISTER; - - -/** - Region n Start Address (R/W). If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > = n). - - @param ECX MSR_IA32_RTIT_ADDRn_A - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_ADDR_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_ADDR_REGISTER. - - Example usage - @code - MSR_IA32_RTIT_ADDR_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_ADDR0_A); - AsmWriteMsr64 (MSR_IA32_RTIT_ADDR0_A, Msr.Uint64); - @endcode - @note MSR_IA32_RTIT_ADDR0_A is defined as IA32_RTIT_ADDR0_A in SDM. - MSR_IA32_RTIT_ADDR1_A is defined as IA32_RTIT_ADDR1_A in SDM. - MSR_IA32_RTIT_ADDR2_A is defined as IA32_RTIT_ADDR2_A in SDM. - MSR_IA32_RTIT_ADDR3_A is defined as IA32_RTIT_ADDR3_A in SDM. - @{ -**/ -#define MSR_IA32_RTIT_ADDR0_A 0x00000580 -#define MSR_IA32_RTIT_ADDR1_A 0x00000582 -#define MSR_IA32_RTIT_ADDR2_A 0x00000584 -#define MSR_IA32_RTIT_ADDR3_A 0x00000586 -/// @} - - -/** - Region n End Address (R/W). If (CPUID.(EAX=3D07H, ECX=3D1):EAX[2:0] > n). - - @param ECX MSR_IA32_RTIT_ADDRn_B - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_ADDR_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_RTIT_ADDR_REGISTER. - - Example usage - @code - MSR_IA32_RTIT_ADDR_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_RTIT_ADDR0_B); - AsmWriteMsr64 (MSR_IA32_RTIT_ADDR0_B, Msr.Uint64); - @endcode - @note MSR_IA32_RTIT_ADDR0_B is defined as IA32_RTIT_ADDR0_B in SDM. - MSR_IA32_RTIT_ADDR1_B is defined as IA32_RTIT_ADDR1_B in SDM. - MSR_IA32_RTIT_ADDR2_B is defined as IA32_RTIT_ADDR2_B in SDM. - MSR_IA32_RTIT_ADDR3_B is defined as IA32_RTIT_ADDR3_B in SDM. - @{ -**/ -#define MSR_IA32_RTIT_ADDR0_B 0x00000581 -#define MSR_IA32_RTIT_ADDR1_B 0x00000583 -#define MSR_IA32_RTIT_ADDR2_B 0x00000585 -#define MSR_IA32_RTIT_ADDR3_B 0x00000587 -/// @} - - -/** - MSR information returned for MSR indexes - #MSR_IA32_RTIT_ADDR0_A to #MSR_IA32_RTIT_ADDR3_A and - #MSR_IA32_RTIT_ADDR0_B to #MSR_IA32_RTIT_ADDR3_B -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 31:0] Virtual Address. - /// - UINT32 VirtualAddress:32; - /// - /// [Bits 47:32] Virtual Address. - /// - UINT32 VirtualAddressHi:16; - /// - /// [Bits 63:48] SignExt_VA. - /// - UINT32 SignExt_VA:16; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_RTIT_ADDR_REGISTER; - - -/** - DS Save Area (R/W) Points to the linear address of the first byte of the= DS - buffer management area, which is used to manage the BTS and PEBS buffers. - See Section 18.6.3.4, "Debug Store (DS) Mechanism.". If( - CPUID.01H:EDX.DS[21] =3D 1. The linear address of the first byte of the = DS - buffer management area, if IA-32e mode is active. - - @param ECX MSR_IA32_DS_AREA (0x00000600) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_DS_AREA_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_DS_AREA_REGISTER. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_DS_AREA); - AsmWriteMsr64 (MSR_IA32_DS_AREA, Msr); - @endcode - @note MSR_IA32_DS_AREA is defined as IA32_DS_AREA in SDM. -**/ -#define MSR_IA32_DS_AREA 0x00000600 - - -/** - TSC Target of Local APIC's TSC Deadline Mode (R/W). If CPUID.01H:ECX.[24= ] =3D - 1. - - @param ECX MSR_IA32_TSC_DEADLINE (0x000006E0) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_TSC_DEADLINE); - AsmWriteMsr64 (MSR_IA32_TSC_DEADLINE, Msr); - @endcode - @note MSR_IA32_TSC_DEADLINE is defined as IA32_TSC_DEADLINE in SDM. -**/ -#define MSR_IA32_TSC_DEADLINE 0x000006E0 - - -/** - Enable/disable HWP (R/W). If CPUID.06H:EAX.[7] =3D 1. - - @param ECX MSR_IA32_PM_ENABLE (0x00000770) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PM_ENABLE_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PM_ENABLE_REGISTER. - - Example usage - @code - MSR_IA32_PM_ENABLE_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PM_ENABLE); - AsmWriteMsr64 (MSR_IA32_PM_ENABLE, Msr.Uint64); - @endcode - @note MSR_IA32_PM_ENABLE is defined as IA32_PM_ENABLE in SDM. -**/ -#define MSR_IA32_PM_ENABLE 0x00000770 - -/** - MSR information returned for MSR index #MSR_IA32_PM_ENABLE -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] HWP_ENABLE (R/W1-Once). See Section 14.4.2, "Enabling HWP"= . If - /// CPUID.06H:EAX.[7] =3D 1. - /// - UINT32 HWP_ENABLE:1; - UINT32 Reserved1:31; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PM_ENABLE_REGISTER; - - -/** - HWP Performance Range Enumeration (RO). If CPUID.06H:EAX.[7] =3D 1. - - @param ECX MSR_IA32_HWP_CAPABILITIES (0x00000771) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_HWP_CAPABILITIES_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_HWP_CAPABILITIES_REGISTER. - - Example usage - @code - MSR_IA32_HWP_CAPABILITIES_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_HWP_CAPABILITIES); - @endcode - @note MSR_IA32_HWP_CAPABILITIES is defined as IA32_HWP_CAPABILITIES in S= DM. -**/ -#define MSR_IA32_HWP_CAPABILITIES 0x00000771 - -/** - MSR information returned for MSR index #MSR_IA32_HWP_CAPABILITIES -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Highest_Performance See Section 14.4.3, "HWP Performance - /// Range and Dynamic Capabilities". If CPUID.06H:EAX.[7] =3D 1. - /// - UINT32 Highest_Performance:8; - /// - /// [Bits 15:8] Guaranteed_Performance See Section 14.4.3, "HWP - /// Performance Range and Dynamic Capabilities". If CPUID.06H:EAX.[7] = =3D 1. - /// - UINT32 Guaranteed_Performance:8; - /// - /// [Bits 23:16] Most_Efficient_Performance See Section 14.4.3, "HWP - /// Performance Range and Dynamic Capabilities". If CPUID.06H:EAX.[7] = =3D 1. - /// - UINT32 Most_Efficient_Performance:8; - /// - /// [Bits 31:24] Lowest_Performance See Section 14.4.3, "HWP Performan= ce - /// Range and Dynamic Capabilities". If CPUID.06H:EAX.[7] =3D 1. - /// - UINT32 Lowest_Performance:8; - UINT32 Reserved:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_HWP_CAPABILITIES_REGISTER; - - -/** - Power Management Control Hints for All Logical Processors in a Package - (R/W). If CPUID.06H:EAX.[11] =3D 1. - - @param ECX MSR_IA32_HWP_REQUEST_PKG (0x00000772) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_HWP_REQUEST_PKG_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_HWP_REQUEST_PKG_REGISTER. - - Example usage - @code - MSR_IA32_HWP_REQUEST_PKG_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_HWP_REQUEST_PKG); - AsmWriteMsr64 (MSR_IA32_HWP_REQUEST_PKG, Msr.Uint64); - @endcode - @note MSR_IA32_HWP_REQUEST_PKG is defined as IA32_HWP_REQUEST_PKG in SDM. -**/ -#define MSR_IA32_HWP_REQUEST_PKG 0x00000772 - -/** - MSR information returned for MSR index #MSR_IA32_HWP_REQUEST_PKG -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Minimum_Performance See Section 14.4.4, "Managing HWP".= If - /// CPUID.06H:EAX.[11] =3D 1. - /// - UINT32 Minimum_Performance:8; - /// - /// [Bits 15:8] Maximum_Performance See Section 14.4.4, "Managing HWP"= . If - /// CPUID.06H:EAX.[11] =3D 1. - /// - UINT32 Maximum_Performance:8; - /// - /// [Bits 23:16] Desired_Performance See Section 14.4.4, "Managing HWP= ". - /// If CPUID.06H:EAX.[11] =3D 1. - /// - UINT32 Desired_Performance:8; - /// - /// [Bits 31:24] Energy_Performance_Preference See Section 14.4.4, - /// "Managing HWP". If CPUID.06H:EAX.[11] =3D 1 && CPUID.06H:EAX.[10] = =3D 1. - /// - UINT32 Energy_Performance_Preference:8; - /// - /// [Bits 41:32] Activity_Window See Section 14.4.4, "Managing HWP". If - /// CPUID.06H:EAX.[11] =3D 1 && CPUID.06H:EAX.[9] =3D 1. - /// - UINT32 Activity_Window:10; - UINT32 Reserved:22; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_HWP_REQUEST_PKG_REGISTER; - - -/** - Control HWP Native Interrupts (R/W). If CPUID.06H:EAX.[8] =3D 1. - - @param ECX MSR_IA32_HWP_INTERRUPT (0x00000773) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_HWP_INTERRUPT_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_HWP_INTERRUPT_REGISTER. - - Example usage - @code - MSR_IA32_HWP_INTERRUPT_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_HWP_INTERRUPT); - AsmWriteMsr64 (MSR_IA32_HWP_INTERRUPT, Msr.Uint64); - @endcode - @note MSR_IA32_HWP_INTERRUPT is defined as IA32_HWP_INTERRUPT in SDM. -**/ -#define MSR_IA32_HWP_INTERRUPT 0x00000773 - -/** - MSR information returned for MSR index #MSR_IA32_HWP_INTERRUPT -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] EN_Guaranteed_Performance_Change. See Section 14.4.6, "HWP - /// Notifications". If CPUID.06H:EAX.[8] =3D 1. - /// - UINT32 EN_Guaranteed_Performance_Change:1; - /// - /// [Bit 1] EN_Excursion_Minimum. See Section 14.4.6, "HWP Notificatio= ns". - /// If CPUID.06H:EAX.[8] =3D 1. - /// - UINT32 EN_Excursion_Minimum:1; - UINT32 Reserved1:30; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_HWP_INTERRUPT_REGISTER; - - -/** - Power Management Control Hints to a Logical Processor (R/W). If - CPUID.06H:EAX.[7] =3D 1. - - @param ECX MSR_IA32_HWP_REQUEST (0x00000774) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_HWP_REQUEST_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_HWP_REQUEST_REGISTER. - - Example usage - @code - MSR_IA32_HWP_REQUEST_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_HWP_REQUEST); - AsmWriteMsr64 (MSR_IA32_HWP_REQUEST, Msr.Uint64); - @endcode - @note MSR_IA32_HWP_REQUEST is defined as IA32_HWP_REQUEST in SDM. -**/ -#define MSR_IA32_HWP_REQUEST 0x00000774 - -/** - MSR information returned for MSR index #MSR_IA32_HWP_REQUEST -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Minimum_Performance See Section 14.4.4, "Managing HWP".= If - /// CPUID.06H:EAX.[7] =3D 1. - /// - UINT32 Minimum_Performance:8; - /// - /// [Bits 15:8] Maximum_Performance See Section 14.4.4, "Managing HWP"= . If - /// CPUID.06H:EAX.[7] =3D 1. - /// - UINT32 Maximum_Performance:8; - /// - /// [Bits 23:16] Desired_Performance See Section 14.4.4, "Managing HWP= ". - /// If CPUID.06H:EAX.[7] =3D 1. - /// - UINT32 Desired_Performance:8; - /// - /// [Bits 31:24] Energy_Performance_Preference See Section 14.4.4, - /// "Managing HWP". If CPUID.06H:EAX.[7] =3D 1 && CPUID.06H:EAX.[10] = =3D 1. - /// - UINT32 Energy_Performance_Preference:8; - /// - /// [Bits 41:32] Activity_Window See Section 14.4.4, "Managing HWP". If - /// CPUID.06H:EAX.[7] =3D 1 && CPUID.06H:EAX.[9] =3D 1. - /// - UINT32 Activity_Window:10; - /// - /// [Bit 42] Package_Control See Section 14.4.4, "Managing HWP". If - /// CPUID.06H:EAX.[7] =3D 1 && CPUID.06H:EAX.[11] =3D 1. - /// - UINT32 Package_Control:1; - UINT32 Reserved:21; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_HWP_REQUEST_REGISTER; - - -/** - Log bits indicating changes to Guaranteed & excursions to Minimum (R/W)= . If - CPUID.06H:EAX.[7] =3D 1. - - @param ECX MSR_IA32_HWP_STATUS (0x00000777) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_HWP_STATUS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_HWP_STATUS_REGISTER. - - Example usage - @code - MSR_IA32_HWP_STATUS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_HWP_STATUS); - AsmWriteMsr64 (MSR_IA32_HWP_STATUS, Msr.Uint64); - @endcode - @note MSR_IA32_HWP_STATUS is defined as IA32_HWP_STATUS in SDM. -**/ -#define MSR_IA32_HWP_STATUS 0x00000777 - -/** - MSR information returned for MSR index #MSR_IA32_HWP_STATUS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Guaranteed_Performance_Change (R/WC0). See Section 14.4.5, - /// "HWP Feedback". If CPUID.06H:EAX.[7] =3D 1. - /// - UINT32 Guaranteed_Performance_Change:1; - UINT32 Reserved1:1; - /// - /// [Bit 2] Excursion_To_Minimum (R/WC0). See Section 14.4.5, "HWP - /// Feedback". If CPUID.06H:EAX.[7] =3D 1. - /// - UINT32 Excursion_To_Minimum:1; - UINT32 Reserved2:29; - UINT32 Reserved3:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_HWP_STATUS_REGISTER; - - -/** - x2APIC ID Register (R/O) See x2APIC Specification. If CPUID.01H:ECX[21] = =3D 1 - && IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_APICID (0x00000802) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_APICID); - @endcode - @note MSR_IA32_X2APIC_APICID is defined as IA32_X2APIC_APICID in SDM. -**/ -#define MSR_IA32_X2APIC_APICID 0x00000802 - - -/** - x2APIC Version Register (R/O). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_VERSION (0x00000803) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_VERSION); - @endcode - @note MSR_IA32_X2APIC_VERSION is defined as IA32_X2APIC_VERSION in SDM. -**/ -#define MSR_IA32_X2APIC_VERSION 0x00000803 - - -/** - x2APIC Task Priority Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_TPR (0x00000808) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_TPR); - AsmWriteMsr64 (MSR_IA32_X2APIC_TPR, Msr); - @endcode - @note MSR_IA32_X2APIC_TPR is defined as IA32_X2APIC_TPR in SDM. -**/ -#define MSR_IA32_X2APIC_TPR 0x00000808 - - -/** - x2APIC Processor Priority Register (R/O). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_PPR (0x0000080A) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_PPR); - @endcode - @note MSR_IA32_X2APIC_PPR is defined as IA32_X2APIC_PPR in SDM. -**/ -#define MSR_IA32_X2APIC_PPR 0x0000080A - - -/** - x2APIC EOI Register (W/O). If CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE= .[10] - =3D 1. - - @param ECX MSR_IA32_X2APIC_EOI (0x0000080B) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D 0; - AsmWriteMsr64 (MSR_IA32_X2APIC_EOI, Msr); - @endcode - @note MSR_IA32_X2APIC_EOI is defined as IA32_X2APIC_EOI in SDM. -**/ -#define MSR_IA32_X2APIC_EOI 0x0000080B - - -/** - x2APIC Logical Destination Register (R/O). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_LDR (0x0000080D) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LDR); - @endcode - @note MSR_IA32_X2APIC_LDR is defined as IA32_X2APIC_LDR in SDM. -**/ -#define MSR_IA32_X2APIC_LDR 0x0000080D - - -/** - x2APIC Spurious Interrupt Vector Register (R/W). If CPUID.01H:ECX.[21] = =3D 1 - && IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_SIVR (0x0000080F) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_SIVR); - AsmWriteMsr64 (MSR_IA32_X2APIC_SIVR, Msr); - @endcode - @note MSR_IA32_X2APIC_SIVR is defined as IA32_X2APIC_SIVR in SDM. -**/ -#define MSR_IA32_X2APIC_SIVR 0x0000080F - - -/** - x2APIC In-Service Register Bits (n * 32 + 31):(n * 32) (R/O). - If CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_ISRn - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_ISR0); - @endcode - @note MSR_IA32_X2APIC_ISR0 is defined as IA32_X2APIC_ISR0 in SDM. - MSR_IA32_X2APIC_ISR1 is defined as IA32_X2APIC_ISR1 in SDM. - MSR_IA32_X2APIC_ISR2 is defined as IA32_X2APIC_ISR2 in SDM. - MSR_IA32_X2APIC_ISR3 is defined as IA32_X2APIC_ISR3 in SDM. - MSR_IA32_X2APIC_ISR4 is defined as IA32_X2APIC_ISR4 in SDM. - MSR_IA32_X2APIC_ISR5 is defined as IA32_X2APIC_ISR5 in SDM. - MSR_IA32_X2APIC_ISR6 is defined as IA32_X2APIC_ISR6 in SDM. - MSR_IA32_X2APIC_ISR7 is defined as IA32_X2APIC_ISR7 in SDM. - @{ -**/ -#define MSR_IA32_X2APIC_ISR0 0x00000810 -#define MSR_IA32_X2APIC_ISR1 0x00000811 -#define MSR_IA32_X2APIC_ISR2 0x00000812 -#define MSR_IA32_X2APIC_ISR3 0x00000813 -#define MSR_IA32_X2APIC_ISR4 0x00000814 -#define MSR_IA32_X2APIC_ISR5 0x00000815 -#define MSR_IA32_X2APIC_ISR6 0x00000816 -#define MSR_IA32_X2APIC_ISR7 0x00000817 -/// @} - - -/** - x2APIC Trigger Mode Register Bits (n * 32 + ):(n * 32) (R/O). - If CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_TMRn - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_TMR0); - @endcode - @note MSR_IA32_X2APIC_TMR0 is defined as IA32_X2APIC_TMR0 in SDM. - MSR_IA32_X2APIC_TMR1 is defined as IA32_X2APIC_TMR1 in SDM. - MSR_IA32_X2APIC_TMR2 is defined as IA32_X2APIC_TMR2 in SDM. - MSR_IA32_X2APIC_TMR3 is defined as IA32_X2APIC_TMR3 in SDM. - MSR_IA32_X2APIC_TMR4 is defined as IA32_X2APIC_TMR4 in SDM. - MSR_IA32_X2APIC_TMR5 is defined as IA32_X2APIC_TMR5 in SDM. - MSR_IA32_X2APIC_TMR6 is defined as IA32_X2APIC_TMR6 in SDM. - MSR_IA32_X2APIC_TMR7 is defined as IA32_X2APIC_TMR7 in SDM. - @{ -**/ -#define MSR_IA32_X2APIC_TMR0 0x00000818 -#define MSR_IA32_X2APIC_TMR1 0x00000819 -#define MSR_IA32_X2APIC_TMR2 0x0000081A -#define MSR_IA32_X2APIC_TMR3 0x0000081B -#define MSR_IA32_X2APIC_TMR4 0x0000081C -#define MSR_IA32_X2APIC_TMR5 0x0000081D -#define MSR_IA32_X2APIC_TMR6 0x0000081E -#define MSR_IA32_X2APIC_TMR7 0x0000081F -/// @} - - -/** - x2APIC Interrupt Request Register Bits (n* 32 + 31):(n * 32) (R/O). - If CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_IRRn - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_IRR0); - @endcode - @note MSR_IA32_X2APIC_IRR0 is defined as IA32_X2APIC_IRR0 in SDM. - MSR_IA32_X2APIC_IRR1 is defined as IA32_X2APIC_IRR1 in SDM. - MSR_IA32_X2APIC_IRR2 is defined as IA32_X2APIC_IRR2 in SDM. - MSR_IA32_X2APIC_IRR3 is defined as IA32_X2APIC_IRR3 in SDM. - MSR_IA32_X2APIC_IRR4 is defined as IA32_X2APIC_IRR4 in SDM. - MSR_IA32_X2APIC_IRR5 is defined as IA32_X2APIC_IRR5 in SDM. - MSR_IA32_X2APIC_IRR6 is defined as IA32_X2APIC_IRR6 in SDM. - MSR_IA32_X2APIC_IRR7 is defined as IA32_X2APIC_IRR7 in SDM. - @{ -**/ -#define MSR_IA32_X2APIC_IRR0 0x00000820 -#define MSR_IA32_X2APIC_IRR1 0x00000821 -#define MSR_IA32_X2APIC_IRR2 0x00000822 -#define MSR_IA32_X2APIC_IRR3 0x00000823 -#define MSR_IA32_X2APIC_IRR4 0x00000824 -#define MSR_IA32_X2APIC_IRR5 0x00000825 -#define MSR_IA32_X2APIC_IRR6 0x00000826 -#define MSR_IA32_X2APIC_IRR7 0x00000827 -/// @} - - -/** - x2APIC Error Status Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_ESR (0x00000828) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_ESR); - AsmWriteMsr64 (MSR_IA32_X2APIC_ESR, Msr); - @endcode - @note MSR_IA32_X2APIC_ESR is defined as IA32_X2APIC_ESR in SDM. -**/ -#define MSR_IA32_X2APIC_ESR 0x00000828 - - -/** - x2APIC LVT Corrected Machine Check Interrupt Register (R/W). If - CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_LVT_CMCI (0x0000082F) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_CMCI); - AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_CMCI, Msr); - @endcode - @note MSR_IA32_X2APIC_LVT_CMCI is defined as IA32_X2APIC_LVT_CMCI in SDM. -**/ -#define MSR_IA32_X2APIC_LVT_CMCI 0x0000082F - - -/** - x2APIC Interrupt Command Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_ICR (0x00000830) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_ICR); - AsmWriteMsr64 (MSR_IA32_X2APIC_ICR, Msr); - @endcode - @note MSR_IA32_X2APIC_ICR is defined as IA32_X2APIC_ICR in SDM. -**/ -#define MSR_IA32_X2APIC_ICR 0x00000830 - - -/** - x2APIC LVT Timer Interrupt Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_LVT_TIMER (0x00000832) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_TIMER); - AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_TIMER, Msr); - @endcode - @note MSR_IA32_X2APIC_LVT_TIMER is defined as IA32_X2APIC_LVT_TIMER in S= DM. -**/ -#define MSR_IA32_X2APIC_LVT_TIMER 0x00000832 - - -/** - x2APIC LVT Thermal Sensor Interrupt Register (R/W). If CPUID.01H:ECX.[21= ] =3D - 1 && IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_LVT_THERMAL (0x00000833) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_THERMAL); - AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_THERMAL, Msr); - @endcode - @note MSR_IA32_X2APIC_LVT_THERMAL is defined as IA32_X2APIC_LVT_THERMAL = in SDM. -**/ -#define MSR_IA32_X2APIC_LVT_THERMAL 0x00000833 - - -/** - x2APIC LVT Performance Monitor Interrupt Register (R/W). If - CPUID.01H:ECX.[21] =3D 1 && IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_LVT_PMI (0x00000834) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_PMI); - AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_PMI, Msr); - @endcode - @note MSR_IA32_X2APIC_LVT_PMI is defined as IA32_X2APIC_LVT_PMI in SDM. -**/ -#define MSR_IA32_X2APIC_LVT_PMI 0x00000834 - - -/** - x2APIC LVT LINT0 Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_LVT_LINT0 (0x00000835) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_LINT0); - AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_LINT0, Msr); - @endcode - @note MSR_IA32_X2APIC_LVT_LINT0 is defined as IA32_X2APIC_LVT_LINT0 in S= DM. -**/ -#define MSR_IA32_X2APIC_LVT_LINT0 0x00000835 - - -/** - x2APIC LVT LINT1 Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_LVT_LINT1 (0x00000836) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_LINT1); - AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_LINT1, Msr); - @endcode - @note MSR_IA32_X2APIC_LVT_LINT1 is defined as IA32_X2APIC_LVT_LINT1 in S= DM. -**/ -#define MSR_IA32_X2APIC_LVT_LINT1 0x00000836 - - -/** - x2APIC LVT Error Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_LVT_ERROR (0x00000837) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_LVT_ERROR); - AsmWriteMsr64 (MSR_IA32_X2APIC_LVT_ERROR, Msr); - @endcode - @note MSR_IA32_X2APIC_LVT_ERROR is defined as IA32_X2APIC_LVT_ERROR in S= DM. -**/ -#define MSR_IA32_X2APIC_LVT_ERROR 0x00000837 - - -/** - x2APIC Initial Count Register (R/W). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_INIT_COUNT (0x00000838) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_INIT_COUNT); - AsmWriteMsr64 (MSR_IA32_X2APIC_INIT_COUNT, Msr); - @endcode - @note MSR_IA32_X2APIC_INIT_COUNT is defined as IA32_X2APIC_INIT_COUNT in= SDM. -**/ -#define MSR_IA32_X2APIC_INIT_COUNT 0x00000838 - - -/** - x2APIC Current Count Register (R/O). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_CUR_COUNT (0x00000839) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_CUR_COUNT); - @endcode - @note MSR_IA32_X2APIC_CUR_COUNT is defined as IA32_X2APIC_CUR_COUNT in S= DM. -**/ -#define MSR_IA32_X2APIC_CUR_COUNT 0x00000839 - - -/** - x2APIC Divide Configuration Register (R/W). If CPUID.01H:ECX.[21] =3D 1 = && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_DIV_CONF (0x0000083E) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_X2APIC_DIV_CONF); - AsmWriteMsr64 (MSR_IA32_X2APIC_DIV_CONF, Msr); - @endcode - @note MSR_IA32_X2APIC_DIV_CONF is defined as IA32_X2APIC_DIV_CONF in SDM. -**/ -#define MSR_IA32_X2APIC_DIV_CONF 0x0000083E - - -/** - x2APIC Self IPI Register (W/O). If CPUID.01H:ECX.[21] =3D 1 && - IA32_APIC_BASE.[10] =3D 1. - - @param ECX MSR_IA32_X2APIC_SELF_IPI (0x0000083F) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D 0; - AsmWriteMsr64 (MSR_IA32_X2APIC_SELF_IPI, Msr); - @endcode - @note MSR_IA32_X2APIC_SELF_IPI is defined as IA32_X2APIC_SELF_IPI in SDM. -**/ -#define MSR_IA32_X2APIC_SELF_IPI 0x0000083F - - -/** - Silicon Debug Feature Control (R/W). If CPUID.01H:ECX.[11] =3D 1. - - @param ECX MSR_IA32_DEBUG_INTERFACE (0x00000C80) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_DEBUG_INTERFACE_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_DEBUG_INTERFACE_REGISTER. - - Example usage - @code - MSR_IA32_DEBUG_INTERFACE_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_DEBUG_INTERFACE); - AsmWriteMsr64 (MSR_IA32_DEBUG_INTERFACE, Msr.Uint64); - @endcode - @note MSR_IA32_DEBUG_INTERFACE is defined as IA32_DEBUG_INTERFACE in SDM. -**/ -#define MSR_IA32_DEBUG_INTERFACE 0x00000C80 - -/** - MSR information returned for MSR index #MSR_IA32_DEBUG_INTERFACE -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Enable (R/W) BIOS set 1 to enable Silicon debug features. - /// Default is 0. If CPUID.01H:ECX.[11] =3D 1. - /// - UINT32 Enable:1; - UINT32 Reserved1:29; - /// - /// [Bit 30] Lock (R/W): If 1, locks any further change to the MSR. The - /// lock bit is set automatically on the first SMI assertion even if n= ot - /// explicitly set by BIOS. Default is 0. If CPUID.01H:ECX.[11] =3D 1. - /// - UINT32 Lock:1; - /// - /// [Bit 31] Debug Occurred (R/O): This "sticky bit" is set by hardwar= e to - /// indicate the status of bit 0. Default is 0. If CPUID.01H:ECX.[11] = =3D 1. - /// - UINT32 DebugOccurred:1; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_DEBUG_INTERFACE_REGISTER; - - -/** - L3 QOS Configuration (R/W). If ( CPUID.(EAX=3D10H, ECX=3D1):ECX.[2] =3D = 1 ). - - @param ECX MSR_IA32_L3_QOS_CFG (0x00000C81) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_L3_QOS_CFG_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_L3_QOS_CFG_REGISTER. - - Example usage - @code - MSR_IA32_L3_QOS_CFG_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_L3_QOS_CFG); - AsmWriteMsr64 (MSR_IA32_L3_QOS_CFG, Msr.Uint64); - @endcode - @note MSR_IA32_L3_QOS_CFG is defined as IA32_L3_QOS_CFG in SDM. -**/ -#define MSR_IA32_L3_QOS_CFG 0x00000C81 - -/** - MSR information returned for MSR index #MSR_IA32_L3_QOS_CFG -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Enable (R/W) Set 1 to enable L3 CAT masks and COS to opera= te - /// in Code and Data Prioritization (CDP) mode. - /// - UINT32 Enable:1; - UINT32 Reserved1:31; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_L3_QOS_CFG_REGISTER; - -/** - L2 QOS Configuration (R/W). If ( CPUID.(EAX=3D10H, ECX=3D2):ECX.[2] =3D = 1 ). - - @param ECX MSR_IA32_L2_QOS_CFG (0x00000C82) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_L2_QOS_CFG_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_L2_QOS_CFG_REGISTER. - - Example usage - @code - MSR_IA32_L2_QOS_CFG_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_L2_QOS_CFG); - AsmWriteMsr64 (MSR_IA32_L2_QOS_CFG, Msr.Uint64); - @endcode - @note MSR_IA32_L2_QOS_CFG is defined as IA32_L2_QOS_CFG in SDM. -**/ -#define MSR_IA32_L2_QOS_CFG 0x00000C82 - -/** - MSR information returned for MSR index #MSR_IA32_L2_QOS_CFG -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] Enable (R/W) Set 1 to enable L2 CAT masks and COS to opera= te - /// in Code and Data Prioritization (CDP) mode. - /// - UINT32 Enable:1; - UINT32 Reserved1:31; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_L2_QOS_CFG_REGISTER; - -/** - Monitoring Event Select Register (R/W). If ( CPUID.(EAX=3D07H, ECX=3D0):= EBX.[12] - =3D 1 ). - - @param ECX MSR_IA32_QM_EVTSEL (0x00000C8D) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_QM_EVTSEL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_QM_EVTSEL_REGISTER. - - Example usage - @code - MSR_IA32_QM_EVTSEL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_QM_EVTSEL); - AsmWriteMsr64 (MSR_IA32_QM_EVTSEL, Msr.Uint64); - @endcode - @note MSR_IA32_QM_EVTSEL is defined as IA32_QM_EVTSEL in SDM. -**/ -#define MSR_IA32_QM_EVTSEL 0x00000C8D - -/** - MSR information returned for MSR index #MSR_IA32_QM_EVTSEL -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 7:0] Event ID: ID of a supported monitoring event to report = via - /// IA32_QM_CTR. - /// - UINT32 EventID:8; - UINT32 Reserved:24; - /// - /// [Bits 63:32] Resource Monitoring ID: ID for monitoring hardware to - /// report monitored data via IA32_QM_CTR. N =3D Ceil (Log:sub:`2` ( - /// CPUID.(EAX=3D 0FH, ECX=3D0H).EBX[31:0] +1)). - /// - UINT32 ResourceMonitoringID:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_QM_EVTSEL_REGISTER; - - -/** - Monitoring Counter Register (R/O). If ( CPUID.(EAX=3D07H, ECX=3D0):EBX.[= 12] =3D 1 - ). - - @param ECX MSR_IA32_QM_CTR (0x00000C8E) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_QM_CTR_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_QM_CTR_REGISTER. - - Example usage - @code - MSR_IA32_QM_CTR_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_QM_CTR); - @endcode - @note MSR_IA32_QM_CTR is defined as IA32_QM_CTR in SDM. -**/ -#define MSR_IA32_QM_CTR 0x00000C8E - -/** - MSR information returned for MSR index #MSR_IA32_QM_CTR -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 31:0] Resource Monitored Data. - /// - UINT32 ResourceMonitoredData:32; - /// - /// [Bits 61:32] Resource Monitored Data. - /// - UINT32 ResourceMonitoredDataHi:30; - /// - /// [Bit 62] Unavailable: If 1, indicates data for this RMID is not - /// available or not monitored for this resource or RMID. - /// - UINT32 Unavailable:1; - /// - /// [Bit 63] Error: If 1, indicates and unsupported RMID or event type= was - /// written to IA32_PQR_QM_EVTSEL. - /// - UINT32 Error:1; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_QM_CTR_REGISTER; - - -/** - Resource Association Register (R/W). If ( (CPUID.(EAX=3D07H, ECX=3D0):EB= X[12] - =3D1) or (CPUID.(EAX=3D07H, ECX=3D0):EBX[15] =3D1 ) ). - - @param ECX MSR_IA32_PQR_ASSOC (0x00000C8F) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PQR_ASSOC_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PQR_ASSOC_REGISTER. - - Example usage - @code - MSR_IA32_PQR_ASSOC_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PQR_ASSOC); - AsmWriteMsr64 (MSR_IA32_PQR_ASSOC, Msr.Uint64); - @endcode - @note MSR_IA32_PQR_ASSOC is defined as IA32_PQR_ASSOC in SDM. -**/ -#define MSR_IA32_PQR_ASSOC 0x00000C8F - -/** - MSR information returned for MSR index #MSR_IA32_PQR_ASSOC -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 31:0] Resource Monitoring ID (R/W): ID for monitoring hardwa= re - /// to track internal operation, e.g. memory access. N =3D Ceil (Log:s= ub:`2` - /// ( CPUID.(EAX=3D 0FH, ECX=3D0H).EBX[31:0] +1)). - /// - UINT32 ResourceMonitoringID:32; - /// - /// [Bits 63:32] COS (R/W). The class of service (COS) to enforce (on - /// writes); returns the current COS when read. If ( CPUID.(EAX=3D07H, - /// ECX=3D0):EBX.[15] =3D 1 ). - /// - UINT32 COS:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PQR_ASSOC_REGISTER; - - -/** - Supervisor State of MPX Configuration. (R/W). If (CPUID.(EAX=3D07H, - ECX=3D0H):EBX[14] =3D 1). - - @param ECX MSR_IA32_BNDCFGS (0x00000D90) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_BNDCFGS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_BNDCFGS_REGISTER. - - Example usage - @code - MSR_IA32_BNDCFGS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_BNDCFGS); - AsmWriteMsr64 (MSR_IA32_BNDCFGS, Msr.Uint64); - @endcode - @note MSR_IA32_BNDCFGS is defined as IA32_BNDCFGS in SDM. -**/ -#define MSR_IA32_BNDCFGS 0x00000D90 - -/** - MSR information returned for MSR index #MSR_IA32_BNDCFGS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] EN: Enable Intel MPX in supervisor mode. - /// - UINT32 EN:1; - /// - /// [Bit 1] BNDPRESERVE: Preserve the bounds registers for near branch - /// instructions in the absence of the BND prefix. - /// - UINT32 BNDPRESERVE:1; - UINT32 Reserved:10; - /// - /// [Bits 31:12] Base Address of Bound Directory. - /// - UINT32 Base:20; - /// - /// [Bits 63:32] Base Address of Bound Directory. - /// - UINT32 BaseHi:32; - } Bits; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_BNDCFGS_REGISTER; - - -/** - Extended Supervisor State Mask (R/W). If( CPUID.(0DH, 1):EAX.[3] =3D 1. - - @param ECX MSR_IA32_XSS (0x00000DA0) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_XSS_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_XSS_REGISTER. - - Example usage - @code - MSR_IA32_XSS_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_XSS); - AsmWriteMsr64 (MSR_IA32_XSS, Msr.Uint64); - @endcode - @note MSR_IA32_XSS is defined as IA32_XSS in SDM. -**/ -#define MSR_IA32_XSS 0x00000DA0 - -/** - MSR information returned for MSR index #MSR_IA32_XSS -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - UINT32 Reserved1:8; - /// - /// [Bit 8] Trace Packet Configuration State (R/W). - /// - UINT32 TracePacketConfigurationState:1; - UINT32 Reserved2:23; - UINT32 Reserved3:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_XSS_REGISTER; - - -/** - Package Level Enable/disable HDC (R/W). If CPUID.06H:EAX.[13] =3D 1. - - @param ECX MSR_IA32_PKG_HDC_CTL (0x00000DB0) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PKG_HDC_CTL_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PKG_HDC_CTL_REGISTER. - - Example usage - @code - MSR_IA32_PKG_HDC_CTL_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PKG_HDC_CTL); - AsmWriteMsr64 (MSR_IA32_PKG_HDC_CTL, Msr.Uint64); - @endcode - @note MSR_IA32_PKG_HDC_CTL is defined as IA32_PKG_HDC_CTL in SDM. -**/ -#define MSR_IA32_PKG_HDC_CTL 0x00000DB0 - -/** - MSR information returned for MSR index #MSR_IA32_PKG_HDC_CTL -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] HDC_Pkg_Enable (R/W) Force HDC idling or wake up HDC-idled - /// logical processors in the package. See Section 14.5.2, "Package le= vel - /// Enabling HDC". If CPUID.06H:EAX.[13] =3D 1. - /// - UINT32 HDC_Pkg_Enable:1; - UINT32 Reserved1:31; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PKG_HDC_CTL_REGISTER; - - -/** - Enable/disable HWP (R/W). If CPUID.06H:EAX.[13] =3D 1. - - @param ECX MSR_IA32_PM_CTL1 (0x00000DB1) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_PM_CTL1_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_PM_CTL1_REGISTER. - - Example usage - @code - MSR_IA32_PM_CTL1_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_PM_CTL1); - AsmWriteMsr64 (MSR_IA32_PM_CTL1, Msr.Uint64); - @endcode - @note MSR_IA32_PM_CTL1 is defined as IA32_PM_CTL1 in SDM. -**/ -#define MSR_IA32_PM_CTL1 0x00000DB1 - -/** - MSR information returned for MSR index #MSR_IA32_PM_CTL1 -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] HDC_Allow_Block (R/W) Allow/Block this logical processor f= or - /// package level HDC control. See Section 14.5.3. - /// If CPUID.06H:EAX.[13] =3D 1. - /// - UINT32 HDC_Allow_Block:1; - UINT32 Reserved1:31; - UINT32 Reserved2:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_PM_CTL1_REGISTER; - - -/** - Per-Logical_Processor HDC Idle Residency (R/0). If CPUID.06H:EAX.[13] = =3D 1. - Stall_Cycle_Cnt (R/W) Stalled cycles due to HDC forced idle on this logi= cal - processor. See Section 14.5.4.1. If CPUID.06H:EAX.[13] =3D 1. - - @param ECX MSR_IA32_THREAD_STALL (0x00000DB2) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_THREAD_STALL); - @endcode - @note MSR_IA32_THREAD_STALL is defined as IA32_THREAD_STALL in SDM. -**/ -#define MSR_IA32_THREAD_STALL 0x00000DB2 - - -/** - Extended Feature Enables. If ( CPUID.80000001H:EDX.[2 0] - CPUID.80000001H:EDX.[2 9]). - - @param ECX MSR_IA32_EFER (0xC0000080) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_EFER_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_EFER_REGISTER. - - Example usage - @code - MSR_IA32_EFER_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_EFER); - AsmWriteMsr64 (MSR_IA32_EFER, Msr.Uint64); - @endcode - @note MSR_IA32_EFER is defined as IA32_EFER in SDM. -**/ -#define MSR_IA32_EFER 0xC0000080 - -/** - MSR information returned for MSR index #MSR_IA32_EFER -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bit 0] SYSCALL Enable: IA32_EFER.SCE (R/W) Enables SYSCALL/SYSRET - /// instructions in 64-bit mode. - /// - UINT32 SCE:1; - UINT32 Reserved1:7; - /// - /// [Bit 8] IA-32e Mode Enable: IA32_EFER.LME (R/W) Enables IA-32e mode - /// operation. - /// - UINT32 LME:1; - UINT32 Reserved2:1; - /// - /// [Bit 10] IA-32e Mode Active: IA32_EFER.LMA (R) Indicates IA-32e mo= de - /// is active when set. - /// - UINT32 LMA:1; - /// - /// [Bit 11] Execute Disable Bit Enable: IA32_EFER.NXE (R/W). - /// - UINT32 NXE:1; - UINT32 Reserved3:20; - UINT32 Reserved4:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_EFER_REGISTER; - - -/** - System Call Target Address (R/W). If CPUID.80000001:EDX.[29] =3D 1. - - @param ECX MSR_IA32_STAR (0xC0000081) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_STAR); - AsmWriteMsr64 (MSR_IA32_STAR, Msr); - @endcode - @note MSR_IA32_STAR is defined as IA32_STAR in SDM. -**/ -#define MSR_IA32_STAR 0xC0000081 - - -/** - IA-32e Mode System Call Target Address (R/W). If CPUID.80000001:EDX.[29]= =3D 1. - - @param ECX MSR_IA32_LSTAR (0xC0000082) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_LSTAR); - AsmWriteMsr64 (MSR_IA32_LSTAR, Msr); - @endcode - @note MSR_IA32_LSTAR is defined as IA32_LSTAR in SDM. -**/ -#define MSR_IA32_LSTAR 0xC0000082 - -/** - IA-32e Mode System Call Target Address (R/W) Not used, as the SYSCALL - instruction is not recognized in compatibility mode. If - CPUID.80000001:EDX.[29] =3D 1. - - @param ECX MSR_IA32_CSTAR (0xC0000083) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_CSTAR); - AsmWriteMsr64 (MSR_IA32_CSTAR, Msr); - @endcode - @note MSR_IA32_CSTAR is defined as IA32_CSTAR in SDM. -**/ -#define MSR_IA32_CSTAR 0xC0000083 - -/** - System Call Flag Mask (R/W). If CPUID.80000001:EDX.[29] =3D 1. - - @param ECX MSR_IA32_FMASK (0xC0000084) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_FMASK); - AsmWriteMsr64 (MSR_IA32_FMASK, Msr); - @endcode - @note MSR_IA32_FMASK is defined as IA32_FMASK in SDM. -**/ -#define MSR_IA32_FMASK 0xC0000084 - - -/** - Map of BASE Address of FS (R/W). If CPUID.80000001:EDX.[29] =3D 1. - - @param ECX MSR_IA32_FS_BASE (0xC0000100) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_FS_BASE); - AsmWriteMsr64 (MSR_IA32_FS_BASE, Msr); - @endcode - @note MSR_IA32_FS_BASE is defined as IA32_FS_BASE in SDM. -**/ -#define MSR_IA32_FS_BASE 0xC0000100 - - -/** - Map of BASE Address of GS (R/W). If CPUID.80000001:EDX.[29] =3D 1. - - @param ECX MSR_IA32_GS_BASE (0xC0000101) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_GS_BASE); - AsmWriteMsr64 (MSR_IA32_GS_BASE, Msr); - @endcode - @note MSR_IA32_GS_BASE is defined as IA32_GS_BASE in SDM. -**/ -#define MSR_IA32_GS_BASE 0xC0000101 - - -/** - Swap Target of BASE Address of GS (R/W). If CPUID.80000001:EDX.[29] =3D = 1. - - @param ECX MSR_IA32_KERNEL_GS_BASE (0xC0000102) - @param EAX Lower 32-bits of MSR value. - @param EDX Upper 32-bits of MSR value. - - Example usage - @code - UINT64 Msr; - - Msr =3D AsmReadMsr64 (MSR_IA32_KERNEL_GS_BASE); - AsmWriteMsr64 (MSR_IA32_KERNEL_GS_BASE, Msr); - @endcode - @note MSR_IA32_KERNEL_GS_BASE is defined as IA32_KERNEL_GS_BASE in SDM. -**/ -#define MSR_IA32_KERNEL_GS_BASE 0xC0000102 - - -/** - Auxiliary TSC (RW). If CPUID.80000001H: EDX[27] =3D 1. - - @param ECX MSR_IA32_TSC_AUX (0xC0000103) - @param EAX Lower 32-bits of MSR value. - Described by the type MSR_IA32_TSC_AUX_REGISTER. - @param EDX Upper 32-bits of MSR value. - Described by the type MSR_IA32_TSC_AUX_REGISTER. - - Example usage - @code - MSR_IA32_TSC_AUX_REGISTER Msr; - - Msr.Uint64 =3D AsmReadMsr64 (MSR_IA32_TSC_AUX); - AsmWriteMsr64 (MSR_IA32_TSC_AUX, Msr.Uint64); - @endcode - @note MSR_IA32_TSC_AUX is defined as IA32_TSC_AUX in SDM. -**/ -#define MSR_IA32_TSC_AUX 0xC0000103 - -/** - MSR information returned for MSR index #MSR_IA32_TSC_AUX -**/ -typedef union { - /// - /// Individual bit fields - /// - struct { - /// - /// [Bits 31:0] AUX: Auxiliary signature of TSC. - /// - UINT32 AUX:32; - UINT32 Reserved:32; - } Bits; - /// - /// All bit fields as a 32-bit value - /// - UINT32 Uint32; - /// - /// All bit fields as a 64-bit value - /// - UINT64 Uint64; -} MSR_IA32_TSC_AUX_REGISTER; +#include =20 #endif diff --git a/UefiCpuPkg/Include/Register/Cpuid.h b/UefiCpuPkg/Include/Regis= ter/Cpuid.h index 3946f2455f..3c3468041c 100644 --- a/UefiCpuPkg/Include/Register/Cpuid.h +++ b/UefiCpuPkg/Include/Register/Cpuid.h @@ -3,11 +3,6 @@ =20 Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent - - @par Specification Reference: - Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume = 2A, - November 2018, CPUID instruction. - **/ =20 #ifndef __CPUID_H__ diff --git a/UefiCpuPkg/Include/Register/LocalApic.h b/UefiCpuPkg/Include/R= egister/LocalApic.h index 369ba96af8..689c825777 100644 --- a/UefiCpuPkg/Include/Register/LocalApic.h +++ b/UefiCpuPkg/Include/Register/LocalApic.h @@ -1,183 +1,14 @@ /** @file - IA32 Local APIC Definitions. + Wrapper header file to include in MdePkg. =20 - Copyright (c) 2010 - 2016, Intel Corporation. All rights reserved.
+ Copyright (c) 2010 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent - **/ =20 #ifndef __LOCAL_APIC_H__ #define __LOCAL_APIC_H__ =20 -// -// Definition for Local APIC registers and related values -// -#define XAPIC_ID_OFFSET 0x20 -#define XAPIC_VERSION_OFFSET 0x30 -#define XAPIC_EOI_OFFSET 0x0b0 -#define XAPIC_ICR_DFR_OFFSET 0x0e0 -#define XAPIC_SPURIOUS_VECTOR_OFFSET 0x0f0 -#define XAPIC_ICR_LOW_OFFSET 0x300 -#define XAPIC_ICR_HIGH_OFFSET 0x310 -#define XAPIC_LVT_TIMER_OFFSET 0x320 -#define XAPIC_LVT_LINT0_OFFSET 0x350 -#define XAPIC_LVT_LINT1_OFFSET 0x360 -#define XAPIC_TIMER_INIT_COUNT_OFFSET 0x380 -#define XAPIC_TIMER_CURRENT_COUNT_OFFSET 0x390 -#define XAPIC_TIMER_DIVIDE_CONFIGURATION_OFFSET 0x3E0 - -#define X2APIC_MSR_BASE_ADDRESS 0x800 -#define X2APIC_MSR_ICR_ADDRESS 0x830 - -#define LOCAL_APIC_DELIVERY_MODE_FIXED 0 -#define LOCAL_APIC_DELIVERY_MODE_LOWEST_PRIORITY 1 -#define LOCAL_APIC_DELIVERY_MODE_SMI 2 -#define LOCAL_APIC_DELIVERY_MODE_NMI 4 -#define LOCAL_APIC_DELIVERY_MODE_INIT 5 -#define LOCAL_APIC_DELIVERY_MODE_STARTUP 6 -#define LOCAL_APIC_DELIVERY_MODE_EXTINT 7 - -#define LOCAL_APIC_DESTINATION_SHORTHAND_NO_SHORTHAND 0 -#define LOCAL_APIC_DESTINATION_SHORTHAND_SELF 1 -#define LOCAL_APIC_DESTINATION_SHORTHAND_ALL_INCLUDING_SELF 2 -#define LOCAL_APIC_DESTINATION_SHORTHAND_ALL_EXCLUDING_SELF 3 - -// -// Local APIC Version Register. -// -typedef union { - struct { - UINT32 Version:8; ///< The version numbers of the lo= cal APIC. - UINT32 Reserved0:8; ///< Reserved. - UINT32 MaxLvtEntry:8; ///< Number of LVT entries minus 1. - UINT32 EoiBroadcastSuppression:1; ///< 1 if EOI-broadcast suppressio= n supported. - UINT32 Reserved1:7; ///< Reserved. - } Bits; - UINT32 Uint32; -} LOCAL_APIC_VERSION; - -// -// Low half of Interrupt Command Register (ICR). -// -typedef union { - struct { - UINT32 Vector:8; ///< The vector number of the interru= pt being sent. - UINT32 DeliveryMode:3; ///< Specifies the type of IPI to be = sent. - UINT32 DestinationMode:1; ///< 0: physical destination mode, 1:= logical destination mode. - UINT32 DeliveryStatus:1; ///< Indicates the IPI delivery statu= s. This field is reserved in x2APIC mode. - UINT32 Reserved0:1; ///< Reserved. - UINT32 Level:1; ///< 0 for the INIT level de-assert d= elivery mode. Otherwise 1. - UINT32 TriggerMode:1; ///< 0: edge, 1: level when using the= INIT level de-assert delivery mode. - UINT32 Reserved1:2; ///< Reserved. - UINT32 DestinationShorthand:2; ///< A shorthand notation to specify = the destination of the interrupt. - UINT32 Reserved2:12; ///< Reserved. - } Bits; - UINT32 Uint32; -} LOCAL_APIC_ICR_LOW; - -// -// High half of Interrupt Command Register (ICR) -// -typedef union { - struct { - UINT32 Reserved0:24; ///< Reserved. - UINT32 Destination:8; ///< Specifies the target processor or process= ors in xAPIC mode. - } Bits; - UINT32 Uint32; ///< Destination field expanded to 32-bit in x= 2APIC mode. -} LOCAL_APIC_ICR_HIGH; - -// -// Spurious-Interrupt Vector Register (SVR) -// -typedef union { - struct { - UINT32 SpuriousVector:8; ///< Spurious Vector. - UINT32 SoftwareEnable:1; ///< APIC Software Enable/Disable. - UINT32 FocusProcessorChecking:1; ///< Focus Processor Checking. - UINT32 Reserved0:2; ///< Reserved. - UINT32 EoiBroadcastSuppression:1; ///< EOI-Broadcast Suppression. - UINT32 Reserved1:19; ///< Reserved. - } Bits; - UINT32 Uint32; -} LOCAL_APIC_SVR; - -// -// Divide Configuration Register (DCR) -// -typedef union { - struct { - UINT32 DivideValue1:2; ///< Low 2 bits of the divide value. - UINT32 Reserved0:1; ///< Always 0. - UINT32 DivideValue2:1; ///< Highest 1 bit of the divide value. - UINT32 Reserved1:28; ///< Reserved. - } Bits; - UINT32 Uint32; -} LOCAL_APIC_DCR; - -// -// LVT Timer Register -// -typedef union { - struct { - UINT32 Vector:8; ///< The vector number of the interrupt bei= ng sent. - UINT32 Reserved0:4; ///< Reserved. - UINT32 DeliveryStatus:1; ///< 0: Idle, 1: send pending. - UINT32 Reserved1:3; ///< Reserved. - UINT32 Mask:1; ///< 0: Not masked, 1: Masked. - UINT32 TimerMode:1; ///< 0: One-shot, 1: Periodic. - UINT32 Reserved2:14; ///< Reserved. - } Bits; - UINT32 Uint32; -} LOCAL_APIC_LVT_TIMER; - -// -// LVT LINT0/LINT1 Register -// -typedef union { - struct { - UINT32 Vector:8; ///< The vector number of the interrupt b= eing sent. - UINT32 DeliveryMode:3; ///< Specifies the type of interrupt to b= e sent. - UINT32 Reserved0:1; ///< Reserved. - UINT32 DeliveryStatus:1; ///< 0: Idle, 1: send pending. - UINT32 InputPinPolarity:1; ///< Interrupt Input Pin Polarity. - UINT32 RemoteIrr:1; ///< RO. Set when the local APIC accepts = the interrupt and reset when an EOI is received. - UINT32 TriggerMode:1; ///< 0:edge, 1:level. - UINT32 Mask:1; ///< 0: Not masked, 1: Masked. - UINT32 Reserved1:15; ///< Reserved. - } Bits; - UINT32 Uint32; -} LOCAL_APIC_LVT_LINT; - -// -// MSI Address Register -// -typedef union { - struct { - UINT32 Reserved0:2; ///< Reserved - UINT32 DestinationMode:1; ///< Specifies the Destination Mode. - UINT32 RedirectionHint:1; ///< Specifies the Redirection Hint. - UINT32 Reserved1:8; ///< Reserved. - UINT32 DestinationId:8; ///< Specifies the Destination ID. - UINT32 BaseAddress:12; ///< Must be 0FEEH - } Bits; - UINT32 Uint32; -} LOCAL_APIC_MSI_ADDRESS; - -// -// MSI Address Register -// -typedef union { - struct { - UINT32 Vector:8; ///< Interrupt vector in range 010h..0FEH - UINT32 DeliveryMode:3; ///< Specifies the type of interrupt to b= e sent. - UINT32 Reserved0:3; ///< Reserved. - UINT32 Level:1; ///< 0:Deassert, 1:Assert. Ignored for E= dge triggered interrupts. - UINT32 TriggerMode:1; ///< 0:Edge, 1:Level. - UINT32 Reserved1:16; ///< Reserved. - UINT32 Reserved2:32; ///< Reserved. - } Bits; - UINT64 Uint64; -} LOCAL_APIC_MSI_DATA; +#include =20 #endif =20 diff --git a/UefiCpuPkg/Include/Register/Microcode.h b/UefiCpuPkg/Include/R= egister/Microcode.h index e85c0cc640..48e2dcd1b8 100644 --- a/UefiCpuPkg/Include/Register/Microcode.h +++ b/UefiCpuPkg/Include/Register/Microcode.h @@ -1,194 +1,13 @@ /** @file - Microcode Definitions. + Wrapper header file to include in MdePkg. =20 - Microcode Definitions based on contents of the - Intel(R) 64 and IA-32 Architectures Software Developer's Manual - Volume 3A, Section 9.11 Microcode Definitions - - Copyright (c) 2016, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent - - @par Specification Reference: - Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume = 3A, - June 2016, Chapter 9 Processor Management and Initialization, Section 9-= 11. - **/ =20 #ifndef __MICROCODE_H__ #define __MICROCODE_H__ =20 -/// -/// CPU Microcode Date in BCD format -/// -typedef union { - struct { - UINT32 Year:16; - UINT32 Day:8; - UINT32 Month:8; - } Bits; - UINT32 Uint32; -} CPU_MICROCODE_DATE; - -/// -/// CPU Microcode Processor Signature format -/// -typedef union { - struct { - UINT32 Stepping:4; - UINT32 Model:4; - UINT32 Family:4; - UINT32 Type:2; - UINT32 Reserved1:2; - UINT32 ExtendedModel:4; - UINT32 ExtendedFamily:8; - UINT32 Reserved2:4; - } Bits; - UINT32 Uint32; -} CPU_MICROCODE_PROCESSOR_SIGNATURE; - -#pragma pack (1) - -/// -/// Microcode Update Format definition -/// -typedef struct { - /// - /// Version number of the update header - /// - UINT32 HeaderVersion; - /// - /// Unique version number for the update, the basis for the update - /// signature provided by the processor to indicate the current update - /// functioning within the processor. Used by the BIOS to authenticate - /// the update and verify that the processor loads successfully. The - /// value in this field cannot be used for processor stepping identifica= tion - /// alone. This is a signed 32-bit number. - /// - UINT32 UpdateRevision; - /// - /// Date of the update creation in binary format: mmddyyyy (e.g. - /// 07/18/98 is 07181998H). - /// - CPU_MICROCODE_DATE Date; - /// - /// Extended family, extended model, type, family, model, and stepping - /// of processor that requires this particular update revision (e.g., - /// 00000650H). Each microcode update is designed specifically for a - /// given extended family, extended model, type, family, model, and - /// stepping of the processor. - /// The BIOS uses the processor signature field in conjunction with the - /// CPUID instruction to determine whether or not an update is - /// appropriate to load on a processor. The information encoded within - /// this field exactly corresponds to the bit representations returned by - /// the CPUID instruction. - /// - CPU_MICROCODE_PROCESSOR_SIGNATURE ProcessorSignature; - /// - /// Checksum of Update Data and Header. Used to verify the integrity of - /// the update header and data. Checksum is correct when the - /// summation of all the DWORDs (including the extended Processor - /// Signature Table) that comprise the microcode update result in - /// 00000000H. - /// - UINT32 Checksum; - /// - /// Version number of the loader program needed to correctly load this - /// update. The initial version is 00000001H - /// - UINT32 LoaderRevision; - /// - /// Platform type information is encoded in the lower 8 bits of this 4- - /// byte field. Each bit represents a particular platform type for a giv= en - /// CPUID. The BIOS uses the processor flags field in conjunction with - /// the platform Id bits in MSR (17H) to determine whether or not an - /// update is appropriate to load on a processor. Multiple bits may be s= et - /// representing support for multiple platform IDs. - /// - UINT32 ProcessorFlags; - /// - /// Specifies the size of the encrypted data in bytes, and must be a - /// multiple of DWORDs. If this value is 00000000H, then the microcode - /// update encrypted data is 2000 bytes (or 500 DWORDs). - /// - UINT32 DataSize; - /// - /// Specifies the total size of the microcode update in bytes. It is the - /// summation of the header size, the encrypted data size and the size of - /// the optional extended signature table. This value is always a multip= le - /// of 1024. - /// - UINT32 TotalSize; - /// - /// Reserved fields for future expansion. - /// - UINT8 Reserved[12]; -} CPU_MICROCODE_HEADER; - -/// -/// Extended Signature Table Header Field Definitions -/// -typedef struct { - /// - /// Specifies the number of extended signature structures (Processor - /// Signature[n], processor flags[n] and checksum[n]) that exist in this - /// microcode update - /// - UINT32 ExtendedSignatureCount; - /// - /// Checksum of update extended processor signature table. Used to - /// verify the integrity of the extended processor signature table. - /// Checksum is correct when the summation of the DWORDs that - /// comprise the extended processor signature table results in - /// 00000000H. - /// - UINT32 ExtendedChecksum; - /// - /// Reserved fields. - /// - UINT8 Reserved[12]; -} CPU_MICROCODE_EXTENDED_TABLE_HEADER; - -/// -/// Extended Signature Table Field Definitions -/// -typedef struct { - /// - /// Extended family, extended model, type, family, model, and stepping - /// of processor that requires this particular update revision (e.g., - /// 00000650H). Each microcode update is designed specifically for a - /// given extended family, extended model, type, family, model, and - /// stepping of the processor. - /// The BIOS uses the processor signature field in conjunction with the - /// CPUID instruction to determine whether or not an update is - /// appropriate to load on a processor. The information encoded within - /// this field exactly corresponds to the bit representations returned by - /// the CPUID instruction. - /// - CPU_MICROCODE_PROCESSOR_SIGNATURE ProcessorSignature; - /// - /// Platform type information is encoded in the lower 8 bits of this 4- - /// byte field. Each bit represents a particular platform type for a giv= en - /// CPUID. The BIOS uses the processor flags field in conjunction with - /// the platform Id bits in MSR (17H) to determine whether or not an - /// update is appropriate to load on a processor. Multiple bits may be s= et - /// representing support for multiple platform IDs. - /// - UINT32 ProcessorFlag; - /// - /// Used by utility software to decompose a microcode update into - /// multiple microcode updates where each of the new updates is - /// constructed without the optional Extended Processor Signature - /// Table. - /// To calculate the Checksum, substitute the Primary Processor - /// Signature entry and the Processor Flags entry with the - /// corresponding Extended Patch entry. Delete the Extended Processor - /// Signature Table entries. The Checksum is correct when the - /// summation of all DWORDs that comprise the created Extended - /// Processor Patch results in 00000000H. - /// - UINT32 Checksum; -} CPU_MICROCODE_EXTENDED_TABLE; - -#pragma pack () +#include =20 #endif diff --git a/UefiCpuPkg/Include/Register/Msr.h b/UefiCpuPkg/Include/Registe= r/Msr.h index c9be042983..79830fa150 100644 --- a/UefiCpuPkg/Include/Register/Msr.h +++ b/UefiCpuPkg/Include/Register/Msr.h @@ -1,44 +1,14 @@ /** @file - MSR Definitions. + Wrapper header file to include in MdePkg. =20 - Provides defines for Machine Specific Registers(MSR) indexes. Data struc= tures - are provided for MSRs that contain one or more bit fields. If the MSR v= alue - returned is a single 32-bit or 64-bit value, then a data structure is not - provided for that MSR. - - Copyright (c) 2016 ~ 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2016 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 - @par Specification Reference: - Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume = 4, - May 2018, Volume 4: Model-Specific-Registers (MSR) - **/ =20 #ifndef __MSR_H__ #define __MSR_H__ =20 -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include +#include =20 #endif diff --git a/UefiCpuPkg/Include/Register/SmramSaveStateMap.h b/UefiCpuPkg/I= nclude/Register/SmramSaveStateMap.h index 6473e51a55..0033043309 100644 --- a/UefiCpuPkg/Include/Register/SmramSaveStateMap.h +++ b/UefiCpuPkg/Include/Register/SmramSaveStateMap.h @@ -1,184 +1,13 @@ /** @file -SMRAM Save State Map Definitions. - -SMRAM Save State Map definitions based on contents of the -Intel(R) 64 and IA-32 Architectures Software Developer's Manual - Volume 3C, Section 34.4 SMRAM - Volume 3C, Section 34.5 SMI Handler Execution Environment - Volume 3C, Section 34.7 Managing Synchronous and Asynchronous SMIs - -Copyright (c) 2015, Intel Corporation. All rights reserved.
-SPDX-License-Identifier: BSD-2-Clause-Patent + Wrapper header file to include in M= dePkg. =20 + Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent **/ =20 #ifndef __SMRAM_SAVE_STATE_MAP_H__ #define __SMRAM_SAVE_STATE_MAP_H__ =20 -/// -/// Default SMBASE address -/// -#define SMM_DEFAULT_SMBASE 0x30000 - -/// -/// Offset of SMM handler from SMBASE -/// -#define SMM_HANDLER_OFFSET 0x8000 - -/// -/// Offset of SMRAM Save State Map from SMBASE -/// -#define SMRAM_SAVE_STATE_MAP_OFFSET 0xfc00 - -#pragma pack (1) - -/// -/// 32-bit SMRAM Save State Map -/// -typedef struct { - UINT8 Reserved[0x200]; // 7c00h - // Padded an extra 0x200 bytes so 32-bit and 6= 4-bit - // SMRAM Save State Maps are the same size - UINT8 Reserved1[0xf8]; // 7e00h - UINT32 SMBASE; // 7ef8h - UINT32 SMMRevId; // 7efch - UINT16 IORestart; // 7f00h - UINT16 AutoHALTRestart; // 7f02h - UINT8 Reserved2[0x9C]; // 7f08h - UINT32 IOMemAddr; // 7fa0h - UINT32 IOMisc; // 7fa4h - UINT32 _ES; // 7fa8h - UINT32 _CS; // 7fach - UINT32 _SS; // 7fb0h - UINT32 _DS; // 7fb4h - UINT32 _FS; // 7fb8h - UINT32 _GS; // 7fbch - UINT32 Reserved3; // 7fc0h - UINT32 _TR; // 7fc4h - UINT32 _DR7; // 7fc8h - UINT32 _DR6; // 7fcch - UINT32 _EAX; // 7fd0h - UINT32 _ECX; // 7fd4h - UINT32 _EDX; // 7fd8h - UINT32 _EBX; // 7fdch - UINT32 _ESP; // 7fe0h - UINT32 _EBP; // 7fe4h - UINT32 _ESI; // 7fe8h - UINT32 _EDI; // 7fech - UINT32 _EIP; // 7ff0h - UINT32 _EFLAGS; // 7ff4h - UINT32 _CR3; // 7ff8h - UINT32 _CR0; // 7ffch -} SMRAM_SAVE_STATE_MAP32; - -/// -/// 64-bit SMRAM Save State Map -/// -typedef struct { - UINT8 Reserved1[0x1d0]; // 7c00h - UINT32 GdtBaseHiDword; // 7dd0h - UINT32 LdtBaseHiDword; // 7dd4h - UINT32 IdtBaseHiDword; // 7dd8h - UINT8 Reserved2[0xc]; // 7ddch - UINT64 IO_EIP; // 7de8h - UINT8 Reserved3[0x50]; // 7df0h - UINT32 _CR4; // 7e40h - UINT8 Reserved4[0x48]; // 7e44h - UINT32 GdtBaseLoDword; // 7e8ch - UINT32 Reserved5; // 7e90h - UINT32 IdtBaseLoDword; // 7e94h - UINT32 Reserved6; // 7e98h - UINT32 LdtBaseLoDword; // 7e9ch - UINT8 Reserved7[0x38]; // 7ea0h - UINT64 EptVmxControl; // 7ed8h - UINT32 EnEptVmxControl; // 7ee0h - UINT8 Reserved8[0x14]; // 7ee4h - UINT32 SMBASE; // 7ef8h - UINT32 SMMRevId; // 7efch - UINT16 IORestart; // 7f00h - UINT16 AutoHALTRestart; // 7f02h - UINT8 Reserved9[0x18]; // 7f04h - UINT64 _R15; // 7f1ch - UINT64 _R14; - UINT64 _R13; - UINT64 _R12; - UINT64 _R11; - UINT64 _R10; - UINT64 _R9; - UINT64 _R8; - UINT64 _RAX; // 7f5ch - UINT64 _RCX; - UINT64 _RDX; - UINT64 _RBX; - UINT64 _RSP; - UINT64 _RBP; - UINT64 _RSI; - UINT64 _RDI; - UINT64 IOMemAddr; // 7f9ch - UINT32 IOMisc; // 7fa4h - UINT32 _ES; // 7fa8h - UINT32 _CS; - UINT32 _SS; - UINT32 _DS; - UINT32 _FS; - UINT32 _GS; - UINT32 _LDTR; // 7fc0h - UINT32 _TR; - UINT64 _DR7; // 7fc8h - UINT64 _DR6; - UINT64 _RIP; // 7fd8h - UINT64 IA32_EFER; // 7fe0h - UINT64 _RFLAGS; // 7fe8h - UINT64 _CR3; // 7ff0h - UINT64 _CR0; // 7ff8h -} SMRAM_SAVE_STATE_MAP64; - -/// -/// Union of 32-bit and 64-bit SMRAM Save State Maps -/// -typedef union { - SMRAM_SAVE_STATE_MAP32 x86; - SMRAM_SAVE_STATE_MAP64 x64; -} SMRAM_SAVE_STATE_MAP; - -/// -/// Minimum SMM Revision ID that supports IOMisc field in SMRAM Save State= Map -/// -#define SMRAM_SAVE_STATE_MIN_REV_ID_IOMISC 0x30004 - -/// -/// SMRAM Save State Map IOMisc I/O Length Values -/// -#define SMM_IO_LENGTH_BYTE 0x01 -#define SMM_IO_LENGTH_WORD 0x02 -#define SMM_IO_LENGTH_DWORD 0x04 - -/// -/// SMRAM Save State Map IOMisc I/O Instruction Type Values -/// -#define SMM_IO_TYPE_IN_IMMEDIATE 0x9 -#define SMM_IO_TYPE_IN_DX 0x1 -#define SMM_IO_TYPE_OUT_IMMEDIATE 0x8 -#define SMM_IO_TYPE_OUT_DX 0x0 -#define SMM_IO_TYPE_INS 0x3 -#define SMM_IO_TYPE_OUTS 0x2 -#define SMM_IO_TYPE_REP_INS 0x7 -#define SMM_IO_TYPE_REP_OUTS 0x6 - -/// -/// SMRAM Save State Map IOMisc structure -/// -typedef union { - struct { - UINT32 SmiFlag:1; - UINT32 Length:3; - UINT32 Type:4; - UINT32 Reserved1:8; - UINT32 Port:16; - } Bits; - UINT32 Uint32; -} SMRAM_SAVE_STATE_IOMISC; - -#pragma pack () +#include =20 #endif diff --git a/UefiCpuPkg/Include/Register/StmApi.h b/UefiCpuPkg/Include/Regi= ster/StmApi.h index 0ecc0b86d5..1fa58aa9fb 100644 --- a/UefiCpuPkg/Include/Register/StmApi.h +++ b/UefiCpuPkg/Include/Register/StmApi.h @@ -1,948 +1,13 @@ /** @file - STM API definition + Wrapper header file to include in MdePkg. =20 - Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.
+ Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent - - @par Specification Reference: - SMI Transfer Monitor (STM) User Guide Revision 1.00 - **/ =20 #ifndef _STM_API_H_ #define _STM_API_H_ =20 -#include -#include -#include - -#pragma pack (1) - -/** - STM Header Structures -**/ - -typedef struct { - UINT32 Intel64ModeSupported :1; ///> bitfield - UINT32 EptSupported :1; ///> bitfield - UINT32 Reserved :30; ///> must be 0 -} STM_FEAT; - -#define STM_SPEC_VERSION_MAJOR 1 -#define STM_SPEC_VERSION_MINOR 0 - -typedef struct { - UINT8 StmSpecVerMajor; - UINT8 StmSpecVerMinor; - /// - /// Must be zero - /// - UINT16 Reserved; - UINT32 StaticImageSize; - UINT32 PerProcDynamicMemorySize; - UINT32 AdditionalDynamicMemorySize; - STM_FEAT StmFeatures; - UINT32 NumberOfRevIDs; - UINT32 StmSmmRevID[1]; - /// - /// The total STM_HEADER should be 4K. - /// -} SOFTWARE_STM_HEADER; - -typedef struct { - MSEG_HEADER HwStmHdr; - SOFTWARE_STM_HEADER SwStmHdr; -} STM_HEADER; - - -/** - VMCALL API Numbers - API number convention: BIOS facing VMCALL interfaces have bit 16 clear -**/ - -/** - StmMapAddressRange enables a SMM guest to create a non-1:1 virtual to - physical mapping of an address range into the SMM guest's virtual - memory space. - - @param EAX #STM_API_MAP_ADDRESS_RANGE (0x00000001) - @param EBX Low 32 bits of physical address of caller allocated - STM_MAP_ADDRESS_RANGE_DESCRIPTOR structure. - @param ECX High 32 bits of physical address of caller allocated - STM_MAP_ADDRESS_RANGE_DESCRIPTOR structure. If Intel64Mode = is - clear (0), ECX must be 0. - - @note All fields of STM_MAP_ADDRESS_RANGE_DESCRIPTOR are inputs only. T= hey - are not modified by StmMapAddressRange. - - @retval CF 0 - No error, EAX set to STM_SUCCESS. - The memory range was mapped as requested. - @retval CF 1 - An error occurred, EAX holds relevant error value. - @retval EAX #ERROR_STM_SECURITY_VIOLATION - The requested mapping contains a protected resource. - @retval EAX #ERROR_STM_CACHE_TYPE_NOT_SUPPORTED - The requested cache type could not be satisfied. - @retval EAX #ERROR_STM_PAGE_NOT_FOUND - Page count must not be zero. - @retval EAX #ERROR_STM_FUNCTION_NOT_SUPPORTED - STM supports EPT and has not implemented StmMapAddressRang= e(). - @retval EAX #ERROR_STM_UNSPECIFIED - An unspecified error occurred. - - @note All other registers unmodified. -**/ -#define STM_API_MAP_ADDRESS_RANGE 0x00000001 - -/** - STM Map Address Range Descriptor for #STM_API_MAP_ADDRESS_RANGE VMCALL -**/ -typedef struct { - UINT64 PhysicalAddress; - UINT64 VirtualAddress; - UINT32 PageCount; - UINT32 PatCacheType; -} STM_MAP_ADDRESS_RANGE_DESCRIPTOR; - -/** - Define values for PatCacheType field of #STM_MAP_ADDRESS_RANGE_DESCRIPTOR - @{ -**/ -#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_ST_UC 0x00 -#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_WC 0x01 -#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_WT 0x04 -#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_WP 0x05 -#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_WB 0x06 -#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_UC 0x07 -#define STM_MAP_ADDRESS_RANGE_PAT_CACHE_TYPE_FOLLOW_MTRR 0xFFFFFFFF -/// @} - -/** - StmUnmapAddressRange enables a SMM guest to remove mappings from its page - table. - - If TXT_PROCESSOR_SMM_DESCRIPTOR.EptEnabled bit is set by the STM, BIOS c= an - control its own page tables. In this case, the STM implementation may - optionally return ERROR_STM_FUNCTION_NOT_SUPPORTED. - - @param EAX #STM_API_UNMAP_ADDRESS_RANGE (0x00000002) - @param EBX Low 32 bits of virtual address of caller allocated - STM_UNMAP_ADDRESS_RANGE_DESCRIPTOR structure. - @param ECX High 32 bits of virtual address of caller allocated - STM_UNMAP_ADDRESS_RANGE_DESCRIPTOR structure. If Intel64Mod= e is - clear (0), ECX must be zero. - - @retval CF 0 - No error, EAX set to STM_SUCCESS. The memory range was unm= apped - as requested. - @retval CF 1 - An error occurred, EAX holds relevant error value. - @retval EAX #ERROR_STM_FUNCTION_NOT_SUPPORTED - STM supports EPT and has not implemented StmUnmapAddressRa= nge(). - @retval EAX #ERROR_STM_UNSPECIFIED - An unspecified error occurred. - - @note All other registers unmodified. -**/ -#define STM_API_UNMAP_ADDRESS_RANGE 0x00000002 - -/** - STM Unmap Address Range Descriptor for #STM_API_UNMAP_ADDRESS_RANGE VMCA= LL -**/ -typedef struct { - UINT64 VirtualAddress; - UINT32 Length; -} STM_UNMAP_ADDRESS_RANGE_DESCRIPTOR; - - -/** - Since the normal OS environment runs with a different set of page tables= than - the SMM guest, virtual mappings will certainly be different. In order to= do a - guest virtual to host physical translation of an address from the normal= OS - code (EIP for example), it is necessary to walk the page tables governin= g the - OS page mappings. Since the SMM guest has no direct access to the page t= ables, - it must ask the STM to do this page table walk. This is supported via the - StmAddressLookup VMCALL. All OS page table formats need to be supported, - (e.g. PAE, PSE, Intel64, EPT, etc.) - - StmAddressLookup takes a CR3 value and a virtual address from the interr= upted - code as input and returns the corresponding physical address. It also - optionally maps the physical address into the SMM guest's virtual address - space. This new mapping persists ONLY for the duration of the SMI and if - needed in subsequent SMIs it must be remapped. PAT cache types follow the - interrupted environment's page table. - - If EPT is enabled, OS CR3 only provides guest physical address informati= on, - but the SMM guest might also need to know the host physical address. Sin= ce - SMM does not have direct access rights to EPT (it is protected by the ST= M), - SMM can input InterruptedEptp to let STM help to walk through it, and ou= tput - the host physical address. - - @param EAX #STM_API_ADDRESS_LOOKUP (0x00000003) - @param EBX Low 32 bits of virtual address of caller allocated - STM_ADDRESS_LOOKUP_DESCRIPTOR structure. - @param ECX High 32 bits of virtual address of caller allocated - STM_ADDRESS_LOOKUP_DESCRIPTOR structure. If Intel64Mode is - clear (0), ECX must be zero. - - @retval CF 0 - No error, EAX set to STM_SUCCESS. PhysicalAddress contain= s the - host physical address determined by walking the interrupte= d SMM - guest's page tables. SmmGuestVirtualAddress contains the = SMM - guest's virtual mapping of the requested address. - @retval CF 1 - An error occurred, EAX holds relevant error value. - @retval EAX #ERROR_STM_SECURITY_VIOLATION - The requested page was a protected page. - @retval EAX #ERROR_STM_PAGE_NOT_FOUND - The requested virtual address did not exist in the page gi= ven - page table. - @retval EAX #ERROR_STM_BAD_CR3 - The CR3 input was invalid. CR3 values must be from one of = the - interrupted guest, or from the interrupted guest of another - processor. - @retval EAX #ERROR_STM_PHYSICAL_OVER_4G - The resulting physical address is greater than 4G and no v= irtual - address was supplied. The STM could not determine what add= ress - within the SMM guest's virtual address space to do the map= ping. - STM_ADDRESS_LOOKUP_DESCRIPTOR field PhysicalAddress contai= ns the - physical address determined by walking the interrupted - environment's page tables. - @retval EAX #ERROR_STM_VIRTUAL_SPACE_TOO_SMALL - A specific virtual mapping was requested, but - SmmGuestVirtualAddress + Length exceeds 4G and the SMI han= dler - is running in 32 bit mode. - @retval EAX #ERROR_STM_UNSPECIFIED - An unspecified error occurred. - - @note All other registers unmodified. -**/ -#define STM_API_ADDRESS_LOOKUP 0x00000003 - -/** - STM Lookup Address Range Descriptor for #STM_API_ADDRESS_LOOKUP VMCALL -**/ -typedef struct { - UINT64 InterruptedGuestVirtualAddress; - UINT32 Length; - UINT64 InterruptedCr3; - UINT64 InterruptedEptp; - UINT32 MapToSmmGuest:2; - UINT32 InterruptedCr4Pae:1; - UINT32 InterruptedCr4Pse:1; - UINT32 InterruptedIa32eMode:1; - UINT32 Reserved1:27; - UINT32 Reserved2; - UINT64 PhysicalAddress; - UINT64 SmmGuestVirtualAddress; -} STM_ADDRESS_LOOKUP_DESCRIPTOR; - -/** - Define values for the MapToSmmGuest field of #STM_ADDRESS_LOOKUP_DESCRIP= TOR - @{ -**/ -#define STM_ADDRESS_LOOKUP_DESCRIPTOR_DO_NOT_MAP 0 -#define STM_ADDRESS_LOOKUP_DESCRIPTOR_ONE_TO_ONE 1 -#define STM_ADDRESS_LOOKUP_DESCRIPTOR_VIRTUAL_ADDRESS_SPECIFIED 3 -/// @} - - -/** - When returning from a protection exception (see section 6.2), the SMM gu= est - can instruct the STM to take one of two paths. It can either request a v= alue - be logged to the TXT.ERRORCODE register and subsequently reset the machi= ne - (indicating it couldn't resolve the problem), or it can request that the= STM - resume the SMM guest again with the specified register state. - - Unlike other VMCALL interfaces, StmReturnFromProtectionException behaves= more - like a jump or an IRET instruction than a "call". It does not return dir= ectly - to the caller, but indirectly to a different location specified on the - caller's stack (see section 6.2) or not at all. - - If the SMM guest STM protection exception handler itself causes a protec= tion - exception (e.g. a single nested exception), or more than 100 un-nested - exceptions occur within the scope of a single SMI event, the STM must wr= ite - STM_CRASH_PROTECTION_EXCEPTION_FAILURE to the TXT.ERRORCODE register and - assert TXT.CMD.SYS_RESET. The reason for these restrictions is to simpli= fy - the code requirements while still enabling a reasonable debugging capabi= lity. - - @param EAX #STM_API_RETURN_FROM_PROTECTION_EXCEPTION (0x00000004) - @param EBX If 0, resume SMM guest using register state found on except= ion - stack. If in range 0x01..0x0F, EBX contains a BIOS error c= ode - which the STM must record in the TXT.ERRORCODE register and - subsequently reset the system via TXT.CMD.SYS_RESET. The va= lue - of the TXT.ERRORCODE register is calculated as follows: - - TXT.ERRORCODE =3D (EBX & 0x0F) | STM_CRASH_BIOS_PANIC - - Values 0x10..0xFFFFFFFF are reserved, do not use. - -**/ -#define STM_API_RETURN_FROM_PROTECTION_EXCEPTION 0x00000004 - - -/** - VMCALL API Numbers - API number convention: MLE facing VMCALL interfaces have bit 16 set. - - The STM configuration lifecycle is as follows: - 1. SENTER->SINIT->MLE: MLE begins execution with SMI disabled (masked). - 2. MLE invokes #STM_API_INITIALIZE_PROTECTION VMCALL to prepare STM for - setup of initial protection profile. This is done on a single CPU a= nd - has global effect. - 3. MLE invokes #STM_API_PROTECT_RESOURCE VMCALL to define the initial - protection profile. The protection profile is global across all CPU= s. - 4. MLE invokes #STM_API_START VMCALL to enable the STM to begin receiv= ing - SMI events. This must be done on every logical CPU. - 5. MLE may invoke #STM_API_PROTECT_RESOURCE VMCALL or - #STM_API_UNPROTECT_RESOURCE VMCALL during runtime as many times as - necessary. - 6. MLE invokes #STM_API_STOP VMCALL to disable the STM. SMI is again m= asked - following #STM_API_STOP VMCALL. -**/ - -/** - StartStmVmcall() is used to configure an STM that is present in MSEG. SM= Is - should remain disabled from the invocation of GETSEC[SENTER] until they = are - re-enabled by StartStmVMCALL(). When StartStmVMCALL() returns, SMI is - enabled and the STM has been started and is active. Prior to invoking - StartStmVMCALL(), the MLE root should first invoke - InitializeProtectionVMCALL() followed by as many iterations of - ProtectResourceVMCALL() as necessary to establish the initial protection - profile. StartStmVmcall() must be invoked on all processor threads. - - @param EAX #STM_API_START (0x00010001) - @param EDX STM configuration options. These provide the MLE with the - ability to pass configuration parameters to the STM. - - @retval CF 0 - No error, EAX set to STM_SUCCESS. The STM has been configu= red - and is now active and the guarding all requested resources. - @retval CF 1 - An error occurred, EAX holds relevant error value. - @retval EAX #ERROR_STM_ALREADY_STARTED - The STM is already configured and active. STM remains acti= ve and - guarding previously enabled resource list. - @retval EAX #ERROR_STM_WITHOUT_SMX_UNSUPPORTED - The StartStmVMCALL() was invoked from VMX root mode, but o= utside - of SMX. This error code indicates the STM or platform does= not - support the STM outside of SMX. The SMI handler remains ac= tive - and operates in legacy mode. See Appendix C - @retval EAX #ERROR_STM_UNSUPPORTED_MSR_BIT - The CPU doesn't support the MSR bit. The STM is not active. - @retval EAX #ERROR_STM_UNSPECIFIED - An unspecified error occurred. - - @note All other registers unmodified. -**/ -#define STM_API_START (BIT16 | 1) - -/** - Bit values for EDX input parameter to #STM_API_START VMCALL - @{ -**/ -#define STM_CONFIG_SMI_UNBLOCKING_BY_VMX_OFF BIT0 -/// @} - - -/** - The StopStmVMCALL() is invoked by the MLE to teardown an active STM. Thi= s is - normally done as part of a full teardown of the SMX environment when the - system is being shut down. At the time the call is invoked, SMI is enabl= ed - and the STM is active. When the call returns, the STM has been stopped = and - all STM context is discarded and SMI is disabled. - - @param EAX #STM_API_STOP (0x00010002) - - @retval CF 0 - No error, EAX set to STM_SUCCESS. The STM has been stopped= and - is no longer processing SMI events. SMI is blocked. - @retval CF 1 - An error occurred, EAX holds relevant error value. - @retval EAX #ERROR_STM_STOPPED - The STM was not active. - @retval EAX #ERROR_STM_UNSPECIFIED - An unspecified error occurred. - - @note All other registers unmodified. -**/ -#define STM_API_STOP (BIT16 | 2) - - -/** - The ProtectResourceVMCALL() is invoked by the MLE root to request protec= tion - of specific resources. The request is defined by a STM_RESOURCE_LIST, wh= ich - may contain more than one resource descriptor. Each resource descriptor = is - processed separately by the STM. Whether or not protection for any speci= fic - resource is granted is returned by the STM via the ReturnStatus bit in t= he - associated STM_RSC_DESC_HEADER. - - @param EAX #STM_API_PROTECT_RESOURCE (0x00010003) - @param EBX Low 32 bits of physical address of caller allocated - STM_RESOURCE_LIST. Bits 11:0 are ignored and assumed to be = zero, - making the buffer 4K aligned. - @param ECX High 32 bits of physical address of caller allocated - STM_RESOURCE_LIST. - - @note All fields of STM_RESOURCE_LIST are inputs only, except for the - ReturnStatus bit. On input, the ReturnStatus bit must be clear. On - return, the ReturnStatus bit is set for each resource request gra= nted, - and clear for each resource request denied. There are no other fi= elds - modified by ProtectResourceVMCALL(). The STM_RESOURCE_LIST must be - contained entirely within a single 4K page. - - @retval CF 0 - No error, EAX set to STM_SUCCESS. The STM has successfully - merged the entire protection request into the active prote= ction - profile. There is therefore no need to check the ReturnSt= atus - bits in the STM_RESOURCE_LIST. - @retval CF 1 - An error occurred, EAX holds relevant error value. - @retval EAX #ERROR_STM_UNPROTECTABLE_RESOURCE - At least one of the requested resource protections interse= cts a - BIOS required resource. Therefore, the caller must walk th= rough - the STM_RESOURCE_LIST to determine which of the requested - resources was not granted protection. The entire list must= be - traversed since there may be multiple failures. - @retval EAX #ERROR_STM_MALFORMED_RESOURCE_LIST - The resource list could not be parsed correctly, or did not - terminate before crossing a 4K page boundary. The caller m= ust - walk through the STM_RESOURCE_LIST to determine which of t= he - requested resources was not granted protection. The entire= list - must be traversed since there may be multiple failures. - @retval EAX #ERROR_STM_OUT_OF_RESOURCES - The STM has encountered an internal error and cannot compl= ete - the request. - @retval EAX #ERROR_STM_UNSPECIFIED - An unspecified error occurred. - - @note All other registers unmodified. -**/ -#define STM_API_PROTECT_RESOURCE (BIT16 | 3) - - -/** - The UnProtectResourceVMCALL() is invoked by the MLE root to request that= the - STM allow the SMI handler access to the specified resources. - - @param EAX #STM_API_UNPROTECT_RESOURCE (0x00010004) - @param EBX Low 32 bits of physical address of caller allocated - STM_RESOURCE_LIST. Bits 11:0 are ignored and assumed to be = zero, - making the buffer 4K aligned. - @param ECX High 32 bits of physical address of caller allocated - STM_RESOURCE_LIST. - - @note All fields of STM_RESOURCE_LIST are inputs only, except for the - ReturnStatus bit. On input, the ReturnStatus bit must be clear. On - return, the ReturnStatus bit is set for each resource processed. = For - a properly formed STM_RESOURCE_LIST, this should be all resources - listed. There are no other fields modified by - UnProtectResourceVMCALL(). The STM_RESOURCE_LIST must be contained - entirely within a single 4K page. - - @retval CF 0 - No error, EAX set to STM_SUCCESS. The requested resources = are - not being guarded by the STM. - @retval CF 1 - An error occurred, EAX holds relevant error value. - @retval EAX #ERROR_STM_MALFORMED_RESOURCE_LIST - The resource list could not be parsed correctly, or did not - terminate before crossing a 4K page boundary. The caller m= ust - walk through the STM_RESOURCE_LIST to determine which of t= he - requested resources were not able to be unprotected. The e= ntire - list must be traversed since there may be multiple failure= s. - @retval EAX #ERROR_STM_UNSPECIFIED - An unspecified error occurred. - - @note All other registers unmodified. -**/ -#define STM_API_UNPROTECT_RESOURCE (BIT16 | 4) - - -/** - The GetBiosResourcesVMCALL() is invoked by the MLE root to request the l= ist - of BIOS required resources from the STM. - - @param EAX #STM_API_GET_BIOS_RESOURCES (0x00010005) - @param EBX Low 32 bits of physical address of caller allocated destina= tion - buffer. Bits 11:0 are ignored and assumed to be zero, makin= g the - buffer 4K aligned. - @param ECX High 32 bits of physical address of caller allocated destin= ation - buffer. - @param EDX Indicates which page of the BIOS resource list to copy into= the - destination buffer. The first page is indicated by 0, the s= econd - page by 1, etc. - - @retval CF 0 - No error, EAX set to STM_SUCCESS. The destination buffer - contains the BIOS required resources. If the page retrieve= d is - the last page, EDX will be cleared to 0. If there are more= pages - to retrieve, EDX is incremented to the next page index. Ca= lling - software should iterate on GetBiosResourcesVMCALL() until = EDX is - returned cleared to 0. - @retval CF 1 - An error occurred, EAX holds relevant error value. - @retval EAX #ERROR_STM_PAGE_NOT_FOUND - The page index supplied in EDX input was out of range. - @retval EAX #ERROR_STM_UNSPECIFIED - An unspecified error occurred. - @retval EDX Page index of next page to read. A return of EDX=3D0 signi= fies - that the entire list has been read. - @note EDX is both an input and an output register. - - @note All other registers unmodified. -**/ -#define STM_API_GET_BIOS_RESOURCES (BIT16 | 5) - - -/** - The ManageVmcsDatabaseVMCALL() is invoked by the MLE root to add or remo= ve an - MLE guest (including the MLE root) from the list of protected domains. - - @param EAX #STM_API_MANAGE_VMCS_DATABASE (0x00010006) - @param EBX Low 32 bits of physical address of caller allocated - STM_VMCS_DATABASE_REQUEST. Bits 11:0 are ignored and assume= d to - be zero, making the buffer 4K aligned. - @param ECX High 32 bits of physical address of caller allocated - STM_VMCS_DATABASE_REQUEST. - - @note All fields of STM_VMCS_DATABASE_REQUEST are inputs only. They ar= e not - modified by ManageVmcsDatabaseVMCALL(). - - @retval CF 0 - No error, EAX set to STM_SUCCESS. - @retval CF 1 - An error occurred, EAX holds relevant error value. - @retval EAX #ERROR_STM_INVALID_VMCS - Indicates a request to remove a VMCS from the database was= made, - but the referenced VMCS was not found in the database. - @retval EAX #ERROR_STM_VMCS_PRESENT - Indicates a request to add a VMCS to the database was made= , but - the referenced VMCS was already present in the database. - @retval EAX #ERROR_INVALID_PARAMETER - Indicates non-zero reserved field. - @retval EAX #ERROR_STM_UNSPECIFIED - An unspecified error occurred - - @note All other registers unmodified. -**/ -#define STM_API_MANAGE_VMCS_DATABASE (BIT16 | 6) - -/** - STM VMCS Database Request for #STM_API_MANAGE_VMCS_DATABASE VMCALL -**/ -typedef struct { - /// - /// bits 11:0 are reserved and must be 0 - /// - UINT64 VmcsPhysPointer; - UINT32 DomainType :4; - UINT32 XStatePolicy :2; - UINT32 DegradationPolicy :4; - /// - /// Must be 0 - /// - UINT32 Reserved1 :22; - UINT32 AddOrRemove; -} STM_VMCS_DATABASE_REQUEST; - -/** - Values for the DomainType field of #STM_VMCS_DATABASE_REQUEST - @{ -**/ -#define DOMAIN_UNPROTECTED 0 -#define DOMAIN_DISALLOWED_IO_OUT BIT0 -#define DOMAIN_DISALLOWED_IO_IN BIT1 -#define DOMAIN_INTEGRITY BIT2 -#define DOMAIN_CONFIDENTIALITY BIT3 -#define DOMAIN_INTEGRITY_PROT_OUT_IN (DOMAIN_INTEGRITY) -#define DOMAIN_FULLY_PROT_OUT_IN (DOMAIN_CONFIDENTIALITY | DOMAIN_INT= EGRITY) -#define DOMAIN_FULLY_PROT (DOMAIN_FULLY_PROT_OUT_IN | DOMAIN_D= ISALLOWED_IO_IN | DOMAIN_DISALLOWED_IO_OUT) -/// @} - -/** - Values for the XStatePolicy field of #STM_VMCS_DATABASE_REQUEST - @{ -**/ -#define XSTATE_READWRITE 0x00 -#define XSTATE_READONLY 0x01 -#define XSTATE_SCRUB 0x03 -/// @} - -/** - Values for the AddOrRemove field of #STM_VMCS_DATABASE_REQUEST - @{ -**/ -#define STM_VMCS_DATABASE_REQUEST_ADD 1 -#define STM_VMCS_DATABASE_REQUEST_REMOVE 0 -/// @} - - -/** - InitializeProtectionVMCALL() prepares the STM for setup of the initial - protection profile which is subsequently communicated via one or more - invocations of ProtectResourceVMCALL(), prior to invoking StartStmVMCALL= (). - It is only necessary to invoke InitializeProtectionVMCALL() on one proce= ssor - thread. InitializeProtectionVMCALL() does not alter whether SMIs are ma= sked - or unmasked. The STM should return back to the MLE with "Blocking by SMI= " set - to 1 in the GUEST_INTERRUPTIBILITY field for the VMCS the STM created fo= r the - MLE guest. - - @param EAX #STM_API_INITIALIZE_PROTECTION (0x00010007) - - @retval CF 0 - No error, EAX set to STM_SUCCESS, EBX bits set to indicate= STM - capabilities as defined below. The STM has set up an empty - protection profile, except for the resources that it sets = up to - protect itself. The STM must not allow the SMI handler to = map - any pages from the MSEG Base to the top of TSEG. The STM m= ust - also not allow SMI handler access to those MSRs which the = STM - requires for its own protection. - @retval CF 1 - An error occurred, EAX holds relevant error value. - @retval EAX #ERROR_STM_ALREADY_STARTED - The STM is already configured and active. The STM remains = active - and guarding the previously enabled resource list. - @retval EAX #ERROR_STM_UNPROTECTABLE - The STM determines that based on the platform configuratio= n, the - STM is unable to protect itself. For example, the BIOS req= uired - resource list contains memory pages in MSEG. - @retval EAX #ERROR_STM_UNSPECIFIED - An unspecified error occurred. - - @note All other registers unmodified. -**/ -#define STM_API_INITIALIZE_PROTECTION (BIT16 | 7) - -/** - Byte granular support bits returned in EBX from #STM_API_INITIALIZE_PROT= ECTION - @{ -**/ -#define STM_RSC_BGI BIT1 -#define STM_RSC_BGM BIT2 -#define STM_RSC_MSR BIT3 -/// @} - - -/** - The ManageEventLogVMCALL() is invoked by the MLE root to control the log= ging - feature. It consists of several sub-functions to facilitate establishmen= t of - the log itself, configuring what events will be logged, and functions to - start, stop, and clear the log. - - @param EAX #STM_API_MANAGE_EVENT_LOG (0x00010008) - @param EBX Low 32 bits of physical address of caller allocated - STM_EVENT_LOG_MANAGEMENT_REQUEST. Bits 11:0 are ignored and - assumed to be zero, making the buffer 4K aligned. - @param ECX High 32 bits of physical address of caller allocated - STM_EVENT_LOG_MANAGEMENT_REQUEST. - - @retval CF=3D0 - No error, EAX set to STM_SUCCESS. - @retval CF=3D1 - An error occurred, EAX holds relevant error value. See subfunct= ion - descriptions below for details. - - @note All other registers unmodified. -**/ -#define STM_API_MANAGE_EVENT_LOG (BIT16 | 8) - -/// -/// STM Event Log Management Request for #STM_API_MANAGE_EVENT_LOG VMCALL -/// -typedef struct { - UINT32 SubFunctionIndex; - union { - struct { - UINT32 PageCount; - // - // number of elements is PageCount - // - UINT64 Pages[]; - } LogBuffer; - // - // bitmap of EVENT_TYPE - // - UINT32 EventEnableBitmap; - } Data; -} STM_EVENT_LOG_MANAGEMENT_REQUEST; - -/** - Defines values for the SubFunctionIndex field of - #STM_EVENT_LOG_MANAGEMENT_REQUEST - @{ -**/ -#define STM_EVENT_LOG_MANAGEMENT_REQUEST_NEW_LOG 1 -#define STM_EVENT_LOG_MANAGEMENT_REQUEST_CONFIGURE_LOG 2 -#define STM_EVENT_LOG_MANAGEMENT_REQUEST_START_LOG 3 -#define STM_EVENT_LOG_MANAGEMENT_REQUEST_STOP_LOG 4 -#define STM_EVENT_LOG_MANAGEMENT_REQUEST_CLEAR_LOG 5 -#define STM_EVENT_LOG_MANAGEMENT_REQUEST_DELETE_LOG 6 -/// @} - -/** - Log Entry Header -**/ -typedef struct { - UINT32 EventSerialNumber; - UINT16 Type; - UINT16 Lock :1; - UINT16 Valid :1; - UINT16 ReadByMle :1; - UINT16 Wrapped :1; - UINT16 Reserved :12; -} LOG_ENTRY_HEADER; - -/** - Enum values for the Type field of #LOG_ENTRY_HEADER -**/ -typedef enum { - EvtLogStarted, - EvtLogStopped, - EvtLogInvalidParameterDetected, - EvtHandledProtectionException, - /// - /// unhandled protection exceptions result in reset & cannot be logged - /// - EvtBiosAccessToUnclaimedResource, - EvtMleResourceProtectionGranted, - EvtMleResourceProtectionDenied, - EvtMleResourceUnprotect, - EvtMleResourceUnprotectError, - EvtMleDomainTypeDegraded, - /// - /// add more here - /// - EvtMleMax, - /// - /// Not used - /// - EvtInvalid =3D 0xFFFFFFFF, -} EVENT_TYPE; - -typedef struct { - UINT32 Reserved; -} ENTRY_EVT_LOG_STARTED; - -typedef struct { - UINT32 Reserved; -} ENTRY_EVT_LOG_STOPPED; - -typedef struct { - UINT32 VmcallApiNumber; -} ENTRY_EVT_LOG_INVALID_PARAM; - -typedef struct { - STM_RSC Resource; -} ENTRY_EVT_LOG_HANDLED_PROTECTION_EXCEPTION; - -typedef struct { - STM_RSC Resource; -} ENTRY_EVT_BIOS_ACCESS_UNCLAIMED_RSC; - -typedef struct { - STM_RSC Resource; -} ENTRY_EVT_MLE_RSC_PROT_GRANTED; - -typedef struct { - STM_RSC Resource; -} ENTRY_EVT_MLE_RSC_PROT_DENIED; - -typedef struct { - STM_RSC Resource; -} ENTRY_EVT_MLE_RSC_UNPROT; - -typedef struct { - STM_RSC Resource; -} ENTRY_EVT_MLE_RSC_UNPROT_ERROR; - -typedef struct { - UINT64 VmcsPhysPointer; - UINT8 ExpectedDomainType; - UINT8 DegradedDomainType; -} ENTRY_EVT_MLE_DOMAIN_TYPE_DEGRADED; - -typedef union { - ENTRY_EVT_LOG_STARTED Started; - ENTRY_EVT_LOG_STOPPED Stopped; - ENTRY_EVT_LOG_INVALID_PARAM InvalidParam; - ENTRY_EVT_LOG_HANDLED_PROTECTION_EXCEPTION HandledProtectionException; - ENTRY_EVT_BIOS_ACCESS_UNCLAIMED_RSC BiosUnclaimedRsc; - ENTRY_EVT_MLE_RSC_PROT_GRANTED MleRscProtGranted; - ENTRY_EVT_MLE_RSC_PROT_DENIED MleRscProtDenied; - ENTRY_EVT_MLE_RSC_UNPROT MleRscUnprot; - ENTRY_EVT_MLE_RSC_UNPROT_ERROR MleRscUnprotError; - ENTRY_EVT_MLE_DOMAIN_TYPE_DEGRADED MleDomainTypeDegraded; -} LOG_ENTRY_DATA; - -typedef struct { - LOG_ENTRY_HEADER Hdr; - LOG_ENTRY_DATA Data; -} STM_LOG_ENTRY; - -/** - Maximum STM Log Entry Size -**/ -#define STM_LOG_ENTRY_SIZE 256 - - -/** - STM Protection Exception Stack Frame Structures -**/ - -typedef struct { - UINT32 Rdi; - UINT32 Rsi; - UINT32 Rbp; - UINT32 Rdx; - UINT32 Rcx; - UINT32 Rbx; - UINT32 Rax; - UINT32 Cr3; - UINT32 Cr2; - UINT32 Cr0; - UINT32 VmcsExitInstructionInfo; - UINT32 VmcsExitInstructionLength; - UINT64 VmcsExitQualification; - /// - /// An TXT_SMM_PROTECTION_EXCEPTION_TYPE num value - /// - UINT32 ErrorCode; - UINT32 Rip; - UINT32 Cs; - UINT32 Rflags; - UINT32 Rsp; - UINT32 Ss; -} STM_PROTECTION_EXCEPTION_STACK_FRAME_IA32; - -typedef struct { - UINT64 R15; - UINT64 R14; - UINT64 R13; - UINT64 R12; - UINT64 R11; - UINT64 R10; - UINT64 R9; - UINT64 R8; - UINT64 Rdi; - UINT64 Rsi; - UINT64 Rbp; - UINT64 Rdx; - UINT64 Rcx; - UINT64 Rbx; - UINT64 Rax; - UINT64 Cr8; - UINT64 Cr3; - UINT64 Cr2; - UINT64 Cr0; - UINT64 VmcsExitInstructionInfo; - UINT64 VmcsExitInstructionLength; - UINT64 VmcsExitQualification; - /// - /// An TXT_SMM_PROTECTION_EXCEPTION_TYPE num value - /// - UINT64 ErrorCode; - UINT64 Rip; - UINT64 Cs; - UINT64 Rflags; - UINT64 Rsp; - UINT64 Ss; -} STM_PROTECTION_EXCEPTION_STACK_FRAME_X64; - -typedef union { - STM_PROTECTION_EXCEPTION_STACK_FRAME_IA32 *Ia32StackFrame; - STM_PROTECTION_EXCEPTION_STACK_FRAME_X64 *X64StackFrame; -} STM_PROTECTION_EXCEPTION_STACK_FRAME; - -/** - Enum values for the ErrorCode field in - #STM_PROTECTION_EXCEPTION_STACK_FRAME_IA32 and - #STM_PROTECTION_EXCEPTION_STACK_FRAME_X64 -**/ -typedef enum { - TxtSmmPageViolation =3D 1, - TxtSmmMsrViolation, - TxtSmmRegisterViolation, - TxtSmmIoViolation, - TxtSmmPciViolation -} TXT_SMM_PROTECTION_EXCEPTION_TYPE; - -/** - TXT Pocessor SMM Descriptor (PSD) structures -**/ - -typedef struct { - UINT64 SpeRip; - UINT64 SpeRsp; - UINT16 SpeSs; - UINT16 PageViolationException:1; - UINT16 MsrViolationException:1; - UINT16 RegisterViolationException:1; - UINT16 IoViolationException:1; - UINT16 PciViolationException:1; - UINT16 Reserved1:11; - UINT32 Reserved2; -} STM_PROTECTION_EXCEPTION_HANDLER; - -typedef struct { - UINT8 ExecutionDisableOutsideSmrr:1; - UINT8 Intel64Mode:1; - UINT8 Cr4Pae : 1; - UINT8 Cr4Pse : 1; - UINT8 Reserved1 : 4; -} STM_SMM_ENTRY_STATE; - -typedef struct { - UINT8 SmramToVmcsRestoreRequired : 1; ///> BIOS restore hint - UINT8 ReinitializeVmcsRequired : 1; ///> BIOS request - UINT8 Reserved2 : 6; -} STM_SMM_RESUME_STATE; - -typedef struct { - UINT8 DomainType : 4; ///> STM input to BIOS on each SMI - UINT8 XStatePolicy : 2; ///> STM input to BIOS on each SMI - UINT8 EptEnabled : 1; - UINT8 Reserved3 : 1; -} STM_SMM_STATE; - -#define TXT_SMM_PSD_OFFSET 0xfb00 -#define TXT_PROCESSOR_SMM_DESCRIPTOR_SIGNATURE SIGNATURE_64('T', 'X',= 'T', 'P', 'S', 'S', 'I', 'G') -#define TXT_PROCESSOR_SMM_DESCRIPTOR_VERSION_MAJOR 1 -#define TXT_PROCESSOR_SMM_DESCRIPTOR_VERSION_MINOR 0 - -typedef struct { - UINT64 Signature; - UINT16 Size; - UINT8 SmmDescriptorVerMajor; - UINT8 SmmDescriptorVerMinor; - UINT32 LocalApicId; - STM_SMM_ENTRY_STATE SmmEntryState; - STM_SMM_RESUME_STATE SmmResumeState; - STM_SMM_STATE StmSmmState; - UINT8 Reserved4; - UINT16 SmmCs; - UINT16 SmmDs; - UINT16 SmmSs; - UINT16 SmmOtherSegment; - UINT16 SmmTr; - UINT16 Reserved5; - UINT64 SmmCr3; - UINT64 SmmStmSetupRip; - UINT64 SmmStmTeardownRip; - UINT64 SmmSmiHandlerRip; - UINT64 SmmSmiHandlerRsp; - UINT64 SmmGdtPtr; - UINT32 SmmGdtSize; - UINT32 RequiredStmSmmRevId; - STM_PROTECTION_EXCEPTION_HANDLER StmProtectionExceptionHandler; - UINT64 Reserved6; - UINT64 BiosHwResourceRequirementsPtr; - // extend area - UINT64 AcpiRsdp; - UINT8 PhysicalAddressBits; -} TXT_PROCESSOR_SMM_DESCRIPTOR; - -#pragma pack () +#include =20 #endif --=20 2.21.0.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#45142): https://edk2.groups.io/g/devel/message/45142 Mute This Topic: https://groups.io/mt/32796067/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- From nobody Sun Apr 28 22:42:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+45143+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45143+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1565245524; cv=none; d=zoho.com; s=zohoarc; b=AWae2UNG1cai/+MGsoe+95Jq9R83s18zLB81jlpoCIe1OyGbaJCly7Ke0LajylzkONJtLzWL+8kZ/IQtH9wkCGxat50fhNY2M0wtr2AJ4/Vvfv+L0XZ7vMTsafyGM7ysMnEa2yP5R2XmfghSU5zAsFvMNA+3xtIL24KvAsuaPrg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1565245524; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To:ARC-Authentication-Results; bh=o+Xl76+bSVYmEKfHbFR6I06LzUySCwYlWzt053nHF04=; b=O7ns/JFFdQgiXUzmnqVKHLjBylpil0IeUiqw7PQ87QAXTQfaycWjNmjBZcTukURp3vyIgRVRvuHgnUKWcLFmUKFYkUZZZxWsRlDjrgfLu6Q7rlmQeiqUSvSpVHsAq2bZ4QJeZISw45ekrUytijOzCQwoP1Af4E3QRygzojU03+A= ARC-Authentication-Results: i=1; mx.zoho.com; dkim=pass; spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+45143+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 156524552446318.676944735627217; Wed, 7 Aug 2019 23:25:24 -0700 (PDT) Return-Path: X-Received: from mga14.intel.com (mga14.intel.com []) by groups.io with SMTP; Wed, 07 Aug 2019 23:25:22 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Aug 2019 23:25:22 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.64,360,1559545200"; d="scan'208";a="198923471" X-Received: from ydong10-win10.ccr.corp.intel.com ([10.239.158.133]) by fmsmga004.fm.intel.com with ESMTP; 07 Aug 2019 23:25:21 -0700 From: "Dong, Eric" To: devel@edk2.groups.io Cc: "Ni, Ray" , Laszlo Ersek Subject: [edk2-devel] [Patch v6 9/9] UefiCpuPkg: Update code to include register definitions from MdePkg Date: Thu, 8 Aug 2019 14:25:00 +0800 Message-Id: <20190808062500.26996-10-eric.dong@intel.com> In-Reply-To: <20190808062500.26996-1-eric.dong@intel.com> References: <20190808062500.26996-1-eric.dong@intel.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,eric.dong@intel.com Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1565245524; bh=FpGPeh+ulZe7M7TMev87+tK0L3hwebwiK6mCAddWyR0=; h=Cc:Date:From:Reply-To:Subject:To; b=eoYzTNqSc/owfRJY+TLq50ZZxwmaAjZnQGvmSzCRD2ERhbW8Dr/jx1EpZMECQSakRsb bFMEs4OchwZUW2NzVjEIfVSQYEVMcdKEHjnJGI/vElhlIKLQdZ2mh9b2kBJanyntD+DAw DSOL3p4hGmc7YO+yVrNMIGbQiM1ULSB1cpo= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: "Ni, Ray" Signed-off-by: Ray Ni Reviewed-by: Eric Dong Regression-tested-by: Laszlo Ersek --- UefiCpuPkg/Application/Cpuid/Cpuid.c | 2 +- UefiCpuPkg/CpuDxe/CpuDxe.h | 4 ++-- UefiCpuPkg/CpuDxe/CpuPageTable.c | 4 ++-- UefiCpuPkg/CpuMpPei/CpuPaging.c | 6 +++--- UefiCpuPkg/Include/Library/RegisterCpuFeaturesLib.h | 2 +- UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h | 2 +- UefiCpuPkg/Include/Protocol/SmMonitorInit.h | 4 ++-- UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c | 6 +++--- .../Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c | 6 +++--- .../Library/CpuCommonFeaturesLib/CpuCommonFeatures.h | 6 +++--- UefiCpuPkg/Library/MpInitLib/MpLib.h | 8 ++++---- UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 4 ++-- UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c | 6 +++--- UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmStm.c | 6 +++--- UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h | 4 ++-- UefiCpuPkg/PiSmmCpuDxeSmm/SmramSaveState.c | 2 -- 16 files changed, 35 insertions(+), 37 deletions(-) diff --git a/UefiCpuPkg/Application/Cpuid/Cpuid.c b/UefiCpuPkg/Application/= Cpuid/Cpuid.c index 2f907034e6..7a994eba9a 100644 --- a/UefiCpuPkg/Application/Cpuid/Cpuid.c +++ b/UefiCpuPkg/Application/Cpuid/Cpuid.c @@ -9,7 +9,7 @@ #include #include #include -#include +#include =20 /// /// Macro used to display the value of a bit field in a register returned = by CPUID. diff --git a/UefiCpuPkg/CpuDxe/CpuDxe.h b/UefiCpuPkg/CpuDxe/CpuDxe.h index b029be430b..a6762f1a0b 100644 --- a/UefiCpuPkg/CpuDxe/CpuDxe.h +++ b/UefiCpuPkg/CpuDxe/CpuDxe.h @@ -1,7 +1,7 @@ /** @file CPU DXE Module to produce CPU ARCH Protocol and CPU MP Protocol. =20 - Copyright (c) 2008 - 2017, Intel Corporation. All rights reserved.
+ Copyright (c) 2008 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 **/ @@ -13,7 +13,7 @@ =20 #include #include -#include +#include =20 #include #include diff --git a/UefiCpuPkg/CpuDxe/CpuPageTable.c b/UefiCpuPkg/CpuDxe/CpuPageTa= ble.c index 36ce90d66c..ec5cd424fc 100644 --- a/UefiCpuPkg/CpuDxe/CpuPageTable.c +++ b/UefiCpuPkg/CpuDxe/CpuPageTable.c @@ -15,8 +15,8 @@ #include #include #include -#include -#include +#include +#include =20 #include "CpuDxe.h" #include "CpuPageTable.h" diff --git a/UefiCpuPkg/CpuMpPei/CpuPaging.c b/UefiCpuPkg/CpuMpPei/CpuPagin= g.c index 57a75539ee..a462e7ee1e 100644 --- a/UefiCpuPkg/CpuMpPei/CpuPaging.c +++ b/UefiCpuPkg/CpuMpPei/CpuPaging.c @@ -1,14 +1,14 @@ /** @file Basic paging support for the CPU to enable Stack Guard. =20 -Copyright (c) 2018, Intel Corporation. All rights reserved.
+Copyright (c) 2018 - 2019, Intel Corporation. All rights reserved.
=20 SPDX-License-Identifier: BSD-2-Clause-Patent =20 **/ =20 -#include -#include +#include +#include #include #include #include diff --git a/UefiCpuPkg/Include/Library/RegisterCpuFeaturesLib.h b/UefiCpuP= kg/Include/Library/RegisterCpuFeaturesLib.h index 191348d770..e420e7f075 100644 --- a/UefiCpuPkg/Include/Library/RegisterCpuFeaturesLib.h +++ b/UefiCpuPkg/Include/Library/RegisterCpuFeaturesLib.h @@ -10,7 +10,7 @@ #define __REGISTER_CPU_FEATURES_LIB_H__ =20 #include -#include +#include #include =20 /// diff --git a/UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h b/UefiCpuPkg/In= clude/Library/SmmCpuFeaturesLib.h index e6c5679e13..39ca304b31 100644 --- a/UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h +++ b/UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h @@ -11,7 +11,7 @@ SPDX-License-Identifier: BSD-2-Clause-Patent =20 #include #include -#include +#include #include =20 /// diff --git a/UefiCpuPkg/Include/Protocol/SmMonitorInit.h b/UefiCpuPkg/Inclu= de/Protocol/SmMonitorInit.h index fa57cb18a5..db2ce11f1e 100644 --- a/UefiCpuPkg/Include/Protocol/SmMonitorInit.h +++ b/UefiCpuPkg/Include/Protocol/SmMonitorInit.h @@ -1,7 +1,7 @@ /** @file STM service protocol definition =20 - Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.
+ Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 **/ @@ -10,7 +10,7 @@ #define _SM_MONITOR_INIT_PROTOCOL_H_ =20 #include -#include +#include =20 #define EFI_SM_MONITOR_INIT_PROTOCOL_GUID \ { 0x228f344d, 0xb3de, 0x43bb, 0xa4, 0xd7, 0xea, 0x20, 0xb, 0x1b, 0x14,= 0x82} diff --git a/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c b/UefiCpuPkg/Li= brary/BaseXApicLib/BaseXApicLib.c index 89f4f6550f..33ea15ca29 100644 --- a/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c +++ b/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c @@ -10,10 +10,10 @@ =20 **/ =20 -#include +#include #include -#include -#include +#include +#include =20 #include #include diff --git a/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c b/U= efiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c index 89eeb3a955..d0f92b33dc 100644 --- a/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c +++ b/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c @@ -11,10 +11,10 @@ =20 **/ =20 -#include +#include #include -#include -#include +#include +#include =20 #include #include diff --git a/UefiCpuPkg/Library/CpuCommonFeaturesLib/CpuCommonFeatures.h b/= UefiCpuPkg/Library/CpuCommonFeaturesLib/CpuCommonFeatures.h index 8406c6c161..25d0174727 100644 --- a/UefiCpuPkg/Library/CpuCommonFeaturesLib/CpuCommonFeatures.h +++ b/UefiCpuPkg/Library/CpuCommonFeaturesLib/CpuCommonFeatures.h @@ -1,7 +1,7 @@ /** @file CPU Common features library header file. =20 - Copyright (c) 2017 - 2018, Intel Corporation. All rights reserved.
+ Copyright (c) 2017 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 **/ @@ -19,8 +19,8 @@ #include #include =20 -#include -#include +#include +#include =20 /** Prepares for the data used by CPU feature detection and initialization. diff --git a/UefiCpuPkg/Library/MpInitLib/MpLib.h b/UefiCpuPkg/Library/MpIn= itLib/MpLib.h index 4b12f91d47..107872b367 100644 --- a/UefiCpuPkg/Library/MpInitLib/MpLib.h +++ b/UefiCpuPkg/Library/MpInitLib/MpLib.h @@ -11,10 +11,10 @@ =20 #include =20 -#include -#include -#include -#include +#include +#include +#include +#include =20 #include #include diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/Mtrr= Lib/MtrrLib.c index 9415897b48..dfa848022b 100644 --- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c +++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c @@ -11,8 +11,8 @@ **/ =20 #include -#include -#include +#include +#include =20 #include #include diff --git a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c b/Uef= iCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c index 0e7fd80488..bddb7a219c 100644 --- a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c +++ b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c @@ -1,7 +1,7 @@ /** @file The CPU specific programming for PiSmmCpuDxeSmm module. =20 -Copyright (c) 2010 - 2016, Intel Corporation. All rights reserved.
+Copyright (c) 2010 - 2019, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent =20 **/ @@ -13,8 +13,8 @@ SPDX-License-Identifier: BSD-2-Clause-Patent #include #include #include -#include -#include +#include +#include =20 // // Machine Specific Registers (MSRs) diff --git a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmStm.c b/UefiCpuPkg/Lib= rary/SmmCpuFeaturesLib/SmmStm.c index 82c63da002..52a376c27d 100644 --- a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmStm.c +++ b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmStm.c @@ -15,9 +15,9 @@ #include #include #include -#include -#include -#include +#include +#include +#include =20 #include =20 diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h b/UefiCpuPkg/PiSmmC= puDxeSmm/PiSmmCpuDxeSmm.h index 186809f431..92f0db351c 100644 --- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h +++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h @@ -53,8 +53,8 @@ SPDX-License-Identifier: BSD-2-Clause-Patent #include #include =20 -#include -#include +#include +#include =20 #include "CpuService.h" #include "SmmProfile.h" diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SmramSaveState.c b/UefiCpuPkg/PiSmmC= puDxeSmm/SmramSaveState.c index 11102c9cbf..b1a492725a 100644 --- a/UefiCpuPkg/PiSmmCpuDxeSmm/SmramSaveState.c +++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SmramSaveState.c @@ -14,8 +14,6 @@ SPDX-License-Identifier: BSD-2-Clause-Patent #include #include #include -#include -#include =20 #include "PiSmmCpuDxeSmm.h" =20 --=20 2.21.0.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#45143): https://edk2.groups.io/g/devel/message/45143 Mute This Topic: https://groups.io/mt/32796068/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-