--- /dev/null
+/** @file\r
+ Main PAL API's defined in Intel Itanium Architecture Software Developer\92s Manual.\r
+\r
+ Copyright (c) 2006 - 2008, Intel Corporation \r
+ All rights reserved. This program and the accompanying materials \r
+ are licensed and made available under the terms and conditions of the BSD License \r
+ which accompanies this distribution. The full text of the license may be found at \r
+ http://opensource.org/licenses/bsd-license.php \r
+\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+\r
+**/\r
+\r
+#ifndef __PAL_API_H__\r
+#define __PAL_API_H__\r
+\r
+#define PAL_SUCCESS 0x0\r
+\r
+//\r
+// CacheType of PAL_CACHE_FLUSH.\r
+//\r
+#define PAL_CACHE_FLUSH_INSTRUCTION_ALL 1\r
+#define PAL_CACHE_FLUSH_DATA_ALL 2\r
+#define PAL_CACHE_FLUSH_ALL 3\r
+#define PAL_CACHE_FLUSH_SYNC_TO_DATA 4\r
+\r
+\r
+//\r
+// Bitmask of Opearation of PAL_CACHE_FLUSH.\r
+//\r
+#define PAL_CACHE_FLUSH_INVALIDATE_LINES BIT0\r
+#define PAL_CACHE_FLUSH_NO_INVALIDATE_LINES 0\r
+#define PAL_CACHE_FLUSH_POLL_INTERRUPT BIT1\r
+#define PAL_CACHE_FLUSH_NO_INTERRUPT 0\r
+\r
+/**\r
+ PAL Procedure - PAL_CACHE_FLUSH.\r
+\r
+ Flush the instruction or data caches. It is required by IPF.\r
+ The PAL procedure supports the Static Registers calling\r
+ convention. It could be called at virtual mode and physical\r
+ mode.\r
+\r
+ @param Index Index of PAL_CACHE_FLUSH within the\r
+ list of PAL procedures.\r
+ @param CacheType Unsigned 64-bit integer indicating\r
+ which cache to flush.\r
+ @param Operation Formatted bit vector indicating the\r
+ operation of this call.\r
+ @param ProgressIndicator Unsigned 64-bit integer specifying\r
+ the starting position of the flush\r
+ operation.\r
+\r
+ @retval 2 Call completed without error, but a PMI\r
+ was taken during the execution of this\r
+ procedure.\r
+ @retval 1 Call has not completed flushing due to\r
+ a pending interrupt.\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error\r
+\r
+ @return R9 Unsigned 64-bit integer specifying the vector\r
+ number of the pending interrupt.\r
+ @return R10 Unsigned 64-bit integer specifying the\r
+ starting position of the flush operation.\r
+ @return R11 Unsigned 64-bit integer specifying the vector\r
+ number of the pending interrupt.\r
+\r
+**/\r
+#define PAL_CACHE_FLUSH 1\r
+\r
+\r
+//\r
+// Attributes of PAL_CACHE_CONFIG_INFO1\r
+//\r
+#define PAL_CACHE_ATTR_WT 0\r
+#define PAL_CACHE_ATTR_WB 1\r
+\r
+//\r
+// PAL_CACHE_CONFIG_INFO1.StoreHint\r
+//\r
+#define PAL_CACHE_STORE_TEMPORAL 0\r
+#define PAL_CACHE_STORE_NONE_TEMPORAL 3\r
+\r
+//\r
+// PAL_CACHE_CONFIG_INFO1.StoreHint\r
+//\r
+#define PAL_CACHE_STORE_TEMPORAL_LVL_1 0\r
+#define PAL_CACHE_STORE_NONE_TEMPORAL_LVL_ALL 3\r
+\r
+//\r
+// PAL_CACHE_CONFIG_INFO1.StoreHint\r
+//\r
+#define PAL_CACHE_LOAD_TEMPORAL_LVL_1 0\r
+#define PAL_CACHE_LOAD_NONE_TEMPORAL_LVL_1 1\r
+#define PAL_CACHE_LOAD_NONE_TEMPORAL_LVL_ALL 3\r
+\r
+//\r
+// Detail the characteristics of a given processor controlled\r
+// cache in the cache hierarchy.\r
+//\r
+typedef struct {\r
+ UINT64 IsUnified : 1;\r
+ UINT64 Attributes : 2;\r
+ UINT64 Associativity:8;\r
+ UINT64 LineSize:8;\r
+ UINT64 Stride:8;\r
+ UINT64 StoreLatency:8;\r
+ UINT64 StoreHint:8;\r
+ UINT64 LoadHint:8;\r
+} PAL_CACHE_INFO_RETURN1;\r
+\r
+//\r
+// Detail the characteristics of a given processor controlled\r
+// cache in the cache hierarchy.\r
+//\r
+typedef struct {\r
+ UINT64 CacheSize:32;\r
+ UINT64 AliasBoundary:8;\r
+ UINT64 TagLsBits:8;\r
+ UINT64 TagMsBits:8;\r
+} PAL_CACHE_INFO_RETURN2;\r
+\r
+/**\r
+ PAL Procedure - PAL_CACHE_INFO.\r
+\r
+ Return detailed instruction or data cache information. It is\r
+ required by IPF. The PAL procedure supports the Static\r
+ Registers calling convention. It could be called at virtual\r
+ mode and physical mode.\r
+\r
+ @param Index Index of PAL_CACHE_INFO within the list of\r
+ PAL procedures.\r
+ @param CacheLevel Unsigned 64-bit integer specifying the\r
+ level in the cache hierarchy for which\r
+ information is requested. This value must\r
+ be between 0 and one less than the value\r
+ returned in the cache_levels return value\r
+ from PAL_CACHE_SUMMARY.\r
+ @param CacheType Unsigned 64-bit integer with a value of 1\r
+ for instruction cache and 2 for data or\r
+ unified cache. All other values are\r
+ reserved.\r
+ @param Reserved Should be 0.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error\r
+\r
+ @return R9 Detail the characteristics of a given\r
+ processor controlled cache in the cache\r
+ hierarchy. See PAL_CACHE_INFO_RETURN1.\r
+ @return R10 Detail the characteristics of a given\r
+ processor controlled cache in the cache\r
+ hierarchy. See PAL_CACHE_INFO_RETURN2.\r
+ @return R11 Reserved with 0.\r
+\r
+**/\r
+#define PAL_CACHE_INFO 2\r
+\r
+\r
+\r
+//\r
+// Level of PAL_CACHE_INIT.\r
+//\r
+#define PAL_CACHE_INIT_ALL 0xffffffffffffffffULL\r
+\r
+//\r
+// CacheType\r
+//\r
+#define PAL_CACHE_INIT_TYPE_INSTRUCTION 0x1\r
+#define PAL_CACHE_INIT_TYPE_DATA 0x2\r
+#define PAL_CACHE_INIT_TYPE_INSTRUCTION_AND_DATA 0x3\r
+\r
+//\r
+// Restrict of PAL_CACHE_INIT.\r
+//\r
+#define PAL_CACHE_INIT_NO_RESTRICT 0\r
+#define PAL_CACHE_INIT_RESTRICTED 1\r
+\r
+/**\r
+ PAL Procedure - PAL_CACHE_INIT.\r
+\r
+ Initialize the instruction or data caches. It is required by\r
+ IPF. The PAL procedure supports the Static Registers calling\r
+ convention. It could be called at physical mode.\r
+\r
+ @param Index Index of PAL_CACHE_INIT within the list of PAL\r
+ procedures.\r
+ @param Level Unsigned 64-bit integer containing the level of\r
+ cache to initialize. If the cache level can be\r
+ initialized independently, only that level will\r
+ be initialized. Otherwise\r
+ implementation-dependent side-effects will\r
+ occur.\r
+ @param CacheType Unsigned 64-bit integer with a value of 1 to\r
+ initialize the instruction cache, 2 to\r
+ initialize the data cache, or 3 to\r
+ initialize both. All other values are\r
+ reserved.\r
+ @param Restrict Unsigned 64-bit integer with a value of 0 or\r
+ 1. All other values are reserved. If\r
+ restrict is 1 and initializing the specified\r
+ level and cache_type of the cache would\r
+ cause side-effects, PAL_CACHE_INIT will\r
+ return -4 instead of initializing the cache.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -4 Call could not initialize the specified\r
+ level and cache_type of the cache without\r
+ side-effects and restrict was 1.\r
+\r
+**/\r
+#define PAL_CACHE_INIT 3\r
+\r
+\r
+//\r
+// PAL_CACHE_PROTECTION.Method.\r
+//\r
+#define PAL_CACHE_PROTECTION_NONE_PROTECT 0\r
+#define PAL_CACHE_PROTECTION_ODD_PROTECT 1\r
+#define PAL_CACHE_PROTECTION_EVEN_PROTECT 2\r
+#define PAL_CACHE_PROTECTION_ECC_PROTECT 3\r
+\r
+\r
+\r
+//\r
+// PAL_CACHE_PROTECTION.TagOrData.\r
+//\r
+#define PAL_CACHE_PROTECTION_PROTECT_DATA 0\r
+#define PAL_CACHE_PROTECTION_PROTECT_TAG 1\r
+#define PAL_CACHE_PROTECTION_PROTECT_TAG_ANDTHEN_DATA 2\r
+#define PAL_CACHE_PROTECTION_PROTECT_DATA_ANDTHEN_TAG 3\r
+\r
+//\r
+// 32-bit protection information structures.\r
+//\r
+typedef struct {\r
+ UINT32 DataBits:8;\r
+ UINT32 TagProtLsb:6;\r
+ UINT32 TagProtMsb:6;\r
+ UINT32 ProtBits:6;\r
+ UINT32 Method:4;\r
+ UINT32 TagOrData:2;\r
+} PAL_CACHE_PROTECTION;\r
+\r
+/**\r
+ PAL Procedure - PAL_CACHE_PROT_INFO.\r
+\r
+ Return instruction or data cache protection information. It is\r
+ required by IPF. The PAL procedure supports the Static\r
+ Registers calling convention. It could be called at physical\r
+ mode and Virtual mode.\r
+\r
+ @param Index Index of PAL_CACHE_PROT_INFO within the list of\r
+ PAL procedures.\r
+ @param CacheLevel Unsigned 64-bit integer specifying the level\r
+ in the cache hierarchy for which information\r
+ is requested. This value must be between 0\r
+ and one less than the value returned in the\r
+ cache_levels return value from\r
+ PAL_CACHE_SUMMARY.\r
+ @param CacheType Unsigned 64-bit integer with a value of 1\r
+ for instruction cache and 2 for data or\r
+ unified cache. All other values are\r
+ reserved.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Detail the characteristics of a given\r
+ processor controlled cache in the cache\r
+ hierarchy. See PAL_CACHE_PROTECTION[0..1].\r
+ @return R10 Detail the characteristics of a given\r
+ processor controlled cache in the cache\r
+ hierarchy. See PAL_CACHE_PROTECTION[2..3].\r
+ @return R11 Detail the characteristics of a given\r
+ processor controlled cache in the cache\r
+ hierarchy. See PAL_CACHE_PROTECTION[4..5].\r
+\r
+**/\r
+#define PAL_CACHE_PROT_INFO 38\r
+\r
+/**\r
+\r
+ @param ThreadId The thread identifier of the logical\r
+ processor for which information is being\r
+ returned. This value will be unique on a per\r
+ core basis.\r
+\r
+ @param CoreId The core identifier of the logical processor\r
+ for which information is being returned.\r
+ This value will be unique on a per physical\r
+ processor package basis.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 ThreadId : 16;\r
+ UINT64 Reserved1: 16;\r
+ UINT64 CoreId: 16;\r
+ UINT64 Reserved2: 16;\r
+} PAL_PCOC_N_CACHE_INFO1;\r
+\r
+/**\r
+\r
+ @param LogicalAddress Logical address: geographical address\r
+ of the logical processor for which\r
+ information is being returned. This is\r
+ the same value that is returned by the\r
+ PAL_FIXED_ADDR procedure when it is\r
+ called on the logical processor.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 LogicalAddress : 16;\r
+ UINT64 Reserved1: 16;\r
+ UINT64 Reserved2: 32;\r
+} PAL_PCOC_N_CACHE_INFO2;\r
+\r
+/**\r
+ PAL Procedure - PAL_CACHE_SHARED_INFO.\r
+\r
+ Returns information on which logical processors share caches.\r
+ It is optional. The PAL procedure supports the Static\r
+ Registers calling convention. It could be called at physical\r
+ mode and Virtual mode.\r
+\r
+ @param Index Index of PAL_CACHE_SHARED_INFO within the list\r
+ of PAL procedures.\r
+ @param CacheLevel Unsigned 64-bit integer specifying the\r
+ level in the cache hierarchy for which\r
+ information is requested. This value must\r
+ be between 0 and one less than the value\r
+ returned in the cache_levels return value\r
+ from PAL_CACHE_SUMMARY.\r
+ @param CacheType Unsigned 64-bit integer with a value of 1\r
+ for instruction cache and 2 for data or\r
+ unified cache. All other values are\r
+ reserved.\r
+ @param ProcNumber Unsigned 64-bit integer that specifies for\r
+ which logical processor information is\r
+ being requested. This input argument must\r
+ be zero for the first call to this\r
+ procedure and can be a maximum value of\r
+ one less than the number of logical\r
+ processors sharing this cache, which is\r
+ returned by the num_shared return value.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Unsigned integer that returns the number of\r
+ logical processors that share the processor\r
+ cache level and type, for which information was\r
+ requested.\r
+ @return R10 The format of PAL_PCOC_N_CACHE_INFO1.\r
+ @return R11 The format of PAL_PCOC_N_CACHE_INFO2.\r
+\r
+**/\r
+#define PAL_CACHE_SHARED_INFO 43\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_CACHE_SUMMARY.\r
+\r
+ Return a summary of the cache hierarchy. It is required by\r
+ IPF. The PAL procedure supports the Static Registers calling\r
+ convention. It could be called at physical mode and Virtual\r
+ mode.\r
+\r
+ @param Index Index of PAL_CACHE_SUMMARY within the list of\r
+ PAL procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 CacheLevels Unsigned 64-bit integer denoting the\r
+ number of levels of cache\r
+ implemented by the processor.\r
+ Strictly, this is the number of\r
+ levels for which the cache\r
+ controller is integrated into the\r
+ processor (the cache SRAMs may be\r
+ external to the processor).\r
+ @return R10 UniqueCaches Unsigned 64-bit integer denoting the\r
+ number of unique caches implemented\r
+ by the processor. This has a maximum\r
+ of 2*cache_levels, but may be less\r
+ if any of the levels in the cache\r
+ hierarchy are unified caches or do\r
+ not have both instruction and data\r
+ caches.\r
+\r
+**/\r
+#define PAL_CACHE_SUMMARY 4\r
+\r
+\r
+//\r
+// Virtual Memory Attributes implemented by processor.\r
+//\r
+#define PAL_MEMORY_ATTR_WB 0\r
+#define PAL_MEMORY_ATTR_WC 6\r
+#define PAL_MEMORY_ATTR_UC 4\r
+#define PAL_MEMORY_ATTR_UCE 5\r
+#define PAL_MEMORY_ATTR_NATPAGE 7\r
+\r
+/**\r
+ PAL Procedure - PAL_MEM_ATTRIB.\r
+\r
+ Return a list of supported memory attributes.. It is required\r
+ by IPF. The PAL procedure supports the Static Registers calling\r
+ convention. It could be called at physical mode and Virtual\r
+ mode.\r
+\r
+ @param Index Index of PAL_MEM_ATTRIB within the list of PAL\r
+ procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Attributes 8-bit vector of memory attributes\r
+ implemented by processor. See Virtual\r
+ Memory Attributes above.\r
+\r
+**/\r
+\r
+#define PAL_MEM_ATTRIB 5\r
+\r
+/**\r
+ PAL Procedure - PAL_PREFETCH_VISIBILITY.\r
+\r
+ Used in architected sequence to transition pages from a\r
+ cacheable, speculative attribute to an uncacheable attribute.\r
+ It is required by IPF. The PAL procedure supports the Static\r
+ Registers calling convention. It could be called at physical\r
+ mode and Virtual mode.\r
+\r
+ @param Index Index of PAL_PREFETCH_VISIBILITY within the list\r
+ of PAL procedures.\r
+ @param TransitionType Unsigned integer specifying the type\r
+ of memory attribute transition that is\r
+ being performed.\r
+\r
+ @retval 1 Call completed without error; this\r
+ call is not necessary on remote\r
+ processors.\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+**/\r
+#define PAL_PREFETCH_VISIBILITY 41\r
+\r
+/**\r
+ PAL Procedure - PAL_PTCE_INFO.\r
+\r
+ Return information needed for ptc.e instruction to purge\r
+ entire TC. It is required by IPF. The PAL procedure supports\r
+ the Static Registers calling convention. It could be called at\r
+ physical mode and Virtual mode.\r
+\r
+ @param Index Index of PAL_PTCE_INFO within the list\r
+ of PAL procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Unsigned 64-bit integer denoting the beginning\r
+ address to be used by the first PTCE instruction\r
+ in the purge loop.\r
+ @return R10 Two unsigned 32-bit integers denoting the loop\r
+ counts of the outer (loop 1) and inner (loop 2)\r
+ purge loops. count1 (loop 1) is contained in bits\r
+ 63:32 of the parameter, and count2 (loop 2) is\r
+ contained in bits 31:0 of the parameter.\r
+ @return R11 Two unsigned 32-bit integers denoting the loop\r
+ strides of the outer (loop 1) and inner (loop 2)\r
+ purge loops. stride1 (loop 1) is contained in bits\r
+ 63:32 of the parameter, and stride2 (loop 2) is\r
+ contained in bits 31:0 of the parameter.\r
+\r
+**/\r
+#define PAL_PTCE_INFO 6\r
+\r
+\r
+\r
+/**\r
+\r
+ @param NumberSets Unsigned 8-bit integer denoting the number\r
+ of hash sets for the specified level\r
+ (1=fully associative)\r
+\r
+ @param NumberWays Unsigned 8-bit integer denoting the\r
+ associativity of the specified level\r
+ (1=direct).\r
+\r
+ @param NumberEntries Unsigned 16-bit integer denoting the\r
+ number of entries in the specified TC.\r
+\r
+\r
+ @param PageSizeIsOptimized Flag denoting whether the\r
+ specified level is optimized for\r
+ the region's preferred page size\r
+ (1=optimized) tc_pages indicates\r
+ which page sizes are usable by\r
+ this translation cache.\r
+\r
+ @param TcIsUnified Flag denoting whether the specified TC is\r
+ unified (1=unified).\r
+\r
+ @param EntriesReduction Flag denoting whether installed\r
+ translation registers will reduce\r
+ the number of entries within the\r
+ specified TC.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 NumberSets:8;\r
+ UINT64 NumberWays:8;\r
+ UINT64 NumberEntries:16;\r
+ UINT64 PageSizeIsOptimized:1;\r
+ UINT64 TcIsUnified:1;\r
+ UINT64 EntriesReduction:1;\r
+} PAL_TC_INFO;\r
+\r
+/**\r
+ PAL Procedure - PAL_VM_INFO.\r
+\r
+ Return detailed information about virtual memory features\r
+ supported in the processor. It is required by IPF. The PAL\r
+ procedure supports the Static Registers calling convention. It\r
+ could be called at physical mode and Virtual mode.\r
+\r
+ @param Index Index of PAL_VM_INFO within the list\r
+ of PAL procedures.\r
+ @param TcLevel Unsigned 64-bit integer specifying the level\r
+ in the TLB hierarchy for which information is\r
+ required. This value must be between 0 and one\r
+ less than the value returned in the\r
+ vm_info_1.num_tc_levels return value from\r
+ PAL_VM_SUMMARY.\r
+ @param TcType Unsigned 64-bit integer with a value of 1 for\r
+ instruction translation cache and 2 for data\r
+ or unified translation cache. All other values\r
+ are reserved.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 8-byte formatted value returning information\r
+ about the specified TC. See PAL_TC_INFO above.\r
+ @return R10 64-bit vector containing a bit for each page\r
+ size supported in the specified TC, where bit\r
+ position n indicates a page size of 2**n.\r
+\r
+**/\r
+#define PAL_VM_INFO 7\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_VM_PAGE_SIZE.\r
+\r
+ Return virtual memory TC and hardware walker page sizes\r
+ supported in the processor. It is required by IPF. The PAL\r
+ procedure supports the Static Registers calling convention. It\r
+ could be called at physical mode and Virtual mode.\r
+\r
+ @param Index Index of PAL_VM_PAGE_SIZE within the list\r
+ of PAL procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 64-bit vector containing a bit for each\r
+ architected page size that is supported for\r
+ TLB insertions and region registers.\r
+ @return R10 64-bit vector containing a bit for each\r
+ architected page size supported for TLB purge\r
+ operations.\r
+\r
+**/\r
+#define PAL_VM_PAGE_SIZE 34\r
+\r
+/**\r
+\r
+ @param WalkerPresent 1-bit flag indicating whether a hardware\r
+ TLB walker is implemented (1 = walker\r
+ present).\r
+\r
+ @param WidthOfPhysicalAddress Unsigned 7-bit integer\r
+ denoting the number of bits of\r
+ physical address implemented.\r
+\r
+ @param WidthOfKey Unsigned 8-bit integer denoting the number\r
+ of bits mplemented in the PKR.key field.\r
+\r
+ @param MaxPkrIndex Unsigned 8-bit integer denoting the\r
+ maximum PKR index (number of PKRs-1).\r
+\r
+ @param HashTagId Unsigned 8-bit integer which uniquely\r
+ identifies the processor hash and tag\r
+ algorithm.\r
+\r
+ @param MaxDtrIndex Unsigned 8 bit integer denoting the\r
+ maximum data translation register index\r
+ (number of dtr entries - 1).\r
+\r
+ @param MaxItrIndex Unsigned 8 bit integer denoting the\r
+ maximum instruction translation register\r
+ index (number of itr entries - 1).\r
+\r
+ @param NumberOfUniqueTc Unsigned 8-bit integer denoting the\r
+ number of unique TCs implemented.\r
+ This is a maximum of\r
+ 2*num_tc_levels.\r
+\r
+ @param NumberOfTcLevels Unsigned 8-bit integer denoting the\r
+ number of TC levels.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 WalkerPresent:1;\r
+ UINT64 WidthOfPhysicalAddress: 7;\r
+ UINT64 WidthOfKey:8;\r
+ UINT64 MaxPkrIndex:8;\r
+ UINT64 HashTagId:8;\r
+ UINT64 MaxDtrIndex:8;\r
+ UINT64 MaxItrIndex:8;\r
+ UINT64 NumberOfUniqueTc:8;\r
+ UINT64 NumberOfTcLevels:8;\r
+} PAL_VM_INFO1;\r
+\r
+/**\r
+\r
+ @param WidthOfVirtualAddress Unsigned 8-bit integer denoting\r
+ is the total number of virtual\r
+ address bits - 1.\r
+\r
+ @param WidthOfRid Unsigned 8-bit integer denoting the number\r
+ of bits implemented in the RR.rid field.\r
+\r
+ @param MaxPurgedTlbs Unsigned 16 bit integer denoting the\r
+ maximum number of concurrent outstanding\r
+ TLB purges allowed by the processor. A\r
+ value of 0 indicates one outstanding\r
+ purge allowed. A value of 216-1\r
+ indicates no limit on outstanding\r
+ purges. All other values indicate the\r
+ actual number of concurrent outstanding\r
+ purges allowed.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 WidthOfVirtualAddress:8;\r
+ UINT64 WidthOfRid:8;\r
+ UINT64 MaxPurgedTlbs:16;\r
+ UINT64 Reserved:32;\r
+} PAL_VM_INFO2;\r
+\r
+/**\r
+ PAL Procedure - PAL_VM_SUMMARY.\r
+\r
+ Return summary information about virtual memory features\r
+ supported in the processor. It is required by IPF. The PAL\r
+ procedure supports the Static Registers calling convention. It\r
+ could be called at physical mode and Virtual mode.\r
+\r
+ @param Index Index of PAL_VM_SUMMARY within the list\r
+ of PAL procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 8-byte formatted value returning global virtual\r
+ memory information. See PAL_VM_INFO1 above.\r
+ @return R10 8-byte formatted value returning global virtual\r
+ memory information. See PAL_VM_INFO2 above.\r
+\r
+**/\r
+#define PAL_VM_SUMMARY 8\r
+\r
+\r
+//\r
+// Bit mask of TR_valid flag.\r
+//\r
+#define PAL_TR_ACCESS_RIGHT_IS_VALID BIT0\r
+#define PAL_TR_PRIVILEGE_LEVEL_IS_VALID BIT1\r
+#define PAL_TR_DIRTY_IS_VALID BIT2\r
+#define PAL_TR_MEMORY_ATTR_IS_VALID BIT3\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_VM_TR_READ.\r
+\r
+ Read contents of a translation register. It is required by\r
+ IPF. The PAL procedure supports the Stacked Register calling\r
+ convention. It could be called at physical mode.\r
+\r
+ @param Index Index of PAL_VM_TR_READ within the list\r
+ of PAL procedures.\r
+ @param RegNumber Unsigned 64-bit number denoting which TR to\r
+ read.\r
+ @param TrType Unsigned 64-bit number denoting whether to\r
+ read an ITR (0) or DTR (1). All other values\r
+ are reserved.\r
+ @param TrBuffer 64-bit pointer to the 32-byte memory buffer in\r
+ which translation data is returned.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Formatted bit vector denoting which fields are\r
+ valid. See TR_valid above.\r
+\r
+**/\r
+#define PAL_VM_TR_READ 261\r
+\r
+\r
+\r
+\r
+//\r
+// Bit Mask of Processor Bus Fesatures .\r
+//\r
+\r
+/**\r
+\r
+ When 0, bus data errors are detected and single bit errors are\r
+ corrected. When 1, no error detection or correction is done.\r
+\r
+**/\r
+#define PAL_BUS_DISABLE_DATA_ERROR_SIGNALLING BIT63\r
+\r
+\r
+/**\r
+\r
+ When 0, bus address errors are signalled on the bus. When 1,\r
+ no bus errors are signalled on the bus. If Disable Bus Address\r
+ Error Checking is 1, this bit is ignored.\r
+\r
+**/\r
+#define PAL_BUS_DISABLE_ADDRESS_ERROR_SIGNALLING BIT62\r
+\r
+\r
+\r
+\r
+/**\r
+\r
+ When 0, bus errors are detected, single bit errors are\r
+ corrected., and a CMCI or MCA is generated internally to the\r
+ processor. When 1, no bus address errors are detected or\r
+ corrected.\r
+\r
+**/\r
+#define PAL_BUS_DISABLE_ADDRESS_ERROR_CHECK BIT61\r
+\r
+\r
+/**\r
+\r
+ When 0, bus protocol errors (BINIT#) are signaled by the\r
+ processor on the bus. When 1, bus protocol errors (BINIT#) are\r
+ not signaled on the bus. If Disable Bus Initialization Event\r
+ Checking is 1, this bit is ignored.\r
+\r
+**/\r
+#define PAL_BUS_DISABLE_INITIALIZATION_EVENT_SIGNALLING BIT60\r
+\r
+\r
+/**\r
+\r
+ When 0, bus protocol errors (BINIT#) are detected and sampled\r
+ and an MCA is generated internally to the processor. When 1,\r
+ the processor will ignore bus protocol error conditions\r
+ (BINIT#).\r
+\r
+**/\r
+#define PAL_BUS_DISABLE_INITIALIZATION_EVENT_CHECK BIT59\r
+\r
+\r
+\r
+/**\r
+\r
+ When 0, BERR# is signalled if a bus error is detected. When 1,\r
+ bus errors are not signalled on the bus.\r
+\r
+**/\r
+#define PAL_BUS_DISABLE_ERROR_SIGNALLING BIT58\r
+\r
+\r
+\r
+\r
+/**\r
+\r
+ When 0, BERR# is signalled when internal processor requestor\r
+ initiated bus errors are detected. When 1, internal requester\r
+ bus errors are not signalled on the bus.\r
+\r
+**/\r
+#define PAL_BUS_DISABLE__INTERNAL_ERROR_SIGNALLING BIT57\r
+\r
+\r
+/**\r
+\r
+ When 0, the processor takes an MCA if BERR# is asserted. When\r
+ 1, the processor ignores the BERR# signal.\r
+\r
+**/\r
+#define PAL_BUS_DISABLE_ERROR_CHECK BIT56\r
+\r
+\r
+/**\r
+\r
+ When 0, the processor asserts BINIT# if it detects a parity\r
+ error on the signals which identify the transactions to which\r
+ this is a response. When 1, the processor ignores parity on\r
+ these signals.\r
+\r
+**/\r
+#define PAL_BUS_DISABLE_RSP_ERROR_CHECK BIT55\r
+\r
+\r
+/**\r
+\r
+ When 0, the in-order transaction queue is limited only by the\r
+ number of hardware entries. When 1, the processor's in-order\r
+ transactions queue is limited to one entry.\r
+\r
+**/\r
+#define PAL_BUS_DISABLE_TRANSACTION_QUEUE BIT54\r
+\r
+/**\r
+\r
+ Enable a bus cache line replacement transaction when a cache\r
+ line in the exclusive state is replaced from the highest level\r
+ processor cache and is not present in the lower level processor\r
+ caches. When 0, no bus cache line replacement transaction will\r
+ be seen on the bus. When 1, bus cache line replacement\r
+ transactions will be seen on the bus when the above condition is\r
+ detected.\r
+\r
+**/\r
+#define PAL_BUS_ENABLE_EXCLUSIVE_CACHE_LINE_REPLACEMENT BIT53\r
+\r
+\r
+/**\r
+\r
+ Enable a bus cache line replacement transaction when a cache\r
+ line in the shared or exclusive state is replaced from the\r
+ highest level processor cache and is not present in the lower\r
+ level processor caches.\r
+ When 0, no bus cache line replacement transaction will be seen\r
+ on the bus. When 1, bus cache line replacement transactions\r
+ will be seen on the bus when the above condition is detected.\r
+\r
+**/\r
+#define PAL_BUS_ENABLE_SHARED_CACHE_LINE_REPLACEMENT BIT52\r
+\r
+\r
+\r
+/**\r
+\r
+ When 0, the data bus is configured at the 2x data transfer\r
+ rate.When 1, the data bus is configured at the 1x data\r
+ transfer rate, 30 Opt. Req. Disable Bus Lock Mask. When 0, the\r
+ processor executes locked transactions atomically. When 1, the\r
+ processor masks the bus lock signal and executes locked\r
+ transactions as a non-atomic series of transactions.\r
+\r
+**/\r
+#define PAL_BUS_ENABLE_HALF_TRANSFER BIT30\r
+\r
+/**\r
+\r
+ When 0, the processor will deassert bus request when finished\r
+ with each transaction. When 1, the processor will continue to\r
+ assert bus request after it has finished, if it was the last\r
+ agent to own the bus and if there are no other pending\r
+ requests.\r
+\r
+**/\r
+#define PAL_BUS_REQUEST_BUS_PARKING BIT29\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_BUS_GET_FEATURES.\r
+\r
+ Return configurable processor bus interface features and their\r
+ current settings. It is required by IPF. The PAL procedure\r
+ supports the Stacked Register calling convention. It could be\r
+ called at physical mode.\r
+\r
+ @param Index Index of PAL_BUS_GET_FEATURES within the list\r
+ of PAL procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 64-bit vector of features implemented.\r
+ (1=implemented, 0=not implemented)\r
+ @return R10 64-bit vector of current feature settings.\r
+ @return R11 64-bit vector of features controllable by\r
+ software. (1=controllable, 0= not controllable)\r
+\r
+**/\r
+#define PAL_BUS_GET_FEATURES 9\r
+\r
+/**\r
+ PAL Procedure - PAL_BUS_SET_FEATURES.\r
+\r
+ Enable or disable configurable features in processor bus\r
+ interface. It is required by IPF. It is required by IPF. The PAL procedure\r
+ supports the Static Registers calling convention. It could be\r
+ called at physical mode.\r
+\r
+ @param Index Index of PAL_BUS_SET_FEATURES within the list\r
+ of PAL procedures.\r
+ @param FeatureSelect 64-bit vector denoting desired state of\r
+ each feature (1=select, 0=non-select).\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+**/\r
+#define PAL_BUS_SET_FEATURES 10\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_DEBUG_INFO.\r
+\r
+ Return the number of instruction and data breakpoint\r
+ registers. It is required by IPF. It is required by IPF. The\r
+ PAL procedure supports the Static Registers calling\r
+ convention. It could be called at physical mode and virtual\r
+ mode.\r
+\r
+ @param Index Index of PAL_DEBUG_INFO within the list of PAL\r
+ procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Unsigned 64-bit integer denoting the number of\r
+ pairs of instruction debug registers implemented\r
+ by the processor.\r
+ @return R10 Unsigned 64-bit integer denoting the number of\r
+ pairs of data debug registers implemented by the\r
+ processor.\r
+\r
+**/\r
+#define PAL_DEBUG_INFO 11\r
+\r
+/**\r
+ PAL Procedure - PAL_FIXED_ADDR.\r
+\r
+ Return the fixed component of a processor's directed address.\r
+ It is required by IPF. It is required by IPF. The PAL\r
+ procedure supports the Static Registers calling convention. It\r
+ could be called at physical mode and virtual mode.\r
+\r
+ @param Index Index of PAL_FIXED_ADDR within the list of PAL\r
+ procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Fixed geographical address of this processor.\r
+\r
+**/\r
+#define PAL_FIXED_ADDR 12\r
+\r
+/**\r
+ PAL Procedure - PAL_FREQ_BASE.\r
+\r
+ Return the frequency of the output clock for use by the\r
+ platform, if generated by the processor. It is optinal. The\r
+ PAL procedure supports the Static Registers calling\r
+ convention. It could be called at physical mode and virtual\r
+ mode.\r
+\r
+ @param Index Index of PAL_FREQ_BASE within the list of PAL\r
+ procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Base frequency of the platform if generated by the\r
+ processor chip.\r
+\r
+**/\r
+#define PAL_FREQ_BASE 13\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_FREQ_RATIOS.\r
+\r
+ Return ratio of processor, bus, and interval time counter to\r
+ processor input clock or output clock for platform use, if\r
+ generated by the processor. It is required by IPF. The PAL\r
+ procedure supports the Static Registers calling convention. It\r
+ could be called at physical mode and virtual mode.\r
+\r
+ @param Index Index of PAL_FREQ_RATIOS within the list of PAL\r
+ procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Ratio of the processor frequency to the input\r
+ clock of the processor, if the platform clock is\r
+ generated externally or to the output clock to the\r
+ platform, if the platform clock is generated by\r
+ the processor.\r
+ @return R10 Ratio of the bus frequency to the input clock of\r
+ the processor, if the platform clock is generated\r
+ externally or to the output clock to the platform,\r
+ if the platform clock is generated by the\r
+ processor.\r
+ @return R11 Ratio of the interval timer counter rate to input\r
+ clock of the processor, if the platform clock is\r
+ generated externally or to the output clock to the\r
+ platform, if the platform clock is generated by\r
+ the processor.\r
+\r
+**/\r
+#define PAL_FREQ_RATIOS 14\r
+\r
+/**\r
+\r
+ @param NumberOfLogicalProcessors Total number of logical\r
+ processors on this physical\r
+ processor package that are\r
+ enabled.\r
+\r
+ @param ThreadsPerCore Number of threads per core.\r
+\r
+ @param CoresPerProcessor Total number of cores on this\r
+ physical processor package.\r
+\r
+ @param PhysicalProcessorPackageId Physical processor package\r
+ identifier which was\r
+ assigned at reset by the\r
+ platform or bus\r
+ controller. This value may\r
+ or may not be unique\r
+ across the entire platform\r
+ since it depends on the\r
+ platform vendor's policy.\r
+**/\r
+typedef struct {\r
+ UINT64 NumberOfLogicalProcessors:16;\r
+ UINT64 ThreadsPerCore:8;\r
+ UINT64 Reserved1:8;\r
+ UINT64 CoresPerProcessor;\r
+ UINT64 Reserved2:8;\r
+ UINT64 PhysicalProcessorPackageId:8;\r
+ UINT64 Reserved3:8;\r
+} PAL_LOGICAL_PROCESSPR_OVERVIEW;\r
+\r
+/**\r
+\r
+ @param ThreadId The thread identifier of the logical\r
+ processor for which information is being\r
+ returned. This value will be unique on a per\r
+ core basis.\r
+\r
+ @param CoreId The core identifier of the logical processor\r
+ for which information is being returned.\r
+ This value will be unique on a per physical\r
+ processor package basis.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 ThreadId:16;\r
+ UINT64 Reserved1:16;\r
+ UINT64 CoreId:16;\r
+ UINT64 Reserved2:16;\r
+} PAL_LOGICAL_PROCESSORN_INFO1;\r
+\r
+\r
+/**\r
+\r
+ @param LogicalAddress Geographical address of the logical\r
+ processor for which information is being\r
+ returned. This is the same value that is\r
+ returned by the PAL_FIXED_ADDR procedure\r
+ when it is called on the logical\r
+ processor.\r
+\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 LogicalAddress:16;\r
+ UINT64 Reserved:48;\r
+} PAL_LOGICAL_PROCESSORN_INFO2;\r
+\r
+/**\r
+ PAL Procedure - PAL_LOGICAL_TO_PHYSICAL.\r
+\r
+ Return information on which logical processors map to a\r
+ physical processor die. It is optinal. The PAL procedure\r
+ supports the Static Registers calling convention. It could be\r
+ called at physical mode and virtual mode.\r
+\r
+ @param Index Index of PAL_LOGICAL_TO_PHYSICAL within the list of PAL\r
+ procedures.\r
+ @param ProcessorNumber Signed 64-bit integer that specifies\r
+ for which logical processor\r
+ information is being requested. When\r
+ this input argument is -1, information\r
+ is returned about the logical\r
+ processor on which the procedure call\r
+ is made. This input argument must be\r
+ in the range of 1 up to one less than\r
+ the number of logical processors\r
+ returned by num_log in the\r
+ log_overview return value.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 The format of PAL_LOGICAL_PROCESSPR_OVERVIEW.\r
+ @return R10 The format of PAL_LOGICAL_PROCESSORN_INFO1.\r
+ @return R11 The format of PAL_LOGICAL_PROCESSORN_INFO2.\r
+\r
+**/\r
+#define PAL_LOGICAL_TO_PHYSICAL 42\r
+\r
+\r
+/**\r
+\r
+ @param NumberOfPmcPairs Unsigned 8-bit number defining the\r
+ number of generic PMC/PMD pairs.\r
+\r
+ @param WidthOfCounter Unsigned 8-bit number in the range\r
+ 0:60 defining the number of\r
+ implemented counter bits.\r
+\r
+ @param TypeOfCycleCounting Unsigned 8-bit number defining the\r
+ event type for counting processor\r
+ cycles.\r
+\r
+\r
+ @param TypeOfRetiredInstructionBundle Retired Unsigned 8-bit\r
+ number defining the\r
+ event type for retired\r
+ instruction bundles.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 NumberOfPmcPairs:8;\r
+ UINT64 WidthOfCounter:8;\r
+ UINT64 TypeOfCycleCounting:8;\r
+ UINT64 TypeOfRetiredInstructionBundle:8;\r
+ UINT64 Reserved:32;\r
+} PAL_PERFORMANCE_INFO;\r
+\r
+/**\r
+ PAL Procedure - PAL_PERF_MON_INFO.\r
+\r
+ Return the number and type of performance monitors. It is\r
+ required by IPF. The PAL procedure supports the Static\r
+ Registers calling convention. It could be called at physical\r
+ mode and virtual mode.\r
+\r
+ @param Index Index of PAL_PERF_MON_INFO within the list of\r
+ PAL procedures.\r
+ @param PerformanceBuffer An address to an 8-byte aligned\r
+ 128-byte memory buffer.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Information about the performance monitors\r
+ implemented. See PAL_PERFORMANCE_INFO;\r
+\r
+**/\r
+#define PAL_PERF_MON_INFO 15\r
+\r
+#define PAL_PLATFORM_ADDR_INTERRUPT_BLOCK_TOKEN 0x0\r
+#define PAL_PLATFORM_ADDR_IO_BLOCK_TOKEN 0x1\r
+\r
+/**\r
+ PAL Procedure - PAL_PLATFORM_ADDR.\r
+\r
+ Specify processor interrupt block address and I/O port space\r
+ address. It is required by IPF. The PAL procedure supports the\r
+ Static Registers calling convention. It could be called at\r
+ physical mode and virtual mode.\r
+\r
+ @param Index Index of PAL_PLATFORM_ADDR within the list of\r
+ PAL procedures.\r
+ @param Type Unsigned 64-bit integer specifying the type of\r
+ block. 0 indicates that the processor interrupt\r
+ block pointer should be initialized. 1 indicates\r
+ that the processor I/O block pointer should be\r
+ initialized.\r
+ @param Address Unsigned 64-bit integer specifying the address\r
+ to which the processor I/O block or interrupt\r
+ block shall be set. The address must specify\r
+ an implemented physical address on the\r
+ processor model, bit 63 is ignored.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure.\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+**/\r
+#define PAL_PLATFORM_ADDR 16\r
+\r
+\r
+/**\r
+\r
+ @param EnableBerrPromotion Bit63. Enable BERR promotion. When\r
+ 1, the Bus Error (BERR) signal is\r
+ promoted to the Bus Initialization\r
+ (BINIT) signal, and the BINIT pin\r
+ is asserted on the occurrence of\r
+ each Bus Error. Setting this bit\r
+ has no effect if BINIT signalling\r
+ is disabled. (See\r
+ PAL_BUS_GET/SET_FEATURES)\r
+\r
+ @param EnableMcaPromotion Bit62, Enable MCA promotion. When\r
+ 1, machine check aborts (MCAs) are\r
+ promoted to the Bus Error signal,\r
+ and the BERR pin is assert on each\r
+ occurrence of an MCA. Setting this\r
+ bit has no effect if BERR\r
+ signalling is disabled. (See\r
+ PAL_BUS_GET/SET_FEATURES)\r
+\r
+ @param EnableMcaToBinitPromotion Bit61, Enable MCA to BINIT\r
+ promotion. When 1, machine\r
+ check aborts (MCAs) are\r
+ promoted to the Bus\r
+ Initialization signal, and\r
+ the BINIT pin is assert on\r
+ each occurrence of an MCA.\r
+ Setting this bit has no\r
+ effect if BINIT signalling\r
+ is disabled. (See\r
+ PAL_BUS_GET/SET_FEATURES)\r
+\r
+ @param EnableCmciPromotion Bit60, Enable CMCI promotion When\r
+ 1, Corrected Machine Check\r
+ Interrupts (CMCI) are promoted to\r
+ MCAs. They are also further\r
+ promoted to BERR if bit 39, Enable\r
+ MCA promotion, is also set and\r
+ they are promoted to BINIT if bit\r
+ 38, Enable MCA to BINIT promotion,\r
+ is also set. This bit has no\r
+ effect if MCA signalling is\r
+ disabled (see\r
+ PAL_BUS_GET/SET_FEATURES)\r
+\r
+ @param DisableCache Bit59, Disable Cache. When 0, the\r
+ processor performs cast outs on\r
+ cacheable pages and issues and responds\r
+ to coherency requests normally. When 1,\r
+ the processor performs a memory access\r
+ for each reference regardless of cache\r
+ contents and issues no coherence\r
+ requests and responds as if the line\r
+ were not present. Cache contents cannot\r
+ be relied upon when the cache is\r
+ disabled. WARNING: Semaphore\r
+ instructions may not be atomic or may\r
+ cause Unsupported Data Reference faults\r
+ if caches are disabled.\r
+\r
+ @param DisableCoherency Bit58, Disable Coherency. When 0,\r
+ the processor uses normal coherency\r
+ requests and responses. When 1, the\r
+ processor answers all requests as if\r
+ the line were not present.\r
+\r
+ @param DisableDPM Bit57, Disable Dynamic Power Management\r
+ (DPM). When 0, the hardware may reduce\r
+ power consumption by removing the clock\r
+ input from idle functional units. When 1,\r
+ all functional units will receive clock\r
+ input, even when idle.\r
+\r
+ @param DisableBinitWithTimeout Bit56, Disable a BINIT on\r
+ internal processor time-out.\r
+ When 0, the processor may\r
+ generate a BINIT on an\r
+ internal processor time-out.\r
+ When 1, the processor will not\r
+ generate a BINIT on an\r
+ internal processor time-out.\r
+ The event is silently ignored.\r
+\r
+\r
+ @param EnableEnvNotification Bit55, Enable external\r
+ notification when the processor\r
+ detects hardware errors caused\r
+ by environmental factors that\r
+ could cause loss of\r
+ deterministic behavior of the\r
+ processor. When 1, this bit will\r
+ enable external notification,\r
+ when 0 external notification is\r
+ not provided. The type of\r
+ external notification of these\r
+ errors is processor-dependent. A\r
+ loss of processor deterministic\r
+ behavior is considered to have\r
+ occurred if these\r
+ environmentally induced errors\r
+ cause the processor to deviate\r
+ from its normal execution and\r
+ eventually causes different\r
+ behavior which can be observed\r
+ at the processor bus pins.\r
+ Processor errors that do not\r
+ have this effects (i.e.,\r
+ software induced machine checks)\r
+ may or may not be promoted\r
+ depending on the processor\r
+ implementation.\r
+\r
+ @param EnableVmsw Bit54, Enable the use of the vmsw\r
+ instruction. When 0, the vmsw instruction\r
+ causes a Virtualization fault when\r
+ executed at the most privileged level.\r
+ When 1, this bit will enable normal\r
+ operation of the vmsw instruction.\r
+\r
+ @param EnableMcaOnDataPoisoning Bit53, Enable MCA signaling\r
+ on data-poisoning event\r
+ detection. When 0, a CMCI\r
+ will be signaled on error\r
+ detection. When 1, an MCA\r
+ will be signaled on error\r
+ detection. If this feature\r
+ is not supported, then the\r
+ corresponding argument is\r
+ ignored when calling\r
+ PAL_PROC_SET_FEATURES. Note\r
+ that the functionality of\r
+ this bit is independent of\r
+ the setting in bit 60\r
+ (Enable CMCI promotion), and\r
+ that the bit 60 setting does\r
+ not affect CMCI signaling\r
+ for data-poisoning related\r
+ events. Volume 2: Processor\r
+ Abstraction Layer 2:431\r
+ PAL_PROC_GET_FEATURES\r
+\r
+ @param DisablePState Bit52, Disable P-states. When 1, the PAL\r
+ P-state procedures (PAL_PSTATE_INFO,\r
+ PAL_SET_PSTATE, PAL_GET_PSTATE) will\r
+ return with a status of -1\r
+ (Unimplemented procedure).\r
+\r
+ @param DisableBranchPrediction Bit47, Disable Dynamic branch\r
+ prediction. When 0, the\r
+ processor may predict branch\r
+ targets and speculatively\r
+ execute, but may not commit\r
+ results. When 1, the processor\r
+ must wait until branch targets\r
+ are known to execute.\r
+\r
+ @param DisableDynamicInsCachePrefetch Bit46, Disable\r
+ DynamicInstruction Cache\r
+ Prefetch. When 0, the\r
+ processor may prefetch\r
+ into the caches any\r
+ instruction which has\r
+ not been executed, but\r
+ whose execution is\r
+ likely. When 1,\r
+ instructions may not be\r
+ fetched until needed or\r
+ hinted for execution.\r
+ (Prefetch for a hinted\r
+ branch is allowed even\r
+ when dynamic instruction\r
+ cache prefetch is\r
+ disabled.)\r
+\r
+ @param DisableDynamicDataCachePrefetch Bit45, Disable Dynamic\r
+ Data Cache Prefetch.\r
+ When 0, the processor\r
+ may prefetch into the\r
+ caches any data which\r
+ has not been accessed\r
+ by instruction\r
+ execution, but which\r
+ is likely to be\r
+ accessed. When 1, no\r
+ data may be fetched\r
+ until it is needed for\r
+ instruction execution\r
+ or is fetched by an\r
+ lfetch instruction.\r
+\r
+ @param DisableSpontaneousDeferral Bit44, Disable Spontaneous\r
+ Deferral. When 1, the\r
+ processor may optionally\r
+ defer speculative loads\r
+ that do not encounter any\r
+ exception conditions, but\r
+ that trigger other\r
+ implementation-dependent\r
+ conditions (e.g., cache\r
+ miss). When 0, spontaneous\r
+ deferral is disabled.\r
+\r
+ @param DisableDynamicPrediction Bit43, Disable Dynamic\r
+ Predicate Prediction. When\r
+ 0, the processor may predict\r
+ predicate results and\r
+ execute speculatively, but\r
+ may not commit results until\r
+ the actual predicates are\r
+ known. When 1, the processor\r
+ shall not execute predicated\r
+ instructions until the\r
+ actual predicates are known.\r
+\r
+ @param NoXr1ThroughXr3 Bit42, No XR1 through XR3 implemented.\r
+ Denotes whether XR1 XR3 are\r
+ implemented for machine check\r
+ recovery. This feature may only be\r
+ interrogated by PAL_PROC_GET_FEATURES.\r
+ It may not be enabled or disabled by\r
+ PAL_PROC_SET_FEATURES. The\r
+ corresponding argument is ignored.\r
+\r
+ @param NoXipXpsrXfs Bit41, No XIP, XPSR, and XFS\r
+ implemented. Denotes whether XIP, XPSR,\r
+ and XFS are implemented for machine\r
+ check recovery. This feature may only be\r
+ interrogated by PAL_PROC_GET_FEATURES.\r
+ It may not be enabled or disabled by\r
+ PAL_PROC_SET_FEATURES. The corresponding\r
+ argument is ignored.\r
+\r
+ @param NoVM Bit40, No Virtual Machine features implemented.\r
+ Denotes whether PSR.vm is implemented. This\r
+ feature may only be interrogated by\r
+ PAL_PROC_GET_FEATURES. It may not be enabled or\r
+ disabled by PAL_PROC_SET_FEATURES. The\r
+ corresponding argument is ignored.\r
+\r
+ @param NoVariablePState Bit39, No Variable P-state\r
+ performance: A value of 1, indicates\r
+ that a processor implements\r
+ techniques to optimize performance\r
+ for the given P-state power budget\r
+ by dynamically varying the\r
+ frequency, such that maximum\r
+ performance is achieved for the\r
+ power budget. A value of 0,\r
+ indicates that P-states have no\r
+ frequency variation or very small\r
+ frequency variations for their given\r
+ power budget. This feature may only\r
+ be interrogated by\r
+ PAL_PROC_GET_FEATURES. it may not be\r
+ enabled or disabled by\r
+ PAL_PROC_SET_FEATURES. The\r
+ corresponding argument is ignored.\r
+\r
+\r
+ @param NoSimpleImpInUndefinedIns Bit38, No Simple\r
+ implementation of\r
+ unimplemented instruction\r
+ addresses. Denotes how an\r
+ unimplemented instruction\r
+ address is recorded in IIP\r
+ on an Unimplemented\r
+ Instruction Address trap or\r
+ fault. When 1, the full\r
+ unimplemented address is\r
+ recorded in IIP; when 0, the\r
+ address is sign extended\r
+ (virtual addresses) or zero\r
+ extended (physical\r
+ addresses). This feature may\r
+ only be interrogated by\r
+ PAL_PROC_GET_FEATURES. It\r
+ may not be enabled or\r
+ disabled by\r
+ PAL_PROC_SET_FEATURES. The\r
+ corresponding argument is\r
+ ignored.\r
+\r
+ @param NoPresentPmi Bit37, No INIT, PMI, and LINT pins\r
+ present. Denotes the absence of INIT,\r
+ PMI, LINT0 and LINT1 pins on the\r
+ processor. When 1, the pins are absent.\r
+ When 0, the pins are present. This\r
+ feature may only be interrogated by\r
+ PAL_PROC_GET_FEATURES. It may not be\r
+ enabled or disabled by\r
+ PAL_PROC_SET_FEATURES. The corresponding\r
+ argument is ignored.\r
+\r
+ @param FaultInUndefinedIns Bit36, No Unimplemented\r
+ instruction address reported as\r
+ fault. Denotes how the processor\r
+ reports the detection of\r
+ unimplemented instruction\r
+ addresses. When 1, the processor\r
+ reports an Unimplemented\r
+ Instruction Address fault on the\r
+ unimplemented address; when 0, it\r
+ reports an Unimplemented\r
+ Instruction Address trap on the\r
+ previous instruction in program\r
+ order. This feature may only be\r
+ interrogated by\r
+ PAL_PROC_GET_FEATURES. It may not\r
+ be enabled or disabled by\r
+ PAL_PROC_SET_FEATURES. The\r
+ corresponding argument is\r
+ ignored.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 Reserved1:36;\r
+ UINT64 FaultInUndefinedIns:1;\r
+ UINT64 NoPresentPmi:1;\r
+ UINT64 NoSimpleImpInUndefinedIns:1;\r
+ UINT64 NoVariablePState:1;\r
+ UINT64 NoVM:1;\r
+ UINT64 NoXipXpsrXfs:1;\r
+ UINT64 NoXr1ThroughXr3:1;\r
+ UINT64 DisableDynamicPrediction:1;\r
+ UINT64 DisableSpontaneousDeferral:1;\r
+ UINT64 DisableDynamicDataCachePrefetch:1;\r
+ UINT64 DisableDynamicInsCachePrefetch:1;\r
+ UINT64 DisableBranchPrediction:1;\r
+ UINT64 Reserved2:4;\r
+ UINT64 DisablePState:1;\r
+ UINT64 EnableMcaOnDataPoisoning:1;\r
+ UINT64 EnableVmsw:1;\r
+ UINT64 EnableEnvNotification:1;\r
+ UINT64 DisableBinitWithTimeout:1;\r
+ UINT64 DisableDPM:1;\r
+ UINT64 DisableCoherency:1;\r
+ UINT64 DisableCache:1;\r
+ UINT64 EnableCmciPromotion:1;\r
+ UINT64 EnableMcaToBinitPromotion:1;\r
+ UINT64 EnableMcaPromotion:1;\r
+ UINT64 EnableBerrPromotion:1;\r
+} PAL_PROCESSOR_FEATURES;\r
+\r
+/**\r
+ PAL Procedure - PAL_PROC_GET_FEATURES.\r
+\r
+ Return configurable processor features and their current\r
+ setting. It is required by IPF. The PAL procedure supports the\r
+ Static Registers calling convention. It could be called at\r
+ physical mode and virtual mode.\r
+\r
+ @param Index Index of PAL_PROC_GET_FEATURES within the list of\r
+ PAL procedures.\r
+ @param Reserved Reserved parameter.\r
+ @param FeatureSet Feature set information is being requested\r
+ for.\r
+\r
+ @retval 1 Call completed without error; The\r
+ feature_set passed is not supported but a\r
+ feature_set of a larger value is supported.\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -8 feature_set passed is beyond the maximum\r
+ feature_set supported\r
+\r
+ @return R9 64-bit vector of features implemented. See\r
+ PAL_PROCESSOR_FEATURES.\r
+ @return R10 64-bit vector of current feature settings. See\r
+ PAL_PROCESSOR_FEATURES.\r
+ @return R11 64-bit vector of features controllable by\r
+ software.\r
+\r
+**/\r
+#define PAL_PROC_GET_FEATURES 17\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_PROC_SET_FEATURES.\r
+\r
+ Enable or disable configurable processor features. It is\r
+ required by IPF. The PAL procedure supports the Static\r
+ Registers calling convention. It could be called at physical\r
+ mode.\r
+\r
+ @param Index Index of PAL_PROC_SET_FEATURES within the list of\r
+ PAL procedures.\r
+ @param FeatureSelect 64-bit vector denoting desired state of\r
+ each feature (1=select, 0=non-select).\r
+ @param FeatureSet Feature set to apply changes to. See\r
+ PAL_PROC_GET_FEATURES for more information\r
+ on feature sets.\r
+\r
+ @retval 1 Call completed without error; The\r
+ feature_set passed is not supported but a\r
+ feature_set of a larger value is supported\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -8 feature_set passed is beyond the maximum\r
+ feature_set supported\r
+\r
+**/\r
+#define PAL_PROC_SET_FEATURES 18\r
+\r
+\r
+//\r
+// Value of PAL_REGISTER_INFO.InfoRequest.\r
+//\r
+#define PAL_APPLICATION_REGISTER_IMPLEMENTED 0\r
+#define PAL_APPLICATION_REGISTER_READABLE 1\r
+#define PAL_CONTROL_REGISTER_IMPLEMENTED 2\r
+#define PAL_CONTROL_REGISTER_READABLE 3\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_REGISTER_INFO.\r
+\r
+ Return AR and CR register information. It is required by IPF.\r
+ The PAL procedure supports the Static Registers calling\r
+ convention. It could be called at physical mode and virtual\r
+ mode.\r
+\r
+ @param Index Index of PAL_REGISTER_INFO within the list of\r
+ PAL procedures.\r
+ @param InfoRequest Unsigned 64-bit integer denoting what\r
+ register information is requested. See\r
+ PAL_REGISTER_INFO.InfoRequest above.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 64-bit vector denoting information for registers\r
+ 0-63. Bit 0 is register 0, bit 63 is register 63.\r
+ @return R10 64-bit vector denoting information for registers\r
+ 64-127. Bit 0 is register 64, bit 63 is register\r
+ 127.\r
+\r
+**/\r
+#define PAL_REGISTER_INFO 39\r
+\r
+/**\r
+ PAL Procedure - PAL_RSE_INFO.\r
+\r
+ Return RSE information. It is required by IPF. The PAL\r
+ procedure supports the Static Registers calling convention. It\r
+ could be called at physical mode and virtual mode.\r
+\r
+ @param Index Index of PAL_RSE_INFO within the list of\r
+ PAL procedures.\r
+ @param InfoRequest Unsigned 64-bit integer denoting what\r
+ register information is requested. See\r
+ PAL_REGISTER_INFO.InfoRequest above.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Number of physical stacked general registers.\r
+ @return R10 RSE hints supported by processor.\r
+\r
+**/\r
+#define PAL_RSE_INFO 19\r
+\r
+/**\r
+\r
+ @param VersionOfPalB Is a 16-bit binary coded decimal (BCD)\r
+ number that provides identification\r
+ information about the PAL_B firmware.\r
+\r
+ @param PalVendor Is an unsigned 8-bit integer indicating the\r
+ vendor of the PAL code.\r
+\r
+ @param VersionOfPalB Is a 16-bit binary coded decimal (BCD)\r
+ number that provides identification\r
+ information about the PAL_A firmware. In\r
+ the split PAL_A model, this return value\r
+ is the version number of the\r
+ processor-specific PAL_A. The generic\r
+ PAL_A version is not returned by this\r
+ procedure in the split PAL_A model.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 VersionOfPalB:16;\r
+ UINT64 Reserved1:8;\r
+ UINT64 PalVendor:8;\r
+ UINT64 VersionOfPalA:16;\r
+ UINT64 Reserved2:16;\r
+} PAL_VERSION_INFO;\r
+\r
+/**\r
+ PAL Procedure - PAL_VERSION.\r
+\r
+ Return version of PAL code. It is required by IPF. The PAL\r
+ procedure supports the Static Registers calling convention. It\r
+ could be called at physical mode and virtual mode.\r
+\r
+ @param Index Index of PAL_VERSION within the list of\r
+ PAL procedures.\r
+ @param InfoRequest Unsigned 64-bit integer denoting what\r
+ register information is requested. See\r
+ PAL_REGISTER_INFO.InfoRequest above.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 8-byte formatted value returning the minimum PAL\r
+ version needed for proper operation of the\r
+ processor. See PAL_VERSION_INFO above.\r
+ @return R10 8-byte formatted value returning the current PAL\r
+ version running on the processor. See\r
+ PAL_VERSION_INFO above.\r
+\r
+**/\r
+#define PAL_VERSION 20\r
+\r
+\r
+\r
+//\r
+// Vectors of PAL_MC_CLEAR_LOG.pending\r
+//\r
+#define PAL_MC_PENDING BIT0\r
+#define PAL_INIT_PENDING BIT1\r
+\r
+/**\r
+ PAL Procedure - PAL_MC_CLEAR_LOG.\r
+\r
+ Clear all error information from processor error logging\r
+ registers. It is required by IPF. The PAL procedure supports\r
+ the Static Registers calling convention. It could be called at\r
+ physical mode and virtual mode.\r
+\r
+ @param Index Index of PAL_MC_CLEAR_LOG within the list of\r
+ PAL procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 64-bit vector denoting whether an event is\r
+ pending. See PAL_MC_CLEAR_LOG.pending above.\r
+\r
+**/\r
+#define PAL_MC_CLEAR_LOG 21\r
+\r
+/**\r
+ PAL Procedure - PAL_MC_DRAIN.\r
+\r
+ Ensure that all operations that could cause an MCA have\r
+ completed. It is required by IPF. The PAL procedure supports\r
+ the Static Registers calling convention. It could be called at\r
+ physical mode and virtual mode.\r
+\r
+ @param Index Index of PAL_MC_DRAIN within the list of PAL\r
+ procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+**/\r
+#define PAL_MC_DRAIN 22\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_MC_DYNAMIC_STATE.\r
+\r
+ Return Processor Dynamic State for logging by SAL. It is\r
+ optional. The PAL procedure supports the Static Registers\r
+ calling convention. It could be called at physical mode.\r
+\r
+ @param Index Index of PAL_MC_DYNAMIC_STATE within the list of PAL\r
+ procedures.\r
+ @param Offset Offset of the next 8 bytes of Dynamic Processor\r
+ State to return. (multiple of 8).\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure.\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Unsigned 64-bit integer denoting bytes of Dynamic\r
+ Processor State returned.\r
+ @return R10 Next 8 bytes of Dynamic Processor State.\r
+\r
+**/\r
+#define PAL_MC_DYNAMIC_STATE 24\r
+\r
+\r
+\r
+//\r
+// Values of PAL_MC_ERROR_INFO.InfoIndex.\r
+//\r
+#define PAL_PROCESSOR_ERROR_MAP 0\r
+#define PAL_PROCESSOR_STATE_PARAM 1\r
+#define PAL_STRUCTURE_SPECIFIC_ERROR 2\r
+\r
+/**\r
+\r
+ @param CoreId Bit3:0, Processor core ID (default is 0 for\r
+ processors with a single core)\r
+\r
+ @param ThreadId Bit7:4, Logical thread ID (default is 0 for\r
+ processors that execute a single thread)\r
+\r
+ @param InfoOfInsCache Bit11:8, Error information is\r
+ available for 1st, 2nd, 3rd, and 4th\r
+ level instruction caches.\r
+\r
+ @param InfoOfDataCache Bit15:12, Error information is\r
+ available for 1st, 2nd, 3rd, and 4th\r
+ level data/unified caches.\r
+\r
+ @param InfoOfInsTlb Bit19:16 Error information is available\r
+ for 1st, 2nd, 3rd, and 4th level\r
+ instruction TLB.\r
+\r
+ @param InfoOfDataTlb Bit23:20, Error information is available\r
+ for 1st, 2nd, 3rd, and 4th level\r
+ data/unified TLB\r
+\r
+ @param InfoOfProcessorBus Bit27:24 Error information is\r
+ available for the 1st, 2nd, 3rd,\r
+ and 4th level processor bus\r
+ hierarchy.\r
+\r
+ @param InfoOfRegisterFile Bit31:28 Error information is\r
+ available on register file\r
+ structures.\r
+\r
+ @param InfoOfMicroArch Bit47:32, Error information is\r
+ available on micro-architectural\r
+ structures.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 CoreId:4;\r
+ UINT64 ThreadId:4;\r
+ UINT64 InfoOfInsCache:4;\r
+ UINT64 InfoOfDataCache:4;\r
+ UINT64 InfoOfInsTlb:4;\r
+ UINT64 InfoOfDataTlb:4;\r
+ UINT64 InfoOfProcessorBus:4;\r
+ UINT64 InfoOfRegisterFile:4;\r
+ UINT64 InfoOfMicroArch:4;\r
+ UINT64 Reserved:16;\r
+} PAL_MC_ERROR_INFO_LEVEL_INDEX;\r
+\r
+//\r
+// Value of PAL_MC_ERROR_INFO.ErrorTypeIndex\r
+//\r
+#define PAL_ERR_INFO_BY_LEVEL_INDEX 0\r
+#define PAL_ERR_INFO_TARGET_ADDRESS 1\r
+#define PAL_ERR_INFO_REQUESTER_IDENTIFIER 2\r
+#define PAL_ERR_INFO_REPONSER_INDENTIFIER 3\r
+#define PAL_ERR_INFO_PRECISE_INSTRUCTION_POINTER 4\r
+\r
+/**\r
+\r
+ @param Operation Bit3:0, Type of cache operation that caused\r
+ the machine check: 0 - unknown or internal\r
+ error 1 - load 2 - store 3 - instruction\r
+ fetch or instruction prefetch 4 - data\r
+ prefetch (both hardware and software) 5 -\r
+ snoop (coherency check) 6 - cast out\r
+ (explicit or implicit write-back of a cache\r
+ line) 7 - move in (cache line fill)\r
+\r
+ @param FailedCacheLevel Bit5:4 Level of cache where the\r
+ error occurred. A value of 0\r
+ indicates the first level of cache.\r
+\r
+ @param FailedInDataPart Bit8, Failure located in the data\r
+ part of the cache line.\r
+\r
+ @param FailedInTagPart Bit9, Failure located in the tag part\r
+ of the cache line.\r
+\r
+ @param FailedInDataCache Bit10, Failure located in the data\r
+ cache\r
+\r
+ @param FailedInInsCache Bit11, Failure located in the\r
+ instruction cache.\r
+\r
+\r
+ @param Mesi Bit14:12, 0 - cache line is invalid. 1 - cache\r
+ line is held shared. 2 - cache line is held\r
+ exclusive. 3 - cache line is modified. All other\r
+ values are reserved.\r
+\r
+ @param MesiIsValid Bit15, The mesi field in the cache_check\r
+ parameter is valid.\r
+\r
+ @param FailedWay Bit20:16, Failure located in the way of\r
+ the cache indicated by this value.\r
+\r
+ @param WayIndexIsValid Bit21, The way and index field in the\r
+ cache_check parameter is valid.\r
+\r
+ @param MultipleBitsError Bit23, A multiple-bit error was\r
+ detected, and data was poisoned for\r
+ the corresponding cache line during\r
+ castout.\r
+\r
+ @param IndexOfCacheLineError Bit51:32, Index of the cache\r
+ line where the error occurred.\r
+\r
+ @param InstructionSet Bit54, Instruction set. If this value\r
+ is set to zero, the instruction that\r
+ generated the machine check was an\r
+ Intel Itanium instruction. If this bit\r
+ is set to one, the instruction that\r
+ generated the machine check was IA-32\r
+ instruction.\r
+\r
+ @param InstructionSetIsValid Bit55, The is field in the\r
+ cache_check parameter is valid.\r
+\r
+ @param PrivilegeLevel Bit57:56, Privilege level. The\r
+ privilege level of the instruction\r
+ bundle responsible for generating the\r
+ machine check.\r
+\r
+ @param PrivilegeLevelIsValide Bit58, The pl field of the\r
+ cache_check parameter is\r
+ valid.\r
+\r
+ @param McCorrected Bit59, Machine check corrected: This bit\r
+ is set to one to indicate that the machine\r
+ check has been corrected.\r
+\r
+ @param TargetAddressIsValid Bit60, Target address is valid:\r
+ This bit is set to one to\r
+ indicate that a valid target\r
+ address has been logged.\r
+\r
+ @param RequesterIdentifier Bit61, Requester identifier: This\r
+ bit is set to one to indicate that\r
+ a valid requester identifier has\r
+ been logged.\r
+\r
+ @param ResponserIdentifier Bit62, Responder identifier: This\r
+ bit is set to one to indicate that\r
+ a valid responder identifier has\r
+ been logged.\r
+\r
+ @param PreciseInsPointer Bit63, Precise instruction pointer.\r
+ This bit is set to one to indicate\r
+ that a valid precise instruction\r
+ pointer has been logged.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 Operation:4;\r
+ UINT64 FailedCacheLevel:2;\r
+ UINT64 Reserved1:2;\r
+ UINT64 FailedInDataPart:1;\r
+ UINT64 FailedInTagPart:1;\r
+ UINT64 FailedInDataCache:1;\r
+ UINT64 FailedInInsCache:1;\r
+ UINT64 Mesi:3;\r
+ UINT64 MesiIsValid:1;\r
+ UINT64 FailedWay:5;\r
+ UINT64 WayIndexIsValid:1;\r
+\r
+ UINT64 Reserved2:1;\r
+ UINT64 MultipleBitsError:1;\r
+ UINT64 Reserved3:8;\r
+ UINT64 IndexOfCacheLineError:20;\r
+ UINT64 Reserved4:2;\r
+ UINT64 InstructionSet:1;\r
+ UINT64 InstructionSetIsValid:1;\r
+\r
+ UINT64 PrivilegeLevel:2;\r
+ UINT64 PrivilegeLevelIsValide:1;\r
+\r
+ UINT64 McCorrected:1;\r
+\r
+ UINT64 TargetAddressIsValid:1;\r
+ UINT64 RequesterIdentifier:1;\r
+ UINT64 ResponserIdentifier:1;\r
+ UINT64 PreciseInsPointer:1;\r
+\r
+} PAL_CACHE_CHECK_INFO;\r
+\r
+/**\r
+\r
+ @param FailedSlot Bit7:0, Slot number of the translation\r
+ register where the failure occurred.\r
+\r
+ @param FailedSlotIsValid Bit8, The tr_slot field in the\r
+ TLB_check parameter is valid.\r
+\r
+ @param TlbLevel Bit11:10, The level of the TLB where the\r
+ error occurred. A value of 0 indicates the\r
+ first level of TLB\r
+\r
+ @param FailedInDataTr Bit16, Error occurred in the data\r
+ translation registers.\r
+\r
+ @param FailedInInsTr Bit17, Error occurred in the instruction\r
+ translation registers\r
+\r
+ @param FailedInDataTc Bit18, Error occurred in data\r
+ translation cache.\r
+\r
+ @param FailedInInsTc Bit19, Error occurred in the instruction\r
+ translation cache.\r
+\r
+ @param FailedOperation Bit23:20, Type of cache operation that\r
+ caused the machine check: 0 - unknown\r
+ 1 - TLB access due to load instruction\r
+ 2 - TLB access due to store\r
+ instruction 3 - TLB access due to\r
+ instruction fetch or instruction\r
+ prefetch 4 - TLB access due to data\r
+ prefetch (both hardware and software)\r
+ 5 - TLB shoot down access 6 - TLB\r
+ probe instruction (probe, tpa) 7 -\r
+ move in (VHPT fill) 8 - purge (insert\r
+ operation that purges entries or a TLB\r
+ purge instruction) All other values\r
+ are reserved.\r
+\r
+ @param InstructionSet Bit54, Instruction set. If this value\r
+ is set to zero, the instruction that\r
+ generated the machine check was an\r
+ Intel Itanium instruction. If this bit\r
+ is set to one, the instruction that\r
+ generated the machine check was IA-32\r
+ instruction.\r
+\r
+ @param InstructionSetIsValid Bit55, The is field in the\r
+ TLB_check parameter is valid.\r
+\r
+ @param PrivelegeLevel Bit57:56, Privilege level. The\r
+ privilege level of the instruction\r
+ bundle responsible for generating the\r
+ machine check.\r
+\r
+ @param PrivelegeLevelIsValid Bit58, The pl field of the\r
+ TLB_check parameter is valid.\r
+\r
+ @param McCorrected Bit59, Machine check corrected: This bit\r
+ is set to one to indicate that the machine\r
+ check has been corrected.\r
+\r
+ @param TargetAddressIsValid Bit60, Target address is valid:\r
+ This bit is set to one to\r
+ indicate that a valid target\r
+ address has been logged.\r
+\r
+ @param RequesterIdentifier Bit61 Requester identifier: This\r
+ bit is set to one to indicate that\r
+ a valid requester identifier has\r
+ been logged.\r
+\r
+ @param ResponserIdentifier Bit62, Responder identifier: This\r
+ bit is set to one to indicate that\r
+ a valid responder identifier has\r
+ been logged.\r
+\r
+ @param PreciseInsPointer Bit63 Precise instruction pointer.\r
+ This bit is set to one to indicate\r
+ that a valid precise instruction\r
+ pointer has been logged.\r
+**/\r
+typedef struct {\r
+ UINT64 FailedSlot:8;\r
+ UINT64 FailedSlotIsValid:1;\r
+ UINT64 Reserved1 :1;\r
+ UINT64 TlbLevel:2;\r
+ UINT64 Reserved2 :4;\r
+ UINT64 FailedInDataTr:1;\r
+ UINT64 FailedInInsTr:1;\r
+ UINT64 FailedInDataTc:1;\r
+ UINT64 FailedInInsTc:1;\r
+ UINT64 FailedOperation:4;\r
+ UINT64 Reserved3:30;\r
+ UINT64 InstructionSet:1;\r
+ UINT64 InstructionSetIsValid:1;\r
+ UINT64 PrivelegeLevel:2;\r
+ UINT64 PrivelegeLevelIsValid:1;\r
+ UINT64 McCorrected:1;\r
+ UINT64 TargetAddressIsValid:1;\r
+ UINT64 RequesterIdentifier:1;\r
+ UINT64 ResponserIdentifier:1;\r
+ UINT64 PreciseInsPointer:1;\r
+} PAL_TLB_CHECK_INFO;\r
+\r
+/**\r
+ PAL Procedure - PAL_MC_ERROR_INFO.\r
+\r
+ Return Processor Machine Check Information and Processor\r
+ Static State for logging by SAL. It is required by IPF. The\r
+ PAL procedure supports the Static Registers calling\r
+ convention. It could be called at physical and virtual mode.\r
+\r
+ @param Index Index of PAL_MC_ERROR_INFO within the list of PAL\r
+ procedures.\r
+ @param InfoIndex Unsigned 64-bit integer identifying the\r
+ error information that is being requested.\r
+ See PAL_MC_ERROR_INFO.InfoIndex.\r
+ @param LevelIndex 8-byte formatted value identifying the\r
+ structure to return error information\r
+ on. See PAL_MC_ERROR_INFO_LEVEL_INDEX.\r
+ @param ErrorTypeIndex Unsigned 64-bit integer denoting the\r
+ type of error information that is\r
+ being requested for the structure\r
+ identified in LevelIndex.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -6 Argument was valid, but no error\r
+ information was available\r
+\r
+ @return R9 Error information returned. The format of this\r
+ value is dependant on the input values passed.\r
+ @return R10 If this value is zero, all the error information\r
+ specified by err_type_index has been returned. If\r
+ this value is one, more structure-specific error\r
+ information is available and the caller needs to\r
+ make this procedure call again with level_index\r
+ unchanged and err_type_index, incremented.\r
+\r
+**/\r
+#define PAL_MC_ERROR_INFO 25\r
+\r
+/**\r
+ PAL Procedure - PAL_MC_EXPECTED.\r
+\r
+ Set/Reset Expected Machine Check Indicator. It is required by\r
+ IPF. The PAL procedure supports the Static Registers calling\r
+ convention. It could be called at physical mode.\r
+\r
+ @param Index Index of PAL_MC_EXPECTED within the list of PAL\r
+ procedures.\r
+ @param Expected Unsigned integer with a value of 0 or 1 to\r
+ set or reset the hardware resource\r
+ PALE_CHECK examines for expected machine\r
+ checks.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Unsigned integer denoting whether a machine check\r
+ was previously expected.\r
+\r
+**/\r
+#define PAL_MC_EXPECTED 23\r
+\r
+/**\r
+ PAL Procedure - PAL_MC_REGISTER_MEM.\r
+\r
+ Register min-state save area with PAL for machine checks and\r
+ inits. It is required by IPF. The PAL procedure supports the\r
+ Static Registers calling convention. It could be called at\r
+ physical mode.\r
+\r
+ @param Index Index of PAL_MC_REGISTER_MEM within the list of PAL\r
+ procedures.\r
+ @param Address Physical address of the buffer to be\r
+ registered with PAL.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+**/\r
+#define PAL_MC_REGISTER_MEM 27\r
+\r
+/**\r
+ PAL Procedure - PAL_MC_RESUME.\r
+\r
+ Restore minimal architected state and return to interrupted\r
+ process. It is required by IPF. The PAL procedure supports the\r
+ Static Registers calling convention. It could be called at\r
+ physical mode.\r
+\r
+ @param Index Index of PAL_MC_RESUME within the list of PAL\r
+ procedures.\r
+ @param SetCmci Unsigned 64 bit integer denoting whether to\r
+ set the CMC interrupt. A value of 0 indicates\r
+ not to set the interrupt, a value of 1\r
+ indicated to set the interrupt, and all other\r
+ values are reserved.\r
+ @param SavePtr Physical address of min-state save area used\r
+ to used to restore processor state.\r
+ @param NewContext Unsigned 64-bit integer denoting whether\r
+ the caller is returning to a new context.\r
+ A value of 0 indicates the caller is\r
+ returning to the interrupted context, a\r
+ value of 1 indicates that the caller is\r
+ returning to a new context.\r
+\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+**/\r
+#define PAL_MC_RESUME 26\r
+\r
+/**\r
+ PAL Procedure - PAL_HALT.\r
+\r
+ Enter the low-power HALT state or an implementation-dependent\r
+ low-power state. It is optinal. The PAL procedure supports the\r
+ Static Registers calling convention. It could be called at\r
+ physical mode.\r
+\r
+ @param Index Index of PAL_HALT within the list of PAL\r
+ procedures.\r
+ @param HaltState Unsigned 64-bit integer denoting low power\r
+ state requested.\r
+ @param IoDetailPtr 8-byte aligned physical address pointer to\r
+ information on the type of I/O\r
+ (load/store) requested.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Value returned if a load instruction is requested\r
+ in the io_detail_ptr\r
+\r
+**/\r
+#define PAL_HALT 28\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_HALT_INFO.\r
+\r
+ Return the low power capabilities of the processor. It is\r
+ required by IPF. The PAL procedure supports the\r
+ Stacked Registers calling convention. It could be called at\r
+ physical and virtual mode.\r
+\r
+ @param Index Index of PAL_HALT_INFO within the list of PAL\r
+ procedures.\r
+ @param PowerBuffer 64-bit pointer to a 64-byte buffer aligned\r
+ on an 8-byte boundary.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+**/\r
+#define PAL_HALT_INFO 257\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_HALT_LIGHT.\r
+\r
+ Enter the low power LIGHT HALT state. It is required by\r
+ IPF. The PAL procedure supports the Static Registers calling\r
+ convention. It could be called at physical and virtual mode.\r
+\r
+ @param Index Index of PAL_HALT_LIGHT within the list of PAL\r
+ procedures.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+**/\r
+#define PAL_HALT_LIGHT 29\r
+\r
+/**\r
+ PAL Procedure - PAL_CACHE_LINE_INIT.\r
+\r
+ Initialize tags and data of a cache line for processor\r
+ testing. It is required by IPF. The PAL procedure supports the\r
+ Static Registers calling convention. It could be called at\r
+ physical and virtual mode.\r
+\r
+ @param Index Index of PAL_CACHE_LINE_INIT within the list of PAL\r
+ procedures.\r
+ @param Address Unsigned 64-bit integer value denoting the\r
+ physical address from which the physical page\r
+ number is to be generated. The address must be\r
+ an implemented physical address, bit 63 must\r
+ be zero.\r
+ @param DataValue 64-bit data value which is used to\r
+ initialize the cache line.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+**/\r
+#define PAL_CACHE_LINE_INIT 31\r
+\r
+/**\r
+ PAL Procedure - PAL_CACHE_READ.\r
+\r
+ Read tag and data of a cache line for diagnostic testing. It\r
+ is optional. The PAL procedure supports the\r
+ Satcked Registers calling convention. It could be called at\r
+ physical mode.\r
+\r
+ @param Index Index of PAL_CACHE_READ within the list of PAL\r
+ procedures.\r
+ @param LineId 8-byte formatted value describing where in the\r
+ cache to read the data.\r
+ @param Address 64-bit 8-byte aligned physical address from\r
+ which to read the data. The address must be an\r
+ implemented physical address on the processor\r
+ model with bit 63 set to zero.\r
+\r
+ @retval 1 The word at address was found in the\r
+ cache, but the line was invalid.\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -5 The word at address was not found in the\r
+ cache.\r
+ @retval -7 The operation requested is not supported\r
+ for this cache_type and level.\r
+\r
+ @return R9 Right-justified value returned from the cache\r
+ line.\r
+ @return R10 The number of bits returned in data.\r
+ @return R11 The status of the cache line.\r
+\r
+**/\r
+#define PAL_CACHE_READ 259\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_CACHE_WRITE.\r
+\r
+ Write tag and data of a cache for diagnostic testing. It is\r
+ optional. The PAL procedure supports the Satcked Registers\r
+ calling convention. It could be called at physical mode.\r
+\r
+ @param Index Index of PAL_CACHE_WRITE within the list of PAL\r
+ procedures.\r
+ @param LineId 8-byte formatted value describing where in the\r
+ cache to write the data.\r
+ @param Address 64-bit 8-byte aligned physical address at\r
+ which the data should be written. The address\r
+ must be an implemented physical address on the\r
+ processor model with bit 63 set to 0.\r
+ @param Data Unsigned 64-bit integer value to write into\r
+ the specified part of the cache.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -7 The operation requested is not supported\r
+ for this cache_type and level.\r
+\r
+**/\r
+#define PAL_CACHE_WRITE 260\r
+\r
+/**\r
+ PAL Procedure - PAL_TEST_INFO.\r
+\r
+ Returns alignment and size requirements needed for the memory\r
+ buffer passed to the PAL_TEST_PROC procedure as well as\r
+ information on self-test control words for the processor self\r
+ tests. It is required by IPF. The PAL procedure supports the\r
+ Static Registers calling convention. It could be called at\r
+ physical mode.\r
+\r
+ @param Index Index of PAL_TEST_INFO within the list of PAL\r
+ procedures.\r
+ @param TestPhase Unsigned integer that specifies which phase\r
+ of the processor self-test information is\r
+ being requested on. A value of 0 indicates\r
+ the phase two of the processor self-test and\r
+ a value of 1 indicates phase one of the\r
+ processor self-test. All other values are\r
+ reserved.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Unsigned 64-bit integer denoting the number of\r
+ bytes of main memory needed to perform the second\r
+ phase of processor self-test.\r
+ @return R10 Unsigned 64-bit integer denoting the alignment\r
+ required for the memory buffer.\r
+ @return R11 48-bit wide bit-field indicating if control of\r
+ the processor self-tests is supported and which\r
+ bits of the test_control field are defined for\r
+ use.\r
+\r
+**/\r
+#define PAL_TEST_INFO 37\r
+\r
+/**\r
+\r
+ @param BufferSize Indicates the size in bytes of the memory\r
+ buffer that is passed to this procedure.\r
+ BufferSize must be greater than or equal in\r
+ size to the bytes_needed return value from\r
+ PAL_TEST_INFO, otherwise this procedure will\r
+ return with an invalid argument return\r
+ value.\r
+\r
+ @param TestPhase Defines which phase of the processor\r
+ self-tests are requested to be run. A value\r
+ of zero indicates to run phase two of the\r
+ processor self-tests. Phase two of the\r
+ processor self-tests are ones that require\r
+ external memory to execute correctly. A\r
+ value of one indicates to run phase one of\r
+ the processor self-tests. Phase one of the\r
+ processor self-tests are tests run during\r
+ PALE_RESET and do not depend on external\r
+ memory to run correctly. When the caller\r
+ requests to have phase one of the processor\r
+ self-test run via this procedure call, a\r
+ memory buffer may be needed to save and\r
+ restore state as required by the PAL calling\r
+ conventions. The procedure PAL_TEST_INFO\r
+ informs the caller about the requirements of\r
+ the memory buffer.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 BufferSize:56;\r
+ UINT64 TestPhase:8;\r
+} PAL_TEST_INFO_INFO;\r
+\r
+/**\r
+\r
+ @param TestControl This is an ordered implementation-specific\r
+ control word that allows the user control\r
+ over the length and runtime of the\r
+ processor self-tests. This control word is\r
+ ordered from the longest running tests up\r
+ to the shortest running tests with bit 0\r
+ controlling the longest running test. PAL\r
+ may not implement all 47-bits of the\r
+ test_control word. PAL communicates if a\r
+ bit provides control by placing a zero in\r
+ that bit. If a bit provides no control,\r
+ PAL will place a one in it. PAL will have\r
+ two sets of test_control bits for the two\r
+ phases of the processor self-test. PAL\r
+ provides information about implemented\r
+ test_control bits at the hand-off from PAL\r
+ to SAL for the firmware recovery check.\r
+ These test_control bits provide control\r
+ for phase one of processor self-test. It\r
+ also provides this information via the PAL\r
+ procedure call PAL_TEST_INFO for both the\r
+ phase one and phase two processor tests\r
+ depending on which information the caller\r
+ is requesting. PAL interprets these bits\r
+ as input parameters on two occasions. The\r
+ first time is when SAL passes control back\r
+ to PAL after the firmware recovery check.\r
+ The second time is when a call to\r
+ PAL_TEST_PROC is made. When PAL interprets\r
+ these bits it will only interpret\r
+ implemented test_control bits and will\r
+ ignore the values located in the\r
+ unimplemented test_control bits. PAL\r
+ interprets the implemented bits such that\r
+ if a bit contains a zero, this indicates\r
+ to run the test. If a bit contains a one,\r
+ this indicates to PAL to skip the test. If\r
+ the cs bit indicates that control is not\r
+ available, the test_control bits will be\r
+ ignored or generate an illegal argument in\r
+ procedure calls if the caller sets these\r
+ bits.\r
+\r
+ @param ControlSupport This bit defines if an implementation\r
+ supports control of the PAL self-tests\r
+ via the self-test control word. If\r
+ this bit is 0, the implementation does\r
+ not support control of the processor\r
+ self-tests via the self-test control\r
+ word. If this bit is 1, the\r
+ implementation does support control of\r
+ the processor self-tests via the\r
+ self-test control word. If control is\r
+ not supported, GR37 will be ignored at\r
+ the hand-off between SAL and PAL after\r
+ the firmware recovery check and the\r
+ PAL procedures related to the\r
+ processor self-tests may return\r
+ illegal arguments if a user tries to\r
+ use the self-test control features.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 TestControl:47;\r
+ UINT64 ControlSupport:1;\r
+ UINT64 Reserved:16;\r
+} PAL_SELF_TEST_CONTROL;\r
+\r
+/**\r
+\r
+ @param Attributes Specifies the memory attributes that are\r
+ allowed to be used with the memory buffer\r
+ passed to this procedure. The attributes\r
+ parameter is a vector where each bit\r
+ represents one of the virtual memory\r
+ attributes defined by the architecture.See\r
+ MEMORY_AATRIBUTES. The caller is required\r
+ to support the cacheable attribute for the\r
+ memory buffer, otherwise an invalid\r
+ argument will be returned.\r
+\r
+\r
+ @param TestControl Is the self-test control word\r
+ corresponding to the test_phase passed.\r
+ This test_control directs the coverage and\r
+ runtime of the processor self-tests\r
+ specified by the test_phase input\r
+ argument. Information on if this\r
+ feature is implemented and the number of\r
+ bits supported can be obtained by the\r
+ PAL_TEST_INFO procedure call. If this\r
+ feature is implemented by the processor,\r
+ the caller can selectively skip parts of\r
+ the processor self-test by setting\r
+ test_control bits to a one. If a bit has a\r
+ zero, this test will be run. The values in\r
+ the unimplemented bits are ignored. If\r
+ PAL_TEST_INFO indicated that the self-test\r
+ control word is not implemented, this\r
+ procedure will return with an invalid\r
+ argument status if the caller sets any of\r
+ the test_control bits. See\r
+ PAL_SELF_TEST_CONTROL.\r
+**/\r
+typedef struct {\r
+ UINT64 Attributes:8;\r
+ UINT64 Reserved:8;\r
+ UINT64 TestControl:48;\r
+} PAL_TEST_CONTROL;\r
+\r
+/**\r
+ PAL Procedure - PAL_TEST_PROC.\r
+\r
+ Perform late processor self test. It is required by IPF. The\r
+ PAL procedure supports the Static Registers calling\r
+ convention. It could be called at physical mode.\r
+\r
+ @param Index Index of PAL_TEST_PROC within the list of PAL\r
+ procedures.\r
+ @param TestAddress 64-bit physical address of main memory\r
+ area to be used by processor self-test.\r
+ The memory region passed must be\r
+ cacheable, bit 63 must be zero.\r
+ @param TestInfo Input argument specifying the size of the\r
+ memory buffer passed and the phase of the\r
+ processor self-test that should be run. See\r
+ PAL_TEST_INFO.\r
+ @param TestParam Input argument specifying the self-test\r
+ control word and the allowable memory\r
+ attributes that can be used with the memory\r
+ buffer. See PAL_TEST_CONTROL.\r
+\r
+ @retval 1 Call completed without error, but hardware\r
+ failures occurred during self-test.\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Formatted 8-byte value denoting the state of the\r
+ processor after self-test\r
+\r
+**/\r
+#define PAL_TEST_PROC 258\r
+\r
+/**\r
+\r
+ @param NumberOfInterruptControllers Number of interrupt\r
+ controllers currently\r
+ enabled on the system.\r
+\r
+ @param NumberOfProcessors Number of processors currently\r
+ enabled on the system.\r
+\r
+**/\r
+typedef struct {\r
+ UINT32 NumberOfInterruptControllers;\r
+ UINT32 NumberOfProcessors;\r
+} PAL_PLATFORM_INFO;\r
+\r
+/**\r
+ PAL Procedure - PAL_COPY_INFO.\r
+\r
+ Return information needed to relocate PAL procedures and PAL\r
+ PMI code to memory. It is required by IPF. The PAL procedure\r
+ supports the Static Registers calling convention. It could be\r
+ called at physical mode.\r
+\r
+ @param Index Index of PAL_COPY_INFO within the list of PAL\r
+ procedures.\r
+ @param CopyType Unsigned integer denoting type of procedures\r
+ for which copy information is requested.\r
+ @param PlatformInfo 8-byte formatted value describing the\r
+ number of processors and the number of\r
+ interrupt controllers currently enabled\r
+ on the system. See PAL_PLATFORM_INFO.\r
+ @param McaProcStateInfo Unsigned integer denoting the number\r
+ of bytes that SAL needs for the\r
+ min-state save area for each\r
+ processor.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Unsigned integer denoting the number of bytes of\r
+ PAL information that must be copied to main\r
+ memory.\r
+ @return R10 Unsigned integer denoting the starting alignment\r
+ of the data to be copied.\r
+\r
+**/\r
+#define PAL_COPY_INFO 30\r
+\r
+/**\r
+ PAL Procedure - PAL_COPY_PAL.\r
+\r
+ Relocate PAL procedures and PAL PMI code to memory. It is\r
+ required by IPF. The PAL procedure supports the Stacked\r
+ Registers calling convention. It could be called at physical\r
+ mode.\r
+\r
+ @param Index Index of PAL_COPY_PAL within the list of PAL\r
+ procedures.\r
+ @param TargetAddress Physical address of a memory buffer to\r
+ copy relocatable PAL procedures and PAL\r
+ PMI code.\r
+ @param AllocSize Unsigned integer denoting the size of the\r
+ buffer passed by SAL for the copy operation.\r
+ @param CopyOption Unsigned integer indicating whether\r
+ relocatable PAL code and PAL PMI code\r
+ should be copied from firmware address\r
+ space to main memory.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Unsigned integer denoting the offset of PAL_PROC\r
+ in the relocatable segment copied.\r
+\r
+**/\r
+#define PAL_COPY_PAL 256\r
+\r
+/**\r
+ PAL Procedure - PAL_ENTER_IA_32_ENV.\r
+\r
+ Enter IA-32 System environment. It is optional. The PAL\r
+ procedure supports the Static Registers calling convention.\r
+ It could be called at physical mode.\r
+\r
+ Note: Since this is a special call, it does not follow the PAL\r
+ static register calling convention. GR28 contains the index of\r
+ PAL_ENTER_IA_32_ENV within the list of PAL procedures. All other\r
+ input arguments including GR29-GR31 are setup by SAL to values\r
+ as required by the IA-32 operating system defined in Table\r
+ 11-67. The registers that are designated as preserved, scratch,\r
+ input arguments and procedure return values by the static\r
+ procedure calling convention are not followed by this call. For\r
+ instance, GR5 and GR6 need not be preserved since these are\r
+ regarded as scratch by the IA-32 operating system. Note: In an\r
+ MP system, this call must be COMPLETED on the first CPU to enter\r
+ the IA-32 System Environment (may or may not be the BSP) prior\r
+ to being called on the remaining processors in the MP system.\r
+\r
+ @param Index GR28 contains the index of the\r
+ PAL_ENTER_IA_32_ENV call within the list of PAL\r
+ procedures.\r
+\r
+\r
+ @retval The status is returned in GR4.\r
+ -1 - Un-implemented procedure 0 JMPE detected\r
+ at privilege level\r
+\r
+ 0 - 1 SAL allocated buffer for IA-32 System\r
+ Environment operation is too small\r
+\r
+ 2 - IA-32 Firmware Checksum Error\r
+\r
+ 3 - SAL allocated buffer for IA-32 System\r
+ Environment operation is not properly aligned\r
+\r
+ 4 - Error in SAL MP Info Table\r
+\r
+ 5 - Error in SAL Memory Descriptor Table\r
+\r
+ 6 - Error in SAL System Table\r
+\r
+ 7 - Inconsistent IA-32 state\r
+\r
+ 8 - IA-32 Firmware Internal Error\r
+\r
+ 9 - IA-32 Soft Reset (Note: remaining register\r
+ state is undefined for this termination\r
+ reason)\r
+\r
+ 10 - Machine Check Error\r
+\r
+ 11 - Error in SAL I/O Intercept Table\r
+\r
+ 12 - Processor exit due to other processor in\r
+ MP system terminating the IA32 system\r
+ environment. (Note: remaining register state\r
+ is undefined for this termination reason.)\r
+\r
+ 13 - Itanium architecture-based state\r
+ corruption by either SAL PMI handler or I/O\r
+ Intercept callback function.\r
+\r
+\r
+**/\r
+#define PAL_ENTER_IA_32_ENV 33\r
+\r
+/**\r
+ PAL Procedure - PAL_PMI_ENTRYPOINT.\r
+\r
+ Register PMI memory entrypoints with processor. It is required\r
+ by IPF. The PAL procedure supports the Stacked Registers\r
+ calling convention. It could be called at physical mode.\r
+\r
+ @param Index Index of PAL_PMI_ENTRYPOINT within the list of\r
+ PAL procedures.\r
+ @param SalPmiEntry 256-byte aligned physical address of SAL\r
+ PMI entrypoint in memory.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+**/\r
+#define PAL_PMI_ENTRYPOINT 32\r
+\r
+\r
+/**\r
+\r
+ The ASCII brand identification string will be copied to the\r
+ address specified in the address input argument. The processor\r
+ brand identification string is defined to be a maximum of 128\r
+ characters long; 127 bytes will contain characters and the 128th\r
+ byte is defined to be NULL (0). A processor may return less than\r
+ the 127 ASCII characters as long as the string is null\r
+ terminated. The string length will be placed in the brand_info\r
+ return argument.\r
+\r
+**/\r
+#define PAL_BRAND_INFO_ID_REQUEST 0\r
+\r
+/**\r
+ PAL Procedure - PAL_BRAND_INFO.\r
+\r
+ Provides processor branding information. It is optional by\r
+ IPF. The PAL procedure supports the Stacked Registers calling\r
+ convention. It could be called at physical and Virtual mode.\r
+\r
+ @param Index Index of PAL_BRAND_INFO within the list of PAL\r
+ procedures.\r
+ @param InfoRequest Unsigned 64-bit integer specifying the\r
+ information that is being requested. (See\r
+ PAL_BRAND_INFO_ID_REQUEST)\r
+ @param Address Unsigned 64-bit integer specifying the\r
+ address of the 128-byte block to which the\r
+ processor brand string shall be written.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -6 Input argument is not implemented.\r
+\r
+ @return R9 Brand information returned. The format of this\r
+ value is dependent on the input values passed.\r
+\r
+**/\r
+#define PAL_BRAND_INFO 274\r
+\r
+/**\r
+ PAL Procedure - PAL_GET_HW_POLICY.\r
+\r
+ Returns the current hardware resource sharing policy of the\r
+ processor. It is optional by IPF. The PAL procedure supports\r
+ the Static Registers calling convention. It could be called at\r
+ physical and Virtual mode.\r
+\r
+\r
+ @param Index Index of PAL_GET_HW_POLICY within the list of PAL\r
+ procedures.\r
+ @param ProcessorNumber Unsigned 64-bit integer that specifies\r
+ for which logical processor\r
+ information is being requested. This\r
+ input argument must be zero for the\r
+ first call to this procedure and can\r
+ be a maximum value of one less than\r
+ the number of logical processors\r
+ impacted by the hardware resource\r
+ sharing policy, which is returned by\r
+ the R10 return value.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+ @return R9 Unsigned 64-bit integer representing the current\r
+ hardware resource sharing policy.\r
+ @return R10 Unsigned 64-bit integer that returns the number\r
+ of logical processors impacted by the policy\r
+ input argument.\r
+ @return R11 Unsigned 64-bit integer containing the logical\r
+ address of one of the logical processors\r
+ impacted by policy modification.\r
+\r
+**/\r
+#define PAL_GET_HW_POLICY 48\r
+\r
+\r
+//\r
+// Value of PAL_SET_HW_POLICY.Policy\r
+//\r
+#define PAL_SET_HW_POLICY_PERFORMANCE 0\r
+#define PAL_SET_HW_POLICY_FAIRNESS 1\r
+#define PAL_SET_HW_POLICY_HIGH_PRIORITY 2\r
+#define PAL_SET_HW_POLICY_EXCLUSIVE_HIGH_PRIORITY 3\r
+\r
+/**\r
+ PAL Procedure - PAL_SET_HW_POLICY.\r
+\r
+ Sets the current hardware resource sharing policy of the\r
+ processor. It is optional by IPF. The PAL procedure supports\r
+ the Static Registers calling convention. It could be called at\r
+ physical and Virtual mode.\r
+\r
+ @param Index Index of PAL_SET_HW_POLICY within the list of PAL\r
+ procedures.\r
+ @param Policy Unsigned 64-bit integer specifying the hardware\r
+ resource sharing policy the caller is setting.\r
+ See Value of PAL_SET_HW_POLICY.Policy above.\r
+\r
+ @retval 1 Call completed successfully but could not\r
+ change the hardware policy since a\r
+ competing logical processor is set in\r
+ exclusive high priority.\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+**/\r
+#define PAL_SET_HW_POLICY 49\r
+\r
+\r
+/**\r
+\r
+ @param Mode Bit2:0, Indicates the mode of operation for this\r
+ procedure: 0 - Query mode 1 - Error inject mode\r
+ (err_inj should also be specified) 2 - Cancel\r
+ outstanding trigger. All other fields in\r
+ PAL_MC_ERROR_TYPE_INFO,\r
+ PAL_MC_ERROR_STRUCTURE_INFO and\r
+ PAL_MC_ERROR_DATA_BUFFER are ignored. All other\r
+ values are reserved.\r
+\r
+ @param ErrorInjection Bit5:3, indicates the mode of error\r
+ injection: 0 - Error inject only (no\r
+ error consumption) 1 - Error inject\r
+ and consume All other values are\r
+ reserved.\r
+\r
+\r
+ @param ErrorSeverity Bit7:6, indicates the severity desired\r
+ for error injection/query. Definitions\r
+ of the different error severity types\r
+ 0 - Corrected error 1 - Recoverable\r
+ error 2 - Fatal error 3 - Reserved\r
+\r
+\r
+ @param ErrorStructure Bit12:8, Indicates the structure\r
+ identification for error\r
+ injection/query: 0 - Any structure\r
+ (cannot be used during query mode).\r
+ When selected, the structure type used\r
+ for error injection is determined by\r
+ PAL. 1 - Cache 2 - TLB 3 - Register\r
+ file 4 - Bus/System interconnect 5-15\r
+ - Reserved 16-31 - Processor\r
+ specific error injection\r
+ capabilities.ErrorDataBuffer is used\r
+ to specify error types. Please refer\r
+ to the processor specific\r
+ documentation for additional details.\r
+\r
+ @param StructureHierarchy Bit15:13, Indicates the structure\r
+ hierarchy for error\r
+ injection/query: 0 - Any level of\r
+ hierarchy (cannot be used during\r
+ query mode). When selected, the\r
+ structure hierarchy used for error\r
+ injection is determined by PAL. 1\r
+ - Error structure hierarchy\r
+ level-1 2 - Error structure\r
+ hierarchy level-2 3 - Error\r
+ structure hierarchy level-3 4 -\r
+ Error structure hierarchy level-4\r
+ All other values are reserved.\r
+ Reserved 63:16 Reserved\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 Mode:3;\r
+ UINT64 ErrorInjection:3;\r
+ UINT64 ErrorSeverity:2;\r
+ UINT64 ErrorStructure:5;\r
+ UINT64 StructureHierarchy:3;\r
+ UINT64 Reserved:48;\r
+} PAL_MC_ERROR_TYPE_INFO;\r
+\r
+/**\r
+\r
+ @param StructInfoIsValid Bit0 When 1, indicates that the\r
+ structure information fields\r
+ (c_t,cl_p,cl_id) are valid and\r
+ should be used for error injection.\r
+ When 0, the structure information\r
+ fields are ignored, and the values\r
+ of these fields used for error\r
+ injection are\r
+ implementation-specific.\r
+\r
+ @param CacheType Bit2:1 Indicates which cache should be used\r
+ for error injection: 0 - Reserved 1 -\r
+ Instruction cache 2 - Data or unified cache\r
+ 3 - Reserved\r
+\r
+\r
+ @param PortionOfCacheLine Bit5:3 Indicates the portion of the\r
+ cache line where the error should\r
+ be injected: 0 - Reserved 1 - Tag\r
+ 2 - Data 3 - mesi All other\r
+ values are reserved.\r
+\r
+ @param Mechanism Bit8:6 Indicates which mechanism is used to\r
+ identify the cache line to be used for error\r
+ injection: 0 - Reserved 1 - Virtual address\r
+ provided in the inj_addr field of the buffer\r
+ pointed to by err_data_buffer should be used\r
+ to identify the cache line for error\r
+ injection. 2 - Physical address provided in\r
+ the inj_addr field of the buffer pointed to\r
+ by err_data_buffershould be used to identify\r
+ the cache line for error injection. 3 - way\r
+ and index fields provided in err_data_buffer\r
+ should be used to identify the cache line\r
+ for error injection. All other values are\r
+ reserved.\r
+\r
+ @param DataPoisonOfCacheLine Bit9 When 1, indicates that a\r
+ multiple bit, non-correctable\r
+ error should be injected in the\r
+ cache line specified by cl_id.\r
+ If this injected error is not\r
+ consumed, it may eventually\r
+ cause a data-poisoning event\r
+ resulting in a corrected error\r
+ signal, when the associated\r
+ cache line is cast out (implicit\r
+ or explicit write-back of the\r
+ cache line). The error severity\r
+ specified by err_sev in\r
+ err_type_info must be set to 0\r
+ (corrected error) when this bit\r
+ is set.\r
+\r
+\r
+ @param TrigerInfoIsValid Bit32 When 1, indicates that the\r
+ trigger information fields (trigger,\r
+ trigger_pl) are valid and should be\r
+ used for error injection. When 0,\r
+ the trigger information fields are\r
+ ignored and error injection is\r
+ performed immediately.\r
+\r
+ @param Triger Bit36:33 Indicates the operation type to be\r
+ used as the error trigger condition. The\r
+ address corresponding to the trigger is\r
+ specified in the trigger_addr field of the\r
+ buffer pointed to by err_data_buffer: 0 -\r
+ Instruction memory access. The trigger match\r
+ conditions for this operation type are similar\r
+ to the IBR address breakpoint match conditions\r
+ 1 - Data memory access. The trigger match\r
+ conditions for this operation type are similar\r
+ to the DBR address breakpoint match conditions\r
+ All other values are reserved.\r
+\r
+ @param PrivilegeOfTriger Bit39:37 Indicates the privilege\r
+ level of the context during which\r
+ the error should be injected: 0 -\r
+ privilege level 0 1 - privilege\r
+ level 1 2 - privilege level 2 3 -\r
+ privilege level 3 All other values\r
+ are reserved. If the implementation\r
+ does not support privilege level\r
+ qualifier for triggers (i.e. if\r
+ trigger_pl is 0 in the capabilities\r
+ vector), this field is ignored and\r
+ triggers can be taken at any\r
+ privilege level.\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 StructInfoIsValid:1;\r
+ UINT64 CacheType:2;\r
+ UINT64 PortionOfCacheLine:3;\r
+ UINT64 Mechanism:3;\r
+ UINT64 DataPoisonOfCacheLine:1;\r
+ UINT64 Reserved1:22;\r
+ UINT64 TrigerInfoIsValid:1;\r
+ UINT64 Triger:4;\r
+ UINT64 PrivilegeOfTriger:3;\r
+ UINT64 Reserved2:24;\r
+} PAL_MC_ERROR_STRUCT_INFO;\r
+\r
+/**\r
+\r
+ Buffer Pointed to by err_data_buffer - TLB\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 TrigerAddress;\r
+ UINT64 VirtualPageNumber:52;\r
+ UINT64 Reserved1:8;\r
+ UINT64 RegionId:24;\r
+ UINT64 Reserved2:40;\r
+} PAL_MC_ERROR_DATA_BUFFER_TLB;\r
+\r
+/**\r
+ PAL Procedure - PAL_MC_ERROR_INJECT.\r
+\r
+ Injects the requested processor error or returns information\r
+ on the supported injection capabilities for this particular\r
+ processor implementation. It is optional by IPF. The PAL\r
+ procedure supports the Stacked Registers calling convention.\r
+ It could be called at physical and Virtual mode.\r
+\r
+ @param Index Index of PAL_MC_ERROR_INJECT within the list of PAL\r
+ procedures.\r
+ @param ErrorTypeInfo Unsigned 64-bit integer specifying the\r
+ first level error information which\r
+ identifies the error structure and\r
+ corresponding structure hierarchy, and\r
+ the error severity.\r
+ @param ErrorStructInfo Unsigned 64-bit integer identifying\r
+ the optional structure specific\r
+ information that provides the second\r
+ level details for the requested error.\r
+ @param ErrorDataBuffer 64-bit physical address of a buffer\r
+ providing additional parameters for\r
+ the requested error. The address of\r
+ this buffer must be 8-byte aligned.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -4 Call completed with error; the requested\r
+ error could not be injected due to failure in\r
+ locating the target location in the specified\r
+ structure.\r
+ @retval -5 Argument was valid, but requested error\r
+ injection capability is not supported.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+ @return R9 64-bit vector specifying the supported error\r
+ injection capabilities for the input argument\r
+ combination of struct_hier, err_struct and\r
+ err_sev fields in ErrorTypeInfo.\r
+ @return R10 64-bit vector specifying the architectural\r
+ resources that are used by the procedure.\r
+\r
+**/\r
+#define PAL_MC_ERROR_INJECT 276\r
+\r
+\r
+//\r
+// Types of PAL_GET_PSTATE.Type\r
+//\r
+#define PAL_GET_PSTATE_RECENT 0\r
+#define PAL_GET_PSTATE_AVERAGE_NEW_START 1\r
+#define PAL_GET_PSTATE_AVERAGE 2\r
+#define PAL_GET_PSTATE_NOW 3\r
+\r
+/**\r
+ PAL Procedure - PAL_GET_PSTATE.\r
+\r
+ Returns the performance index of the processor. It is optional\r
+ by IPF. The PAL procedure supports the Stacked Registers\r
+ calling convention. It could be called at physical and Virtual\r
+ mode.\r
+\r
+ @param Index Index of PAL_GET_PSTATE within the list of PAL\r
+ procedures.\r
+ @param Type Type of performance_index value to be returned\r
+ by this procedure.See PAL_GET_PSTATE.Type above.\r
+\r
+ @retval 1 Call completed without error, but accuracy\r
+ of performance index has been impacted by a\r
+ thermal throttling event, or a\r
+ hardware-initiated event.\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+ @return R9 Unsigned integer denoting the processor\r
+ performance for the time duration since the last\r
+ PAL_GET_PSTATE procedure call was made. The\r
+ value returned is between 0 and 100, and is\r
+ relative to the performance index of the highest\r
+ available P-state.\r
+\r
+**/\r
+#define PAL_GET_PSTATE 262\r
+\r
+/**\r
+\r
+ Layout of PAL_PSTATE_INFO.PStateBuffer\r
+\r
+**/\r
+typedef struct {\r
+ UINT32 PerformanceIndex:7;\r
+ UINT32 Reserved1:5;\r
+ UINT32 TypicalPowerDissipation:20;\r
+ UINT32 TransitionLatency1;\r
+ UINT32 TransitionLatency2;\r
+ UINT32 Reserved2;\r
+} PAL_PSTATE_INFO_BUFFER;\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_PSTATE_INFO.\r
+\r
+ Returns information about the P-states supported by the\r
+ processor. It is optional by IPF. The PAL procedure supports\r
+ the Static Registers calling convention. It could be called\r
+ at physical and Virtual mode.\r
+\r
+ @param Index Index of PAL_PSTATE_INFO within the list of PAL\r
+ procedures.\r
+ @param PStateBuffer 64-bit pointer to a 256-byte buffer\r
+ aligned on an 8-byte boundary. See\r
+ PAL_PSTATE_INFO_BUFFER above.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+\r
+ @return R9 Unsigned integer denoting the number of P-states\r
+ supported. The maximum value of this field is 16.\r
+ @return R10 Dependency domain information\r
+\r
+**/\r
+#define PAL_PSTATE_INFO 44\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_SET_PSTATE.\r
+\r
+ To request a processor transition to a given P-state. It is\r
+ optional by IPF. The PAL procedure supports the Stacked\r
+ Registers calling convention. It could be called at physical\r
+ and Virtual mode.\r
+\r
+ @param Index Index of PAL_SET_PSTATE within the list of PAL\r
+ procedures.\r
+ @param PState Unsigned integer denoting the processor\r
+ P-state being requested.\r
+ @param ForcePState Unsigned integer denoting whether the\r
+ P-state change should be forced for the\r
+ logical processor.\r
+\r
+ @retval 1 Call completed without error, but\r
+ transition request was not accepted\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+**/\r
+#define PAL_SET_PSTATE 263\r
+\r
+/**\r
+ PAL Procedure - PAL_SHUTDOWN.\r
+\r
+ Put the logical processor into a low power state which can be\r
+ exited only by a reset event. It is optional by IPF. The PAL\r
+ procedure supports the Static Registers calling convention. It\r
+ could be called at physical mode.\r
+\r
+ @param Index Index of PAL_SHUTDOWN within the list of PAL\r
+ procedures.\r
+ @param NotifyPlatform 8-byte aligned physical address\r
+ pointer providing details on how to\r
+ optionally notify the platform that\r
+ the processor is entering a shutdown\r
+ state.\r
+\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+**/\r
+#define PAL_SHUTDOWN 45\r
+\r
+/**\r
+\r
+ Layout of PAL_MEMORY_BUFFER.ControlWord\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 Registration:1;\r
+ UINT64 ProbeInterrupt:1;\r
+ UINT64 Reserved:62;\r
+} PAL_MEMORY_CONTROL_WORD;\r
+\r
+/**\r
+ PAL Procedure - PAL_MEMORY_BUFFER.\r
+\r
+ Provides cacheable memory to PAL for exclusive use during\r
+ runtime. It is optional by IPF. The PAL procedure supports the\r
+ Static Registers calling convention. It could be called at\r
+ physical mode.\r
+\r
+ @param Index Index of PAL_MEMORY_BUFFER within the list of PAL\r
+ procedures.\r
+ @param BaseAddress Physical address of the memory buffer\r
+ allocated for PAL use.\r
+ @param AllocSize Unsigned integer denoting the size of the\r
+ memory buffer.\r
+ @param ControlWord Formatted bit vector that provides control\r
+ options for this procedure. See\r
+ PAL_MEMORY_CONTROL_WORD above.\r
+\r
+ @retval 1 Call has not completed a buffer relocation\r
+ due to a pending interrupt\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+ @return R9 Returns the minimum size of the memory buffer\r
+ required if the alloc_size input argument was\r
+ not large enough.\r
+\r
+**/\r
+#define PAL_MEMORY_BUFFER 277\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_VP_CREATE.\r
+\r
+ Initializes a new vpd for the operation of a new virtual\r
+ processor in the virtual environment. It is optional by IPF.\r
+ The PAL procedure supports the Stacked Registers calling\r
+ convention. It could be called at Virtual mode.\r
+\r
+ @param Index Index of PAL_VP_CREATE within the list of PAL\r
+ procedures.\r
+ @param Vpd 64-bit host virtual pointer to the Virtual\r
+ Processor Descriptor (VPD).\r
+ @param HostIva 64-bit host virtual pointer to the host IVT\r
+ for the virtual processor\r
+ @param OptionalHandler 64-bit non-zero host-virtual pointer\r
+ to an optional handler for\r
+ virtualization intercepts.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+**/\r
+#define PAL_VP_CREATE 265\r
+\r
+/**\r
+\r
+ Virtual Environment Information Parameter\r
+\r
+**/\r
+typedef struct {\r
+ UINT64 Reserved1:8;\r
+ UINT64 Opcode:1;\r
+ UINT64 Reserved:53;\r
+} PAL_VP_ENV_INFO_RETURN;\r
+\r
+/**\r
+ PAL Procedure - PAL_VP_ENV_INFO.\r
+\r
+ Returns the parameters needed to enter a virtual environment.\r
+ It is optional by IPF. The PAL procedure supports the Stacked\r
+ Registers calling convention. It could be called at Virtual\r
+ mode.\r
+\r
+ @param Index Index of PAL_VP_ENV_INFO within the list of PAL\r
+ procedures.\r
+ @param Vpd 64-bit host virtual pointer to the Virtual\r
+ Processor Descriptor (VPD).\r
+ @param HostIva 64-bit host virtual pointer to the host IVT\r
+ for the virtual processor\r
+ @param OptionalHandler 64-bit non-zero host-virtual pointer\r
+ to an optional handler for\r
+ virtualization intercepts.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+ @return R9 Unsigned integer denoting the number of bytes\r
+ required by the PAL virtual environment buffer\r
+ during PAL_VP_INIT_ENV\r
+ @return R10 64-bit vector of virtual environment\r
+ information. See PAL_VP_ENV_INFO_RETURN.\r
+\r
+\r
+**/\r
+#define PAL_VP_ENV_INFO 266\r
+\r
+/**\r
+ PAL Procedure - PAL_VP_EXIT_ENV.\r
+\r
+ Allows a logical processor to exit a virtual environment.\r
+ It is optional by IPF. The PAL procedure supports the Stacked\r
+ Registers calling convention. It could be called at Virtual\r
+ mode.\r
+\r
+ @param Index Index of PAL_VP_EXIT_ENV within the list of PAL\r
+ procedures.\r
+ @param Iva Optional 64-bit host virtual pointer to the IVT\r
+ when this procedure is done\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+**/\r
+#define PAL_VP_EXIT_ENV 267\r
+\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_VP_INIT_ENV.\r
+\r
+ Allows a logical processor to enter a virtual environment. It\r
+ is optional by IPF. The PAL procedure supports the Stacked\r
+ Registers calling convention. It could be called at Virtual\r
+ mode.\r
+\r
+ @param Index Index of PAL_VP_INIT_ENV within the list of PAL\r
+ procedures.\r
+ @param ConfigOptions 64-bit vector of global configuration\r
+ settings.\r
+ @param PhysicalBase Host physical base address of a block of\r
+ contiguous physical memory for the PAL\r
+ virtual environment buffer 1) This\r
+ memory area must be allocated by the VMM\r
+ and be 4K aligned. The first logical\r
+ processor to enter the environment will\r
+ initialize the physical block for\r
+ virtualization operations.\r
+ @param VirtualBase Host virtual base address of the\r
+ corresponding physical memory block for\r
+ the PAL virtual environment buffer : The\r
+ VMM must maintain the host virtual to host\r
+ physical data and instruction translations\r
+ in TRs for addresses within the allocated\r
+ address space. Logical processors in this\r
+ virtual environment will use this address\r
+ when transitioning to virtual mode\r
+ operations.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+ @return R9 Virtualization Service Address - VSA specifies\r
+ the virtual base address of the PAL\r
+ virtualization services in this virtual\r
+ environment.\r
+\r
+\r
+**/\r
+#define PAL_VP_INIT_ENV 268\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_VP_REGISTER.\r
+\r
+ Register a different host IVT and/or a different optional\r
+ virtualization intercept handler for the virtual processor\r
+ specified by vpd. It is optional by IPF. The PAL procedure\r
+ supports the Stacked Registers calling convention. It could be\r
+ called at Virtual mode.\r
+\r
+ @param Index Index of PAL_VP_REGISTER within the list of PAL\r
+ procedures.\r
+ @param Vpd 64-bit host virtual pointer to the Virtual\r
+ Processor Descriptor (VPD) host_iva 64-bit host\r
+ virtual pointer to the host IVT for the virtual\r
+ processor\r
+ @param OptionalHandler 64-bit non-zero host-virtual pointer\r
+ to an optional handler for\r
+ virtualization intercepts.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+**/\r
+#define PAL_VP_REGISTER 269\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_VP_RESTORE.\r
+\r
+ Restores virtual processor state for the specified vpd on the\r
+ logical processor. It is optional by IPF. The PAL procedure\r
+ supports the Stacked Registers calling convention. It could be\r
+ called at Virtual mode.\r
+\r
+ @param Index Index of PAL_VP_RESTORE within the list of PAL\r
+ procedures.\r
+ @param Vpd 64-bit host virtual pointer to the Virtual\r
+ Processor Descriptor (VPD) host_iva 64-bit host\r
+ virtual pointer to the host IVT for the virtual\r
+ processor\r
+ @param PalVector Vector specifies PAL procedure\r
+ implementation-specific state to be\r
+ restored.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+**/\r
+#define PAL_VP_RESTORE 270\r
+\r
+/**\r
+ PAL Procedure - PAL_VP_SAVE.\r
+\r
+ Saves virtual processor state for the specified vpd on the\r
+ logical processor. It is optional by IPF. The PAL procedure\r
+ supports the Stacked Registers calling convention. It could be\r
+ called at Virtual mode.\r
+\r
+ @param Index Index of PAL_VP_SAVE within the list of PAL\r
+ procedures.\r
+ @param Vpd 64-bit host virtual pointer to the Virtual\r
+ Processor Descriptor (VPD) host_iva 64-bit host\r
+ virtual pointer to the host IVT for the virtual\r
+ processor\r
+ @param PalVector Vector specifies PAL procedure\r
+ implementation-specific state to be\r
+ restored.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+**/\r
+#define PAL_VP_SAVE 271\r
+\r
+\r
+/**\r
+ PAL Procedure - PAL_VP_TERMINATE.\r
+\r
+ Terminates operation for the specified virtual processor. It\r
+ is optional by IPF. The PAL procedure supports the Stacked\r
+ Registers calling convention. It could be called at Virtual\r
+ mode.\r
+\r
+ @param Index Index of PAL_VP_TERMINATE within the list of PAL\r
+ procedures.\r
+ @param Vpd 64-bit host virtual pointer to the Virtual\r
+ Processor Descriptor (VPD)\r
+ @param Iva Optional 64-bit host virtual pointer to the IVT\r
+ when this procedure is done.\r
+\r
+ @retval 0 Call completed without error\r
+ @retval -1 Unimplemented procedure\r
+ @retval -2 Invalid argument\r
+ @retval -3 Call completed with error.\r
+ @retval -9 Call requires PAL memory buffer.\r
+\r
+**/\r
+#define PAL_VP_TERMINATE 272\r
+\r
+#endif\r
#ifndef __PAL_CALL_LIB_H__\r
#define __PAL_CALL_LIB_H__\r
\r
-#define PAL_SUCCESS 0x0\r
-\r
-//\r
-// CacheType of PAL_CACHE_FLUSH.\r
-//\r
-#define PAL_CACHE_FLUSH_INSTRUCTION_ALL 1\r
-#define PAL_CACHE_FLUSH_DATA_ALL 2\r
-#define PAL_CACHE_FLUSH_ALL 3\r
-#define PAL_CACHE_FLUSH_SYNC_TO_DATA 4\r
-\r
-\r
-//\r
-// Bitmask of Opearation of PAL_CACHE_FLUSH.\r
-//\r
-#define PAL_CACHE_FLUSH_INVALIDATE_LINES BIT0\r
-#define PAL_CACHE_FLUSH_NO_INVALIDATE_LINES 0\r
-#define PAL_CACHE_FLUSH_POLL_INTERRUPT BIT1\r
-#define PAL_CACHE_FLUSH_NO_INTERRUPT 0\r
-\r
-/**\r
- PAL Procedure - PAL_CACHE_FLUSH.\r
-\r
- Flush the instruction or data caches. It is required by IPF.\r
- The PAL procedure supports the Static Registers calling\r
- convention. It could be called at virtual mode and physical\r
- mode.\r
-\r
- @param Index Index of PAL_CACHE_FLUSH within the\r
- list of PAL procedures.\r
- @param CacheType Unsigned 64-bit integer indicating\r
- which cache to flush.\r
- @param Operation Formatted bit vector indicating the\r
- operation of this call.\r
- @param ProgressIndicator Unsigned 64-bit integer specifying\r
- the starting position of the flush\r
- operation.\r
-\r
- @retval 2 Call completed without error, but a PMI\r
- was taken during the execution of this\r
- procedure.\r
- @retval 1 Call has not completed flushing due to\r
- a pending interrupt.\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error\r
-\r
- @return R9 Unsigned 64-bit integer specifying the vector\r
- number of the pending interrupt.\r
- @return R10 Unsigned 64-bit integer specifying the\r
- starting position of the flush operation.\r
- @return R11 Unsigned 64-bit integer specifying the vector\r
- number of the pending interrupt.\r
-\r
-**/\r
-#define PAL_CACHE_FLUSH 1\r
-\r
-\r
-//\r
-// Attributes of PAL_CACHE_CONFIG_INFO1\r
-//\r
-#define PAL_CACHE_ATTR_WT 0\r
-#define PAL_CACHE_ATTR_WB 1\r
-\r
-//\r
-// PAL_CACHE_CONFIG_INFO1.StoreHint\r
-//\r
-#define PAL_CACHE_STORE_TEMPORAL 0\r
-#define PAL_CACHE_STORE_NONE_TEMPORAL 3\r
-\r
-//\r
-// PAL_CACHE_CONFIG_INFO1.StoreHint\r
-//\r
-#define PAL_CACHE_STORE_TEMPORAL_LVL_1 0\r
-#define PAL_CACHE_STORE_NONE_TEMPORAL_LVL_ALL 3\r
-\r
-//\r
-// PAL_CACHE_CONFIG_INFO1.StoreHint\r
-//\r
-#define PAL_CACHE_LOAD_TEMPORAL_LVL_1 0\r
-#define PAL_CACHE_LOAD_NONE_TEMPORAL_LVL_1 1\r
-#define PAL_CACHE_LOAD_NONE_TEMPORAL_LVL_ALL 3\r
-\r
-//\r
-// Detail the characteristics of a given processor controlled\r
-// cache in the cache hierarchy.\r
-//\r
-typedef struct {\r
- UINT64 IsUnified : 1;\r
- UINT64 Attributes : 2;\r
- UINT64 Associativity:8;\r
- UINT64 LineSize:8;\r
- UINT64 Stride:8;\r
- UINT64 StoreLatency:8;\r
- UINT64 StoreHint:8;\r
- UINT64 LoadHint:8;\r
-} PAL_CACHE_INFO_RETURN1;\r
-\r
-//\r
-// Detail the characteristics of a given processor controlled\r
-// cache in the cache hierarchy.\r
-//\r
-typedef struct {\r
- UINT64 CacheSize:32;\r
- UINT64 AliasBoundary:8;\r
- UINT64 TagLsBits:8;\r
- UINT64 TagMsBits:8;\r
-} PAL_CACHE_INFO_RETURN2;\r
-\r
-/**\r
- PAL Procedure - PAL_CACHE_INFO.\r
-\r
- Return detailed instruction or data cache information. It is\r
- required by IPF. The PAL procedure supports the Static\r
- Registers calling convention. It could be called at virtual\r
- mode and physical mode.\r
-\r
- @param Index Index of PAL_CACHE_INFO within the list of\r
- PAL procedures.\r
- @param CacheLevel Unsigned 64-bit integer specifying the\r
- level in the cache hierarchy for which\r
- information is requested. This value must\r
- be between 0 and one less than the value\r
- returned in the cache_levels return value\r
- from PAL_CACHE_SUMMARY.\r
- @param CacheType Unsigned 64-bit integer with a value of 1\r
- for instruction cache and 2 for data or\r
- unified cache. All other values are\r
- reserved.\r
- @param Reserved Should be 0.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error\r
-\r
- @return R9 Detail the characteristics of a given\r
- processor controlled cache in the cache\r
- hierarchy. See PAL_CACHE_INFO_RETURN1.\r
- @return R10 Detail the characteristics of a given\r
- processor controlled cache in the cache\r
- hierarchy. See PAL_CACHE_INFO_RETURN2.\r
- @return R11 Reserved with 0.\r
-\r
-**/\r
-#define PAL_CACHE_INFO 2\r
-\r
-\r
-\r
-//\r
-// Level of PAL_CACHE_INIT.\r
-//\r
-#define PAL_CACHE_INIT_ALL 0xffffffffffffffffULL\r
-\r
-//\r
-// CacheType\r
-//\r
-#define PAL_CACHE_INIT_TYPE_INSTRUCTION 0x1\r
-#define PAL_CACHE_INIT_TYPE_DATA 0x2\r
-#define PAL_CACHE_INIT_TYPE_INSTRUCTION_AND_DATA 0x3\r
-\r
-//\r
-// Restrict of PAL_CACHE_INIT.\r
-//\r
-#define PAL_CACHE_INIT_NO_RESTRICT 0\r
-#define PAL_CACHE_INIT_RESTRICTED 1\r
-\r
-/**\r
- PAL Procedure - PAL_CACHE_INIT.\r
-\r
- Initialize the instruction or data caches. It is required by\r
- IPF. The PAL procedure supports the Static Registers calling\r
- convention. It could be called at physical mode.\r
-\r
- @param Index Index of PAL_CACHE_INIT within the list of PAL\r
- procedures.\r
- @param Level Unsigned 64-bit integer containing the level of\r
- cache to initialize. If the cache level can be\r
- initialized independently, only that level will\r
- be initialized. Otherwise\r
- implementation-dependent side-effects will\r
- occur.\r
- @param CacheType Unsigned 64-bit integer with a value of 1 to\r
- initialize the instruction cache, 2 to\r
- initialize the data cache, or 3 to\r
- initialize both. All other values are\r
- reserved.\r
- @param Restrict Unsigned 64-bit integer with a value of 0 or\r
- 1. All other values are reserved. If\r
- restrict is 1 and initializing the specified\r
- level and cache_type of the cache would\r
- cause side-effects, PAL_CACHE_INIT will\r
- return -4 instead of initializing the cache.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -4 Call could not initialize the specified\r
- level and cache_type of the cache without\r
- side-effects and restrict was 1.\r
-\r
-**/\r
-#define PAL_CACHE_INIT 3\r
-\r
-\r
-//\r
-// PAL_CACHE_PROTECTION.Method.\r
-//\r
-#define PAL_CACHE_PROTECTION_NONE_PROTECT 0\r
-#define PAL_CACHE_PROTECTION_ODD_PROTECT 1\r
-#define PAL_CACHE_PROTECTION_EVEN_PROTECT 2\r
-#define PAL_CACHE_PROTECTION_ECC_PROTECT 3\r
-\r
-\r
-\r
-//\r
-// PAL_CACHE_PROTECTION.TagOrData.\r
-//\r
-#define PAL_CACHE_PROTECTION_PROTECT_DATA 0\r
-#define PAL_CACHE_PROTECTION_PROTECT_TAG 1\r
-#define PAL_CACHE_PROTECTION_PROTECT_TAG_ANDTHEN_DATA 2\r
-#define PAL_CACHE_PROTECTION_PROTECT_DATA_ANDTHEN_TAG 3\r
-\r
-//\r
-// 32-bit protection information structures.\r
-//\r
-typedef struct {\r
- UINT32 DataBits:8;\r
- UINT32 TagProtLsb:6;\r
- UINT32 TagProtMsb:6;\r
- UINT32 ProtBits:6;\r
- UINT32 Method:4;\r
- UINT32 TagOrData:2;\r
-} PAL_CACHE_PROTECTION;\r
-\r
-/**\r
- PAL Procedure - PAL_CACHE_PROT_INFO.\r
-\r
- Return instruction or data cache protection information. It is\r
- required by IPF. The PAL procedure supports the Static\r
- Registers calling convention. It could be called at physical\r
- mode and Virtual mode.\r
-\r
- @param Index Index of PAL_CACHE_PROT_INFO within the list of\r
- PAL procedures.\r
- @param CacheLevel Unsigned 64-bit integer specifying the level\r
- in the cache hierarchy for which information\r
- is requested. This value must be between 0\r
- and one less than the value returned in the\r
- cache_levels return value from\r
- PAL_CACHE_SUMMARY.\r
- @param CacheType Unsigned 64-bit integer with a value of 1\r
- for instruction cache and 2 for data or\r
- unified cache. All other values are\r
- reserved.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Detail the characteristics of a given\r
- processor controlled cache in the cache\r
- hierarchy. See PAL_CACHE_PROTECTION[0..1].\r
- @return R10 Detail the characteristics of a given\r
- processor controlled cache in the cache\r
- hierarchy. See PAL_CACHE_PROTECTION[2..3].\r
- @return R11 Detail the characteristics of a given\r
- processor controlled cache in the cache\r
- hierarchy. See PAL_CACHE_PROTECTION[4..5].\r
-\r
-**/\r
-#define PAL_CACHE_PROT_INFO 38\r
-\r
-/**\r
-\r
- @param ThreadId The thread identifier of the logical\r
- processor for which information is being\r
- returned. This value will be unique on a per\r
- core basis.\r
-\r
- @param CoreId The core identifier of the logical processor\r
- for which information is being returned.\r
- This value will be unique on a per physical\r
- processor package basis.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 ThreadId : 16;\r
- UINT64 Reserved1: 16;\r
- UINT64 CoreId: 16;\r
- UINT64 Reserved2: 16;\r
-} PAL_PCOC_N_CACHE_INFO1;\r
-\r
-/**\r
-\r
- @param LogicalAddress Logical address: geographical address\r
- of the logical processor for which\r
- information is being returned. This is\r
- the same value that is returned by the\r
- PAL_FIXED_ADDR procedure when it is\r
- called on the logical processor.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 LogicalAddress : 16;\r
- UINT64 Reserved1: 16;\r
- UINT64 Reserved2: 32;\r
-} PAL_PCOC_N_CACHE_INFO2;\r
-\r
-/**\r
- PAL Procedure - PAL_CACHE_SHARED_INFO.\r
-\r
- Returns information on which logical processors share caches.\r
- It is optional. The PAL procedure supports the Static\r
- Registers calling convention. It could be called at physical\r
- mode and Virtual mode.\r
-\r
- @param Index Index of PAL_CACHE_SHARED_INFO within the list\r
- of PAL procedures.\r
- @param CacheLevel Unsigned 64-bit integer specifying the\r
- level in the cache hierarchy for which\r
- information is requested. This value must\r
- be between 0 and one less than the value\r
- returned in the cache_levels return value\r
- from PAL_CACHE_SUMMARY.\r
- @param CacheType Unsigned 64-bit integer with a value of 1\r
- for instruction cache and 2 for data or\r
- unified cache. All other values are\r
- reserved.\r
- @param ProcNumber Unsigned 64-bit integer that specifies for\r
- which logical processor information is\r
- being requested. This input argument must\r
- be zero for the first call to this\r
- procedure and can be a maximum value of\r
- one less than the number of logical\r
- processors sharing this cache, which is\r
- returned by the num_shared return value.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Unsigned integer that returns the number of\r
- logical processors that share the processor\r
- cache level and type, for which information was\r
- requested.\r
- @return R10 The format of PAL_PCOC_N_CACHE_INFO1.\r
- @return R11 The format of PAL_PCOC_N_CACHE_INFO2.\r
-\r
-**/\r
-#define PAL_CACHE_SHARED_INFO 43\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_CACHE_SUMMARY.\r
-\r
- Return a summary of the cache hierarchy. It is required by\r
- IPF. The PAL procedure supports the Static Registers calling\r
- convention. It could be called at physical mode and Virtual\r
- mode.\r
-\r
- @param Index Index of PAL_CACHE_SUMMARY within the list of\r
- PAL procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 CacheLevels Unsigned 64-bit integer denoting the\r
- number of levels of cache\r
- implemented by the processor.\r
- Strictly, this is the number of\r
- levels for which the cache\r
- controller is integrated into the\r
- processor (the cache SRAMs may be\r
- external to the processor).\r
- @return R10 UniqueCaches Unsigned 64-bit integer denoting the\r
- number of unique caches implemented\r
- by the processor. This has a maximum\r
- of 2*cache_levels, but may be less\r
- if any of the levels in the cache\r
- hierarchy are unified caches or do\r
- not have both instruction and data\r
- caches.\r
-\r
-**/\r
-#define PAL_CACHE_SUMMARY 4\r
-\r
-\r
-//\r
-// Virtual Memory Attributes implemented by processor.\r
-//\r
-#define PAL_MEMORY_ATTR_WB 0\r
-#define PAL_MEMORY_ATTR_WC 6\r
-#define PAL_MEMORY_ATTR_UC 4\r
-#define PAL_MEMORY_ATTR_UCE 5\r
-#define PAL_MEMORY_ATTR_NATPAGE 7\r
-\r
-/**\r
- PAL Procedure - PAL_MEM_ATTRIB.\r
-\r
- Return a list of supported memory attributes.. It is required\r
- by IPF. The PAL procedure supports the Static Registers calling\r
- convention. It could be called at physical mode and Virtual\r
- mode.\r
-\r
- @param Index Index of PAL_MEM_ATTRIB within the list of PAL\r
- procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Attributes 8-bit vector of memory attributes\r
- implemented by processor. See Virtual\r
- Memory Attributes above.\r
-\r
-**/\r
-\r
-#define PAL_MEM_ATTRIB 5\r
-\r
-/**\r
- PAL Procedure - PAL_PREFETCH_VISIBILITY.\r
-\r
- Used in architected sequence to transition pages from a\r
- cacheable, speculative attribute to an uncacheable attribute.\r
- It is required by IPF. The PAL procedure supports the Static\r
- Registers calling convention. It could be called at physical\r
- mode and Virtual mode.\r
-\r
- @param Index Index of PAL_PREFETCH_VISIBILITY within the list\r
- of PAL procedures.\r
- @param TransitionType Unsigned integer specifying the type\r
- of memory attribute transition that is\r
- being performed.\r
-\r
- @retval 1 Call completed without error; this\r
- call is not necessary on remote\r
- processors.\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
-**/\r
-#define PAL_PREFETCH_VISIBILITY 41\r
-\r
-/**\r
- PAL Procedure - PAL_PTCE_INFO.\r
-\r
- Return information needed for ptc.e instruction to purge\r
- entire TC. It is required by IPF. The PAL procedure supports\r
- the Static Registers calling convention. It could be called at\r
- physical mode and Virtual mode.\r
-\r
- @param Index Index of PAL_PTCE_INFO within the list\r
- of PAL procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Unsigned 64-bit integer denoting the beginning\r
- address to be used by the first PTCE instruction\r
- in the purge loop.\r
- @return R10 Two unsigned 32-bit integers denoting the loop\r
- counts of the outer (loop 1) and inner (loop 2)\r
- purge loops. count1 (loop 1) is contained in bits\r
- 63:32 of the parameter, and count2 (loop 2) is\r
- contained in bits 31:0 of the parameter.\r
- @return R11 Two unsigned 32-bit integers denoting the loop\r
- strides of the outer (loop 1) and inner (loop 2)\r
- purge loops. stride1 (loop 1) is contained in bits\r
- 63:32 of the parameter, and stride2 (loop 2) is\r
- contained in bits 31:0 of the parameter.\r
-\r
-**/\r
-#define PAL_PTCE_INFO 6\r
-\r
-\r
-\r
-/**\r
-\r
- @param NumberSets Unsigned 8-bit integer denoting the number\r
- of hash sets for the specified level\r
- (1=fully associative)\r
-\r
- @param NumberWays Unsigned 8-bit integer denoting the\r
- associativity of the specified level\r
- (1=direct).\r
-\r
- @param NumberEntries Unsigned 16-bit integer denoting the\r
- number of entries in the specified TC.\r
-\r
-\r
- @param PageSizeIsOptimized Flag denoting whether the\r
- specified level is optimized for\r
- the region's preferred page size\r
- (1=optimized) tc_pages indicates\r
- which page sizes are usable by\r
- this translation cache.\r
-\r
- @param TcIsUnified Flag denoting whether the specified TC is\r
- unified (1=unified).\r
-\r
- @param EntriesReduction Flag denoting whether installed\r
- translation registers will reduce\r
- the number of entries within the\r
- specified TC.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 NumberSets:8;\r
- UINT64 NumberWays:8;\r
- UINT64 NumberEntries:16;\r
- UINT64 PageSizeIsOptimized:1;\r
- UINT64 TcIsUnified:1;\r
- UINT64 EntriesReduction:1;\r
-} PAL_TC_INFO;\r
-\r
-/**\r
- PAL Procedure - PAL_VM_INFO.\r
-\r
- Return detailed information about virtual memory features\r
- supported in the processor. It is required by IPF. The PAL\r
- procedure supports the Static Registers calling convention. It\r
- could be called at physical mode and Virtual mode.\r
-\r
- @param Index Index of PAL_VM_INFO within the list\r
- of PAL procedures.\r
- @param TcLevel Unsigned 64-bit integer specifying the level\r
- in the TLB hierarchy for which information is\r
- required. This value must be between 0 and one\r
- less than the value returned in the\r
- vm_info_1.num_tc_levels return value from\r
- PAL_VM_SUMMARY.\r
- @param TcType Unsigned 64-bit integer with a value of 1 for\r
- instruction translation cache and 2 for data\r
- or unified translation cache. All other values\r
- are reserved.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 8-byte formatted value returning information\r
- about the specified TC. See PAL_TC_INFO above.\r
- @return R10 64-bit vector containing a bit for each page\r
- size supported in the specified TC, where bit\r
- position n indicates a page size of 2**n.\r
-\r
-**/\r
-#define PAL_VM_INFO 7\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_VM_PAGE_SIZE.\r
-\r
- Return virtual memory TC and hardware walker page sizes\r
- supported in the processor. It is required by IPF. The PAL\r
- procedure supports the Static Registers calling convention. It\r
- could be called at physical mode and Virtual mode.\r
-\r
- @param Index Index of PAL_VM_PAGE_SIZE within the list\r
- of PAL procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 64-bit vector containing a bit for each\r
- architected page size that is supported for\r
- TLB insertions and region registers.\r
- @return R10 64-bit vector containing a bit for each\r
- architected page size supported for TLB purge\r
- operations.\r
-\r
-**/\r
-#define PAL_VM_PAGE_SIZE 34\r
-\r
-/**\r
-\r
- @param WalkerPresent 1-bit flag indicating whether a hardware\r
- TLB walker is implemented (1 = walker\r
- present).\r
-\r
- @param WidthOfPhysicalAddress Unsigned 7-bit integer\r
- denoting the number of bits of\r
- physical address implemented.\r
-\r
- @param WidthOfKey Unsigned 8-bit integer denoting the number\r
- of bits mplemented in the PKR.key field.\r
-\r
- @param MaxPkrIndex Unsigned 8-bit integer denoting the\r
- maximum PKR index (number of PKRs-1).\r
-\r
- @param HashTagId Unsigned 8-bit integer which uniquely\r
- identifies the processor hash and tag\r
- algorithm.\r
-\r
- @param MaxDtrIndex Unsigned 8 bit integer denoting the\r
- maximum data translation register index\r
- (number of dtr entries - 1).\r
-\r
- @param MaxItrIndex Unsigned 8 bit integer denoting the\r
- maximum instruction translation register\r
- index (number of itr entries - 1).\r
-\r
- @param NumberOfUniqueTc Unsigned 8-bit integer denoting the\r
- number of unique TCs implemented.\r
- This is a maximum of\r
- 2*num_tc_levels.\r
-\r
- @param NumberOfTcLevels Unsigned 8-bit integer denoting the\r
- number of TC levels.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 WalkerPresent:1;\r
- UINT64 WidthOfPhysicalAddress: 7;\r
- UINT64 WidthOfKey:8;\r
- UINT64 MaxPkrIndex:8;\r
- UINT64 HashTagId:8;\r
- UINT64 MaxDtrIndex:8;\r
- UINT64 MaxItrIndex:8;\r
- UINT64 NumberOfUniqueTc:8;\r
- UINT64 NumberOfTcLevels:8;\r
-} PAL_VM_INFO1;\r
-\r
-/**\r
-\r
- @param WidthOfVirtualAddress Unsigned 8-bit integer denoting\r
- is the total number of virtual\r
- address bits - 1.\r
-\r
- @param WidthOfRid Unsigned 8-bit integer denoting the number\r
- of bits implemented in the RR.rid field.\r
-\r
- @param MaxPurgedTlbs Unsigned 16 bit integer denoting the\r
- maximum number of concurrent outstanding\r
- TLB purges allowed by the processor. A\r
- value of 0 indicates one outstanding\r
- purge allowed. A value of 216-1\r
- indicates no limit on outstanding\r
- purges. All other values indicate the\r
- actual number of concurrent outstanding\r
- purges allowed.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 WidthOfVirtualAddress:8;\r
- UINT64 WidthOfRid:8;\r
- UINT64 MaxPurgedTlbs:16;\r
- UINT64 Reserved:32;\r
-} PAL_VM_INFO2;\r
-\r
-/**\r
- PAL Procedure - PAL_VM_SUMMARY.\r
-\r
- Return summary information about virtual memory features\r
- supported in the processor. It is required by IPF. The PAL\r
- procedure supports the Static Registers calling convention. It\r
- could be called at physical mode and Virtual mode.\r
-\r
- @param Index Index of PAL_VM_SUMMARY within the list\r
- of PAL procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 8-byte formatted value returning global virtual\r
- memory information. See PAL_VM_INFO1 above.\r
- @return R10 8-byte formatted value returning global virtual\r
- memory information. See PAL_VM_INFO2 above.\r
-\r
-**/\r
-#define PAL_VM_SUMMARY 8\r
-\r
-\r
-//\r
-// Bit mask of TR_valid flag.\r
-//\r
-#define PAL_TR_ACCESS_RIGHT_IS_VALID BIT0\r
-#define PAL_TR_PRIVILEGE_LEVEL_IS_VALID BIT1\r
-#define PAL_TR_DIRTY_IS_VALID BIT2\r
-#define PAL_TR_MEMORY_ATTR_IS_VALID BIT3\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_VM_TR_READ.\r
-\r
- Read contents of a translation register. It is required by\r
- IPF. The PAL procedure supports the Stacked Register calling\r
- convention. It could be called at physical mode.\r
-\r
- @param Index Index of PAL_VM_TR_READ within the list\r
- of PAL procedures.\r
- @param RegNumber Unsigned 64-bit number denoting which TR to\r
- read.\r
- @param TrType Unsigned 64-bit number denoting whether to\r
- read an ITR (0) or DTR (1). All other values\r
- are reserved.\r
- @param TrBuffer 64-bit pointer to the 32-byte memory buffer in\r
- which translation data is returned.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Formatted bit vector denoting which fields are\r
- valid. See TR_valid above.\r
-\r
-**/\r
-#define PAL_VM_TR_READ 261\r
-\r
-\r
-\r
-\r
-//\r
-// Bit Mask of Processor Bus Fesatures .\r
-//\r
-\r
-/**\r
-\r
- When 0, bus data errors are detected and single bit errors are\r
- corrected. When 1, no error detection or correction is done.\r
-\r
-**/\r
-#define PAL_BUS_DISABLE_DATA_ERROR_SIGNALLING BIT63\r
-\r
-\r
-/**\r
-\r
- When 0, bus address errors are signalled on the bus. When 1,\r
- no bus errors are signalled on the bus. If Disable Bus Address\r
- Error Checking is 1, this bit is ignored.\r
-\r
-**/\r
-#define PAL_BUS_DISABLE_ADDRESS_ERROR_SIGNALLING BIT62\r
-\r
-\r
-\r
-\r
-/**\r
-\r
- When 0, bus errors are detected, single bit errors are\r
- corrected., and a CMCI or MCA is generated internally to the\r
- processor. When 1, no bus address errors are detected or\r
- corrected.\r
-\r
-**/\r
-#define PAL_BUS_DISABLE_ADDRESS_ERROR_CHECK BIT61\r
-\r
-\r
-/**\r
-\r
- When 0, bus protocol errors (BINIT#) are signaled by the\r
- processor on the bus. When 1, bus protocol errors (BINIT#) are\r
- not signaled on the bus. If Disable Bus Initialization Event\r
- Checking is 1, this bit is ignored.\r
-\r
-**/\r
-#define PAL_BUS_DISABLE_INITIALIZATION_EVENT_SIGNALLING BIT60\r
-\r
-\r
-/**\r
-\r
- When 0, bus protocol errors (BINIT#) are detected and sampled\r
- and an MCA is generated internally to the processor. When 1,\r
- the processor will ignore bus protocol error conditions\r
- (BINIT#).\r
-\r
-**/\r
-#define PAL_BUS_DISABLE_INITIALIZATION_EVENT_CHECK BIT59\r
-\r
-\r
-\r
-/**\r
-\r
- When 0, BERR# is signalled if a bus error is detected. When 1,\r
- bus errors are not signalled on the bus.\r
-\r
-**/\r
-#define PAL_BUS_DISABLE_ERROR_SIGNALLING BIT58\r
-\r
-\r
-\r
-\r
-/**\r
-\r
- When 0, BERR# is signalled when internal processor requestor\r
- initiated bus errors are detected. When 1, internal requester\r
- bus errors are not signalled on the bus.\r
-\r
-**/\r
-#define PAL_BUS_DISABLE__INTERNAL_ERROR_SIGNALLING BIT57\r
-\r
-\r
-/**\r
-\r
- When 0, the processor takes an MCA if BERR# is asserted. When\r
- 1, the processor ignores the BERR# signal.\r
-\r
-**/\r
-#define PAL_BUS_DISABLE_ERROR_CHECK BIT56\r
-\r
-\r
-/**\r
-\r
- When 0, the processor asserts BINIT# if it detects a parity\r
- error on the signals which identify the transactions to which\r
- this is a response. When 1, the processor ignores parity on\r
- these signals.\r
-\r
-**/\r
-#define PAL_BUS_DISABLE_RSP_ERROR_CHECK BIT55\r
-\r
-\r
-/**\r
-\r
- When 0, the in-order transaction queue is limited only by the\r
- number of hardware entries. When 1, the processor's in-order\r
- transactions queue is limited to one entry.\r
-\r
-**/\r
-#define PAL_BUS_DISABLE_TRANSACTION_QUEUE BIT54\r
-\r
-/**\r
-\r
- Enable a bus cache line replacement transaction when a cache\r
- line in the exclusive state is replaced from the highest level\r
- processor cache and is not present in the lower level processor\r
- caches. When 0, no bus cache line replacement transaction will\r
- be seen on the bus. When 1, bus cache line replacement\r
- transactions will be seen on the bus when the above condition is\r
- detected.\r
-\r
-**/\r
-#define PAL_BUS_ENABLE_EXCLUSIVE_CACHE_LINE_REPLACEMENT BIT53\r
-\r
-\r
-/**\r
-\r
- Enable a bus cache line replacement transaction when a cache\r
- line in the shared or exclusive state is replaced from the\r
- highest level processor cache and is not present in the lower\r
- level processor caches.\r
- When 0, no bus cache line replacement transaction will be seen\r
- on the bus. When 1, bus cache line replacement transactions\r
- will be seen on the bus when the above condition is detected.\r
-\r
-**/\r
-#define PAL_BUS_ENABLE_SHARED_CACHE_LINE_REPLACEMENT BIT52\r
-\r
-\r
-\r
-/**\r
-\r
- When 0, the data bus is configured at the 2x data transfer\r
- rate.When 1, the data bus is configured at the 1x data\r
- transfer rate, 30 Opt. Req. Disable Bus Lock Mask. When 0, the\r
- processor executes locked transactions atomically. When 1, the\r
- processor masks the bus lock signal and executes locked\r
- transactions as a non-atomic series of transactions.\r
-\r
-**/\r
-#define PAL_BUS_ENABLE_HALF_TRANSFER BIT30\r
-\r
-/**\r
-\r
- When 0, the processor will deassert bus request when finished\r
- with each transaction. When 1, the processor will continue to\r
- assert bus request after it has finished, if it was the last\r
- agent to own the bus and if there are no other pending\r
- requests.\r
-\r
-**/\r
-#define PAL_BUS_REQUEST_BUS_PARKING BIT29\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_BUS_GET_FEATURES.\r
-\r
- Return configurable processor bus interface features and their\r
- current settings. It is required by IPF. The PAL procedure\r
- supports the Stacked Register calling convention. It could be\r
- called at physical mode.\r
-\r
- @param Index Index of PAL_BUS_GET_FEATURES within the list\r
- of PAL procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 64-bit vector of features implemented.\r
- (1=implemented, 0=not implemented)\r
- @return R10 64-bit vector of current feature settings.\r
- @return R11 64-bit vector of features controllable by\r
- software. (1=controllable, 0= not controllable)\r
-\r
-**/\r
-#define PAL_BUS_GET_FEATURES 9\r
-\r
-/**\r
- PAL Procedure - PAL_BUS_SET_FEATURES.\r
-\r
- Enable or disable configurable features in processor bus\r
- interface. It is required by IPF. It is required by IPF. The PAL procedure\r
- supports the Static Registers calling convention. It could be\r
- called at physical mode.\r
-\r
- @param Index Index of PAL_BUS_SET_FEATURES within the list\r
- of PAL procedures.\r
- @param FeatureSelect 64-bit vector denoting desired state of\r
- each feature (1=select, 0=non-select).\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
-**/\r
-#define PAL_BUS_SET_FEATURES 10\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_DEBUG_INFO.\r
-\r
- Return the number of instruction and data breakpoint\r
- registers. It is required by IPF. It is required by IPF. The\r
- PAL procedure supports the Static Registers calling\r
- convention. It could be called at physical mode and virtual\r
- mode.\r
-\r
- @param Index Index of PAL_DEBUG_INFO within the list of PAL\r
- procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Unsigned 64-bit integer denoting the number of\r
- pairs of instruction debug registers implemented\r
- by the processor.\r
- @return R10 Unsigned 64-bit integer denoting the number of\r
- pairs of data debug registers implemented by the\r
- processor.\r
-\r
-**/\r
-#define PAL_DEBUG_INFO 11\r
-\r
-/**\r
- PAL Procedure - PAL_FIXED_ADDR.\r
-\r
- Return the fixed component of a processor's directed address.\r
- It is required by IPF. It is required by IPF. The PAL\r
- procedure supports the Static Registers calling convention. It\r
- could be called at physical mode and virtual mode.\r
-\r
- @param Index Index of PAL_FIXED_ADDR within the list of PAL\r
- procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Fixed geographical address of this processor.\r
-\r
-**/\r
-#define PAL_FIXED_ADDR 12\r
-\r
-/**\r
- PAL Procedure - PAL_FREQ_BASE.\r
-\r
- Return the frequency of the output clock for use by the\r
- platform, if generated by the processor. It is optinal. The\r
- PAL procedure supports the Static Registers calling\r
- convention. It could be called at physical mode and virtual\r
- mode.\r
-\r
- @param Index Index of PAL_FREQ_BASE within the list of PAL\r
- procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Base frequency of the platform if generated by the\r
- processor chip.\r
-\r
-**/\r
-#define PAL_FREQ_BASE 13\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_FREQ_RATIOS.\r
-\r
- Return ratio of processor, bus, and interval time counter to\r
- processor input clock or output clock for platform use, if\r
- generated by the processor. It is required by IPF. The PAL\r
- procedure supports the Static Registers calling convention. It\r
- could be called at physical mode and virtual mode.\r
-\r
- @param Index Index of PAL_FREQ_RATIOS within the list of PAL\r
- procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Ratio of the processor frequency to the input\r
- clock of the processor, if the platform clock is\r
- generated externally or to the output clock to the\r
- platform, if the platform clock is generated by\r
- the processor.\r
- @return R10 Ratio of the bus frequency to the input clock of\r
- the processor, if the platform clock is generated\r
- externally or to the output clock to the platform,\r
- if the platform clock is generated by the\r
- processor.\r
- @return R11 Ratio of the interval timer counter rate to input\r
- clock of the processor, if the platform clock is\r
- generated externally or to the output clock to the\r
- platform, if the platform clock is generated by\r
- the processor.\r
-\r
-**/\r
-#define PAL_FREQ_RATIOS 14\r
-\r
-/**\r
-\r
- @param NumberOfLogicalProcessors Total number of logical\r
- processors on this physical\r
- processor package that are\r
- enabled.\r
-\r
- @param ThreadsPerCore Number of threads per core.\r
-\r
- @param CoresPerProcessor Total number of cores on this\r
- physical processor package.\r
-\r
- @param PhysicalProcessorPackageId Physical processor package\r
- identifier which was\r
- assigned at reset by the\r
- platform or bus\r
- controller. This value may\r
- or may not be unique\r
- across the entire platform\r
- since it depends on the\r
- platform vendor's policy.\r
-**/\r
-typedef struct {\r
- UINT64 NumberOfLogicalProcessors:16;\r
- UINT64 ThreadsPerCore:8;\r
- UINT64 Reserved1:8;\r
- UINT64 CoresPerProcessor;\r
- UINT64 Reserved2:8;\r
- UINT64 PhysicalProcessorPackageId:8;\r
- UINT64 Reserved3:8;\r
-} PAL_LOGICAL_PROCESSPR_OVERVIEW;\r
-\r
-/**\r
-\r
- @param ThreadId The thread identifier of the logical\r
- processor for which information is being\r
- returned. This value will be unique on a per\r
- core basis.\r
-\r
- @param CoreId The core identifier of the logical processor\r
- for which information is being returned.\r
- This value will be unique on a per physical\r
- processor package basis.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 ThreadId:16;\r
- UINT64 Reserved1:16;\r
- UINT64 CoreId:16;\r
- UINT64 Reserved2:16;\r
-} PAL_LOGICAL_PROCESSORN_INFO1;\r
-\r
-\r
-/**\r
-\r
- @param LogicalAddress Geographical address of the logical\r
- processor for which information is being\r
- returned. This is the same value that is\r
- returned by the PAL_FIXED_ADDR procedure\r
- when it is called on the logical\r
- processor.\r
-\r
-\r
-**/\r
-typedef struct {\r
- UINT64 LogicalAddress:16;\r
- UINT64 Reserved:48;\r
-} PAL_LOGICAL_PROCESSORN_INFO2;\r
-\r
-/**\r
- PAL Procedure - PAL_LOGICAL_TO_PHYSICAL.\r
-\r
- Return information on which logical processors map to a\r
- physical processor die. It is optinal. The PAL procedure\r
- supports the Static Registers calling convention. It could be\r
- called at physical mode and virtual mode.\r
-\r
- @param Index Index of PAL_LOGICAL_TO_PHYSICAL within the list of PAL\r
- procedures.\r
- @param ProcessorNumber Signed 64-bit integer that specifies\r
- for which logical processor\r
- information is being requested. When\r
- this input argument is -1, information\r
- is returned about the logical\r
- processor on which the procedure call\r
- is made. This input argument must be\r
- in the range of 1 up to one less than\r
- the number of logical processors\r
- returned by num_log in the\r
- log_overview return value.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 The format of PAL_LOGICAL_PROCESSPR_OVERVIEW.\r
- @return R10 The format of PAL_LOGICAL_PROCESSORN_INFO1.\r
- @return R11 The format of PAL_LOGICAL_PROCESSORN_INFO2.\r
-\r
-**/\r
-#define PAL_LOGICAL_TO_PHYSICAL 42\r
-\r
-\r
-/**\r
-\r
- @param NumberOfPmcPairs Unsigned 8-bit number defining the\r
- number of generic PMC/PMD pairs.\r
-\r
- @param WidthOfCounter Unsigned 8-bit number in the range\r
- 0:60 defining the number of\r
- implemented counter bits.\r
-\r
- @param TypeOfCycleCounting Unsigned 8-bit number defining the\r
- event type for counting processor\r
- cycles.\r
-\r
-\r
- @param TypeOfRetiredInstructionBundle Retired Unsigned 8-bit\r
- number defining the\r
- event type for retired\r
- instruction bundles.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 NumberOfPmcPairs:8;\r
- UINT64 WidthOfCounter:8;\r
- UINT64 TypeOfCycleCounting:8;\r
- UINT64 TypeOfRetiredInstructionBundle:8;\r
- UINT64 Reserved:32;\r
-} PAL_PERFORMANCE_INFO;\r
-\r
-/**\r
- PAL Procedure - PAL_PERF_MON_INFO.\r
-\r
- Return the number and type of performance monitors. It is\r
- required by IPF. The PAL procedure supports the Static\r
- Registers calling convention. It could be called at physical\r
- mode and virtual mode.\r
-\r
- @param Index Index of PAL_PERF_MON_INFO within the list of\r
- PAL procedures.\r
- @param PerformanceBuffer An address to an 8-byte aligned\r
- 128-byte memory buffer.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Information about the performance monitors\r
- implemented. See PAL_PERFORMANCE_INFO;\r
-\r
-**/\r
-#define PAL_PERF_MON_INFO 15\r
-\r
-#define PAL_PLATFORM_ADDR_INTERRUPT_BLOCK_TOKEN 0x0\r
-#define PAL_PLATFORM_ADDR_IO_BLOCK_TOKEN 0x1\r
-\r
-/**\r
- PAL Procedure - PAL_PLATFORM_ADDR.\r
-\r
- Specify processor interrupt block address and I/O port space\r
- address. It is required by IPF. The PAL procedure supports the\r
- Static Registers calling convention. It could be called at\r
- physical mode and virtual mode.\r
-\r
- @param Index Index of PAL_PLATFORM_ADDR within the list of\r
- PAL procedures.\r
- @param Type Unsigned 64-bit integer specifying the type of\r
- block. 0 indicates that the processor interrupt\r
- block pointer should be initialized. 1 indicates\r
- that the processor I/O block pointer should be\r
- initialized.\r
- @param Address Unsigned 64-bit integer specifying the address\r
- to which the processor I/O block or interrupt\r
- block shall be set. The address must specify\r
- an implemented physical address on the\r
- processor model, bit 63 is ignored.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure.\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
-**/\r
-#define PAL_PLATFORM_ADDR 16\r
-\r
-\r
-/**\r
-\r
- @param EnableBerrPromotion Bit63. Enable BERR promotion. When\r
- 1, the Bus Error (BERR) signal is\r
- promoted to the Bus Initialization\r
- (BINIT) signal, and the BINIT pin\r
- is asserted on the occurrence of\r
- each Bus Error. Setting this bit\r
- has no effect if BINIT signalling\r
- is disabled. (See\r
- PAL_BUS_GET/SET_FEATURES)\r
-\r
- @param EnableMcaPromotion Bit62, Enable MCA promotion. When\r
- 1, machine check aborts (MCAs) are\r
- promoted to the Bus Error signal,\r
- and the BERR pin is assert on each\r
- occurrence of an MCA. Setting this\r
- bit has no effect if BERR\r
- signalling is disabled. (See\r
- PAL_BUS_GET/SET_FEATURES)\r
-\r
- @param EnableMcaToBinitPromotion Bit61, Enable MCA to BINIT\r
- promotion. When 1, machine\r
- check aborts (MCAs) are\r
- promoted to the Bus\r
- Initialization signal, and\r
- the BINIT pin is assert on\r
- each occurrence of an MCA.\r
- Setting this bit has no\r
- effect if BINIT signalling\r
- is disabled. (See\r
- PAL_BUS_GET/SET_FEATURES)\r
-\r
- @param EnableCmciPromotion Bit60, Enable CMCI promotion When\r
- 1, Corrected Machine Check\r
- Interrupts (CMCI) are promoted to\r
- MCAs. They are also further\r
- promoted to BERR if bit 39, Enable\r
- MCA promotion, is also set and\r
- they are promoted to BINIT if bit\r
- 38, Enable MCA to BINIT promotion,\r
- is also set. This bit has no\r
- effect if MCA signalling is\r
- disabled (see\r
- PAL_BUS_GET/SET_FEATURES)\r
-\r
- @param DisableCache Bit59, Disable Cache. When 0, the\r
- processor performs cast outs on\r
- cacheable pages and issues and responds\r
- to coherency requests normally. When 1,\r
- the processor performs a memory access\r
- for each reference regardless of cache\r
- contents and issues no coherence\r
- requests and responds as if the line\r
- were not present. Cache contents cannot\r
- be relied upon when the cache is\r
- disabled. WARNING: Semaphore\r
- instructions may not be atomic or may\r
- cause Unsupported Data Reference faults\r
- if caches are disabled.\r
-\r
- @param DisableCoherency Bit58, Disable Coherency. When 0,\r
- the processor uses normal coherency\r
- requests and responses. When 1, the\r
- processor answers all requests as if\r
- the line were not present.\r
-\r
- @param DisableDPM Bit57, Disable Dynamic Power Management\r
- (DPM). When 0, the hardware may reduce\r
- power consumption by removing the clock\r
- input from idle functional units. When 1,\r
- all functional units will receive clock\r
- input, even when idle.\r
-\r
- @param DisableBinitWithTimeout Bit56, Disable a BINIT on\r
- internal processor time-out.\r
- When 0, the processor may\r
- generate a BINIT on an\r
- internal processor time-out.\r
- When 1, the processor will not\r
- generate a BINIT on an\r
- internal processor time-out.\r
- The event is silently ignored.\r
-\r
-\r
- @param EnableEnvNotification Bit55, Enable external\r
- notification when the processor\r
- detects hardware errors caused\r
- by environmental factors that\r
- could cause loss of\r
- deterministic behavior of the\r
- processor. When 1, this bit will\r
- enable external notification,\r
- when 0 external notification is\r
- not provided. The type of\r
- external notification of these\r
- errors is processor-dependent. A\r
- loss of processor deterministic\r
- behavior is considered to have\r
- occurred if these\r
- environmentally induced errors\r
- cause the processor to deviate\r
- from its normal execution and\r
- eventually causes different\r
- behavior which can be observed\r
- at the processor bus pins.\r
- Processor errors that do not\r
- have this effects (i.e.,\r
- software induced machine checks)\r
- may or may not be promoted\r
- depending on the processor\r
- implementation.\r
-\r
- @param EnableVmsw Bit54, Enable the use of the vmsw\r
- instruction. When 0, the vmsw instruction\r
- causes a Virtualization fault when\r
- executed at the most privileged level.\r
- When 1, this bit will enable normal\r
- operation of the vmsw instruction.\r
-\r
- @param EnableMcaOnDataPoisoning Bit53, Enable MCA signaling\r
- on data-poisoning event\r
- detection. When 0, a CMCI\r
- will be signaled on error\r
- detection. When 1, an MCA\r
- will be signaled on error\r
- detection. If this feature\r
- is not supported, then the\r
- corresponding argument is\r
- ignored when calling\r
- PAL_PROC_SET_FEATURES. Note\r
- that the functionality of\r
- this bit is independent of\r
- the setting in bit 60\r
- (Enable CMCI promotion), and\r
- that the bit 60 setting does\r
- not affect CMCI signaling\r
- for data-poisoning related\r
- events. Volume 2: Processor\r
- Abstraction Layer 2:431\r
- PAL_PROC_GET_FEATURES\r
-\r
- @param DisablePState Bit52, Disable P-states. When 1, the PAL\r
- P-state procedures (PAL_PSTATE_INFO,\r
- PAL_SET_PSTATE, PAL_GET_PSTATE) will\r
- return with a status of -1\r
- (Unimplemented procedure).\r
-\r
- @param DisableBranchPrediction Bit47, Disable Dynamic branch\r
- prediction. When 0, the\r
- processor may predict branch\r
- targets and speculatively\r
- execute, but may not commit\r
- results. When 1, the processor\r
- must wait until branch targets\r
- are known to execute.\r
-\r
- @param DisableDynamicInsCachePrefetch Bit46, Disable\r
- DynamicInstruction Cache\r
- Prefetch. When 0, the\r
- processor may prefetch\r
- into the caches any\r
- instruction which has\r
- not been executed, but\r
- whose execution is\r
- likely. When 1,\r
- instructions may not be\r
- fetched until needed or\r
- hinted for execution.\r
- (Prefetch for a hinted\r
- branch is allowed even\r
- when dynamic instruction\r
- cache prefetch is\r
- disabled.)\r
-\r
- @param DisableDynamicDataCachePrefetch Bit45, Disable Dynamic\r
- Data Cache Prefetch.\r
- When 0, the processor\r
- may prefetch into the\r
- caches any data which\r
- has not been accessed\r
- by instruction\r
- execution, but which\r
- is likely to be\r
- accessed. When 1, no\r
- data may be fetched\r
- until it is needed for\r
- instruction execution\r
- or is fetched by an\r
- lfetch instruction.\r
-\r
- @param DisableSpontaneousDeferral Bit44, Disable Spontaneous\r
- Deferral. When 1, the\r
- processor may optionally\r
- defer speculative loads\r
- that do not encounter any\r
- exception conditions, but\r
- that trigger other\r
- implementation-dependent\r
- conditions (e.g., cache\r
- miss). When 0, spontaneous\r
- deferral is disabled.\r
-\r
- @param DisableDynamicPrediction Bit43, Disable Dynamic\r
- Predicate Prediction. When\r
- 0, the processor may predict\r
- predicate results and\r
- execute speculatively, but\r
- may not commit results until\r
- the actual predicates are\r
- known. When 1, the processor\r
- shall not execute predicated\r
- instructions until the\r
- actual predicates are known.\r
-\r
- @param NoXr1ThroughXr3 Bit42, No XR1 through XR3 implemented.\r
- Denotes whether XR1 XR3 are\r
- implemented for machine check\r
- recovery. This feature may only be\r
- interrogated by PAL_PROC_GET_FEATURES.\r
- It may not be enabled or disabled by\r
- PAL_PROC_SET_FEATURES. The\r
- corresponding argument is ignored.\r
-\r
- @param NoXipXpsrXfs Bit41, No XIP, XPSR, and XFS\r
- implemented. Denotes whether XIP, XPSR,\r
- and XFS are implemented for machine\r
- check recovery. This feature may only be\r
- interrogated by PAL_PROC_GET_FEATURES.\r
- It may not be enabled or disabled by\r
- PAL_PROC_SET_FEATURES. The corresponding\r
- argument is ignored.\r
-\r
- @param NoVM Bit40, No Virtual Machine features implemented.\r
- Denotes whether PSR.vm is implemented. This\r
- feature may only be interrogated by\r
- PAL_PROC_GET_FEATURES. It may not be enabled or\r
- disabled by PAL_PROC_SET_FEATURES. The\r
- corresponding argument is ignored.\r
-\r
- @param NoVariablePState Bit39, No Variable P-state\r
- performance: A value of 1, indicates\r
- that a processor implements\r
- techniques to optimize performance\r
- for the given P-state power budget\r
- by dynamically varying the\r
- frequency, such that maximum\r
- performance is achieved for the\r
- power budget. A value of 0,\r
- indicates that P-states have no\r
- frequency variation or very small\r
- frequency variations for their given\r
- power budget. This feature may only\r
- be interrogated by\r
- PAL_PROC_GET_FEATURES. it may not be\r
- enabled or disabled by\r
- PAL_PROC_SET_FEATURES. The\r
- corresponding argument is ignored.\r
-\r
-\r
- @param NoSimpleImpInUndefinedIns Bit38, No Simple\r
- implementation of\r
- unimplemented instruction\r
- addresses. Denotes how an\r
- unimplemented instruction\r
- address is recorded in IIP\r
- on an Unimplemented\r
- Instruction Address trap or\r
- fault. When 1, the full\r
- unimplemented address is\r
- recorded in IIP; when 0, the\r
- address is sign extended\r
- (virtual addresses) or zero\r
- extended (physical\r
- addresses). This feature may\r
- only be interrogated by\r
- PAL_PROC_GET_FEATURES. It\r
- may not be enabled or\r
- disabled by\r
- PAL_PROC_SET_FEATURES. The\r
- corresponding argument is\r
- ignored.\r
-\r
- @param NoPresentPmi Bit37, No INIT, PMI, and LINT pins\r
- present. Denotes the absence of INIT,\r
- PMI, LINT0 and LINT1 pins on the\r
- processor. When 1, the pins are absent.\r
- When 0, the pins are present. This\r
- feature may only be interrogated by\r
- PAL_PROC_GET_FEATURES. It may not be\r
- enabled or disabled by\r
- PAL_PROC_SET_FEATURES. The corresponding\r
- argument is ignored.\r
-\r
- @param FaultInUndefinedIns Bit36, No Unimplemented\r
- instruction address reported as\r
- fault. Denotes how the processor\r
- reports the detection of\r
- unimplemented instruction\r
- addresses. When 1, the processor\r
- reports an Unimplemented\r
- Instruction Address fault on the\r
- unimplemented address; when 0, it\r
- reports an Unimplemented\r
- Instruction Address trap on the\r
- previous instruction in program\r
- order. This feature may only be\r
- interrogated by\r
- PAL_PROC_GET_FEATURES. It may not\r
- be enabled or disabled by\r
- PAL_PROC_SET_FEATURES. The\r
- corresponding argument is\r
- ignored.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 Reserved1:36;\r
- UINT64 FaultInUndefinedIns:1;\r
- UINT64 NoPresentPmi:1;\r
- UINT64 NoSimpleImpInUndefinedIns:1;\r
- UINT64 NoVariablePState:1;\r
- UINT64 NoVM:1;\r
- UINT64 NoXipXpsrXfs:1;\r
- UINT64 NoXr1ThroughXr3:1;\r
- UINT64 DisableDynamicPrediction:1;\r
- UINT64 DisableSpontaneousDeferral:1;\r
- UINT64 DisableDynamicDataCachePrefetch:1;\r
- UINT64 DisableDynamicInsCachePrefetch:1;\r
- UINT64 DisableBranchPrediction:1;\r
- UINT64 Reserved2:4;\r
- UINT64 DisablePState:1;\r
- UINT64 EnableMcaOnDataPoisoning:1;\r
- UINT64 EnableVmsw:1;\r
- UINT64 EnableEnvNotification:1;\r
- UINT64 DisableBinitWithTimeout:1;\r
- UINT64 DisableDPM:1;\r
- UINT64 DisableCoherency:1;\r
- UINT64 DisableCache:1;\r
- UINT64 EnableCmciPromotion:1;\r
- UINT64 EnableMcaToBinitPromotion:1;\r
- UINT64 EnableMcaPromotion:1;\r
- UINT64 EnableBerrPromotion:1;\r
-} PAL_PROCESSOR_FEATURES;\r
-\r
-/**\r
- PAL Procedure - PAL_PROC_GET_FEATURES.\r
-\r
- Return configurable processor features and their current\r
- setting. It is required by IPF. The PAL procedure supports the\r
- Static Registers calling convention. It could be called at\r
- physical mode and virtual mode.\r
-\r
- @param Index Index of PAL_PROC_GET_FEATURES within the list of\r
- PAL procedures.\r
- @param Reserved Reserved parameter.\r
- @param FeatureSet Feature set information is being requested\r
- for.\r
-\r
- @retval 1 Call completed without error; The\r
- feature_set passed is not supported but a\r
- feature_set of a larger value is supported.\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -8 feature_set passed is beyond the maximum\r
- feature_set supported\r
-\r
- @return R9 64-bit vector of features implemented. See\r
- PAL_PROCESSOR_FEATURES.\r
- @return R10 64-bit vector of current feature settings. See\r
- PAL_PROCESSOR_FEATURES.\r
- @return R11 64-bit vector of features controllable by\r
- software.\r
-\r
-**/\r
-#define PAL_PROC_GET_FEATURES 17\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_PROC_SET_FEATURES.\r
-\r
- Enable or disable configurable processor features. It is\r
- required by IPF. The PAL procedure supports the Static\r
- Registers calling convention. It could be called at physical\r
- mode.\r
-\r
- @param Index Index of PAL_PROC_SET_FEATURES within the list of\r
- PAL procedures.\r
- @param FeatureSelect 64-bit vector denoting desired state of\r
- each feature (1=select, 0=non-select).\r
- @param FeatureSet Feature set to apply changes to. See\r
- PAL_PROC_GET_FEATURES for more information\r
- on feature sets.\r
-\r
- @retval 1 Call completed without error; The\r
- feature_set passed is not supported but a\r
- feature_set of a larger value is supported\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -8 feature_set passed is beyond the maximum\r
- feature_set supported\r
-\r
-**/\r
-#define PAL_PROC_SET_FEATURES 18\r
-\r
-\r
-//\r
-// Value of PAL_REGISTER_INFO.InfoRequest.\r
-//\r
-#define PAL_APPLICATION_REGISTER_IMPLEMENTED 0\r
-#define PAL_APPLICATION_REGISTER_READABLE 1\r
-#define PAL_CONTROL_REGISTER_IMPLEMENTED 2\r
-#define PAL_CONTROL_REGISTER_READABLE 3\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_REGISTER_INFO.\r
-\r
- Return AR and CR register information. It is required by IPF.\r
- The PAL procedure supports the Static Registers calling\r
- convention. It could be called at physical mode and virtual\r
- mode.\r
-\r
- @param Index Index of PAL_REGISTER_INFO within the list of\r
- PAL procedures.\r
- @param InfoRequest Unsigned 64-bit integer denoting what\r
- register information is requested. See\r
- PAL_REGISTER_INFO.InfoRequest above.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 64-bit vector denoting information for registers\r
- 0-63. Bit 0 is register 0, bit 63 is register 63.\r
- @return R10 64-bit vector denoting information for registers\r
- 64-127. Bit 0 is register 64, bit 63 is register\r
- 127.\r
-\r
-**/\r
-#define PAL_REGISTER_INFO 39\r
-\r
-/**\r
- PAL Procedure - PAL_RSE_INFO.\r
-\r
- Return RSE information. It is required by IPF. The PAL\r
- procedure supports the Static Registers calling convention. It\r
- could be called at physical mode and virtual mode.\r
-\r
- @param Index Index of PAL_RSE_INFO within the list of\r
- PAL procedures.\r
- @param InfoRequest Unsigned 64-bit integer denoting what\r
- register information is requested. See\r
- PAL_REGISTER_INFO.InfoRequest above.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Number of physical stacked general registers.\r
- @return R10 RSE hints supported by processor.\r
-\r
-**/\r
-#define PAL_RSE_INFO 19\r
-\r
-/**\r
-\r
- @param VersionOfPalB Is a 16-bit binary coded decimal (BCD)\r
- number that provides identification\r
- information about the PAL_B firmware.\r
-\r
- @param PalVendor Is an unsigned 8-bit integer indicating the\r
- vendor of the PAL code.\r
-\r
- @param VersionOfPalB Is a 16-bit binary coded decimal (BCD)\r
- number that provides identification\r
- information about the PAL_A firmware. In\r
- the split PAL_A model, this return value\r
- is the version number of the\r
- processor-specific PAL_A. The generic\r
- PAL_A version is not returned by this\r
- procedure in the split PAL_A model.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 VersionOfPalB:16;\r
- UINT64 Reserved1:8;\r
- UINT64 PalVendor:8;\r
- UINT64 VersionOfPalA:16;\r
- UINT64 Reserved2:16;\r
-} PAL_VERSION_INFO;\r
-\r
-/**\r
- PAL Procedure - PAL_VERSION.\r
-\r
- Return version of PAL code. It is required by IPF. The PAL\r
- procedure supports the Static Registers calling convention. It\r
- could be called at physical mode and virtual mode.\r
-\r
- @param Index Index of PAL_VERSION within the list of\r
- PAL procedures.\r
- @param InfoRequest Unsigned 64-bit integer denoting what\r
- register information is requested. See\r
- PAL_REGISTER_INFO.InfoRequest above.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 8-byte formatted value returning the minimum PAL\r
- version needed for proper operation of the\r
- processor. See PAL_VERSION_INFO above.\r
- @return R10 8-byte formatted value returning the current PAL\r
- version running on the processor. See\r
- PAL_VERSION_INFO above.\r
-\r
-**/\r
-#define PAL_VERSION 20\r
-\r
-\r
-\r
-//\r
-// Vectors of PAL_MC_CLEAR_LOG.pending\r
-//\r
-#define PAL_MC_PENDING BIT0\r
-#define PAL_INIT_PENDING BIT1\r
-\r
-/**\r
- PAL Procedure - PAL_MC_CLEAR_LOG.\r
-\r
- Clear all error information from processor error logging\r
- registers. It is required by IPF. The PAL procedure supports\r
- the Static Registers calling convention. It could be called at\r
- physical mode and virtual mode.\r
-\r
- @param Index Index of PAL_MC_CLEAR_LOG within the list of\r
- PAL procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 64-bit vector denoting whether an event is\r
- pending. See PAL_MC_CLEAR_LOG.pending above.\r
-\r
-**/\r
-#define PAL_MC_CLEAR_LOG 21\r
-\r
-/**\r
- PAL Procedure - PAL_MC_DRAIN.\r
-\r
- Ensure that all operations that could cause an MCA have\r
- completed. It is required by IPF. The PAL procedure supports\r
- the Static Registers calling convention. It could be called at\r
- physical mode and virtual mode.\r
-\r
- @param Index Index of PAL_MC_DRAIN within the list of PAL\r
- procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
-**/\r
-#define PAL_MC_DRAIN 22\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_MC_DYNAMIC_STATE.\r
-\r
- Return Processor Dynamic State for logging by SAL. It is\r
- optional. The PAL procedure supports the Static Registers\r
- calling convention. It could be called at physical mode.\r
-\r
- @param Index Index of PAL_MC_DYNAMIC_STATE within the list of PAL\r
- procedures.\r
- @param Offset Offset of the next 8 bytes of Dynamic Processor\r
- State to return. (multiple of 8).\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure.\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Unsigned 64-bit integer denoting bytes of Dynamic\r
- Processor State returned.\r
- @return R10 Next 8 bytes of Dynamic Processor State.\r
-\r
-**/\r
-#define PAL_MC_DYNAMIC_STATE 24\r
-\r
-\r
-\r
-//\r
-// Values of PAL_MC_ERROR_INFO.InfoIndex.\r
-//\r
-#define PAL_PROCESSOR_ERROR_MAP 0\r
-#define PAL_PROCESSOR_STATE_PARAM 1\r
-#define PAL_STRUCTURE_SPECIFIC_ERROR 2\r
-\r
-/**\r
-\r
- @param CoreId Bit3:0, Processor core ID (default is 0 for\r
- processors with a single core)\r
-\r
- @param ThreadId Bit7:4, Logical thread ID (default is 0 for\r
- processors that execute a single thread)\r
-\r
- @param InfoOfInsCache Bit11:8, Error information is\r
- available for 1st, 2nd, 3rd, and 4th\r
- level instruction caches.\r
-\r
- @param InfoOfDataCache Bit15:12, Error information is\r
- available for 1st, 2nd, 3rd, and 4th\r
- level data/unified caches.\r
-\r
- @param InfoOfInsTlb Bit19:16 Error information is available\r
- for 1st, 2nd, 3rd, and 4th level\r
- instruction TLB.\r
-\r
- @param InfoOfDataTlb Bit23:20, Error information is available\r
- for 1st, 2nd, 3rd, and 4th level\r
- data/unified TLB\r
-\r
- @param InfoOfProcessorBus Bit27:24 Error information is\r
- available for the 1st, 2nd, 3rd,\r
- and 4th level processor bus\r
- hierarchy.\r
-\r
- @param InfoOfRegisterFile Bit31:28 Error information is\r
- available on register file\r
- structures.\r
-\r
- @param InfoOfMicroArch Bit47:32, Error information is\r
- available on micro-architectural\r
- structures.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 CoreId:4;\r
- UINT64 ThreadId:4;\r
- UINT64 InfoOfInsCache:4;\r
- UINT64 InfoOfDataCache:4;\r
- UINT64 InfoOfInsTlb:4;\r
- UINT64 InfoOfDataTlb:4;\r
- UINT64 InfoOfProcessorBus:4;\r
- UINT64 InfoOfRegisterFile:4;\r
- UINT64 InfoOfMicroArch:4;\r
- UINT64 Reserved:16;\r
-} PAL_MC_ERROR_INFO_LEVEL_INDEX;\r
-\r
-//\r
-// Value of PAL_MC_ERROR_INFO.ErrorTypeIndex\r
-//\r
-#define PAL_ERR_INFO_BY_LEVEL_INDEX 0\r
-#define PAL_ERR_INFO_TARGET_ADDRESS 1\r
-#define PAL_ERR_INFO_REQUESTER_IDENTIFIER 2\r
-#define PAL_ERR_INFO_REPONSER_INDENTIFIER 3\r
-#define PAL_ERR_INFO_PRECISE_INSTRUCTION_POINTER 4\r
-\r
-/**\r
-\r
- @param Operation Bit3:0, Type of cache operation that caused\r
- the machine check: 0 - unknown or internal\r
- error 1 - load 2 - store 3 - instruction\r
- fetch or instruction prefetch 4 - data\r
- prefetch (both hardware and software) 5 -\r
- snoop (coherency check) 6 - cast out\r
- (explicit or implicit write-back of a cache\r
- line) 7 - move in (cache line fill)\r
-\r
- @param FailedCacheLevel Bit5:4 Level of cache where the\r
- error occurred. A value of 0\r
- indicates the first level of cache.\r
-\r
- @param FailedInDataPart Bit8, Failure located in the data\r
- part of the cache line.\r
-\r
- @param FailedInTagPart Bit9, Failure located in the tag part\r
- of the cache line.\r
-\r
- @param FailedInDataCache Bit10, Failure located in the data\r
- cache\r
-\r
- @param FailedInInsCache Bit11, Failure located in the\r
- instruction cache.\r
-\r
-\r
- @param Mesi Bit14:12, 0 - cache line is invalid. 1 - cache\r
- line is held shared. 2 - cache line is held\r
- exclusive. 3 - cache line is modified. All other\r
- values are reserved.\r
-\r
- @param MesiIsValid Bit15, The mesi field in the cache_check\r
- parameter is valid.\r
-\r
- @param FailedWay Bit20:16, Failure located in the way of\r
- the cache indicated by this value.\r
-\r
- @param WayIndexIsValid Bit21, The way and index field in the\r
- cache_check parameter is valid.\r
-\r
- @param MultipleBitsError Bit23, A multiple-bit error was\r
- detected, and data was poisoned for\r
- the corresponding cache line during\r
- castout.\r
-\r
- @param IndexOfCacheLineError Bit51:32, Index of the cache\r
- line where the error occurred.\r
-\r
- @param InstructionSet Bit54, Instruction set. If this value\r
- is set to zero, the instruction that\r
- generated the machine check was an\r
- Intel Itanium instruction. If this bit\r
- is set to one, the instruction that\r
- generated the machine check was IA-32\r
- instruction.\r
-\r
- @param InstructionSetIsValid Bit55, The is field in the\r
- cache_check parameter is valid.\r
-\r
- @param PrivilegeLevel Bit57:56, Privilege level. The\r
- privilege level of the instruction\r
- bundle responsible for generating the\r
- machine check.\r
-\r
- @param PrivilegeLevelIsValide Bit58, The pl field of the\r
- cache_check parameter is\r
- valid.\r
-\r
- @param McCorrected Bit59, Machine check corrected: This bit\r
- is set to one to indicate that the machine\r
- check has been corrected.\r
-\r
- @param TargetAddressIsValid Bit60, Target address is valid:\r
- This bit is set to one to\r
- indicate that a valid target\r
- address has been logged.\r
-\r
- @param RequesterIdentifier Bit61, Requester identifier: This\r
- bit is set to one to indicate that\r
- a valid requester identifier has\r
- been logged.\r
-\r
- @param ResponserIdentifier Bit62, Responder identifier: This\r
- bit is set to one to indicate that\r
- a valid responder identifier has\r
- been logged.\r
-\r
- @param PreciseInsPointer Bit63, Precise instruction pointer.\r
- This bit is set to one to indicate\r
- that a valid precise instruction\r
- pointer has been logged.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 Operation:4;\r
- UINT64 FailedCacheLevel:2;\r
- UINT64 Reserved1:2;\r
- UINT64 FailedInDataPart:1;\r
- UINT64 FailedInTagPart:1;\r
- UINT64 FailedInDataCache:1;\r
- UINT64 FailedInInsCache:1;\r
- UINT64 Mesi:3;\r
- UINT64 MesiIsValid:1;\r
- UINT64 FailedWay:5;\r
- UINT64 WayIndexIsValid:1;\r
-\r
- UINT64 Reserved2:1;\r
- UINT64 MultipleBitsError:1;\r
- UINT64 Reserved3:8;\r
- UINT64 IndexOfCacheLineError:20;\r
- UINT64 Reserved4:2;\r
- UINT64 InstructionSet:1;\r
- UINT64 InstructionSetIsValid:1;\r
-\r
- UINT64 PrivilegeLevel:2;\r
- UINT64 PrivilegeLevelIsValide:1;\r
-\r
- UINT64 McCorrected:1;\r
-\r
- UINT64 TargetAddressIsValid:1;\r
- UINT64 RequesterIdentifier:1;\r
- UINT64 ResponserIdentifier:1;\r
- UINT64 PreciseInsPointer:1;\r
-\r
-} PAL_CACHE_CHECK_INFO;\r
-\r
-/**\r
-\r
- @param FailedSlot Bit7:0, Slot number of the translation\r
- register where the failure occurred.\r
-\r
- @param FailedSlotIsValid Bit8, The tr_slot field in the\r
- TLB_check parameter is valid.\r
-\r
- @param TlbLevel Bit11:10, The level of the TLB where the\r
- error occurred. A value of 0 indicates the\r
- first level of TLB\r
-\r
- @param FailedInDataTr Bit16, Error occurred in the data\r
- translation registers.\r
-\r
- @param FailedInInsTr Bit17, Error occurred in the instruction\r
- translation registers\r
-\r
- @param FailedInDataTc Bit18, Error occurred in data\r
- translation cache.\r
-\r
- @param FailedInInsTc Bit19, Error occurred in the instruction\r
- translation cache.\r
-\r
- @param FailedOperation Bit23:20, Type of cache operation that\r
- caused the machine check: 0 - unknown\r
- 1 - TLB access due to load instruction\r
- 2 - TLB access due to store\r
- instruction 3 - TLB access due to\r
- instruction fetch or instruction\r
- prefetch 4 - TLB access due to data\r
- prefetch (both hardware and software)\r
- 5 - TLB shoot down access 6 - TLB\r
- probe instruction (probe, tpa) 7 -\r
- move in (VHPT fill) 8 - purge (insert\r
- operation that purges entries or a TLB\r
- purge instruction) All other values\r
- are reserved.\r
-\r
- @param InstructionSet Bit54, Instruction set. If this value\r
- is set to zero, the instruction that\r
- generated the machine check was an\r
- Intel Itanium instruction. If this bit\r
- is set to one, the instruction that\r
- generated the machine check was IA-32\r
- instruction.\r
-\r
- @param InstructionSetIsValid Bit55, The is field in the\r
- TLB_check parameter is valid.\r
-\r
- @param PrivelegeLevel Bit57:56, Privilege level. The\r
- privilege level of the instruction\r
- bundle responsible for generating the\r
- machine check.\r
-\r
- @param PrivelegeLevelIsValid Bit58, The pl field of the\r
- TLB_check parameter is valid.\r
-\r
- @param McCorrected Bit59, Machine check corrected: This bit\r
- is set to one to indicate that the machine\r
- check has been corrected.\r
-\r
- @param TargetAddressIsValid Bit60, Target address is valid:\r
- This bit is set to one to\r
- indicate that a valid target\r
- address has been logged.\r
-\r
- @param RequesterIdentifier Bit61 Requester identifier: This\r
- bit is set to one to indicate that\r
- a valid requester identifier has\r
- been logged.\r
-\r
- @param ResponserIdentifier Bit62, Responder identifier: This\r
- bit is set to one to indicate that\r
- a valid responder identifier has\r
- been logged.\r
-\r
- @param PreciseInsPointer Bit63 Precise instruction pointer.\r
- This bit is set to one to indicate\r
- that a valid precise instruction\r
- pointer has been logged.\r
-**/\r
-typedef struct {\r
- UINT64 FailedSlot:8;\r
- UINT64 FailedSlotIsValid:1;\r
- UINT64 Reserved1 :1;\r
- UINT64 TlbLevel:2;\r
- UINT64 Reserved2 :4;\r
- UINT64 FailedInDataTr:1;\r
- UINT64 FailedInInsTr:1;\r
- UINT64 FailedInDataTc:1;\r
- UINT64 FailedInInsTc:1;\r
- UINT64 FailedOperation:4;\r
- UINT64 Reserved3:30;\r
- UINT64 InstructionSet:1;\r
- UINT64 InstructionSetIsValid:1;\r
- UINT64 PrivelegeLevel:2;\r
- UINT64 PrivelegeLevelIsValid:1;\r
- UINT64 McCorrected:1;\r
- UINT64 TargetAddressIsValid:1;\r
- UINT64 RequesterIdentifier:1;\r
- UINT64 ResponserIdentifier:1;\r
- UINT64 PreciseInsPointer:1;\r
-} PAL_TLB_CHECK_INFO;\r
-\r
-/**\r
- PAL Procedure - PAL_MC_ERROR_INFO.\r
-\r
- Return Processor Machine Check Information and Processor\r
- Static State for logging by SAL. It is required by IPF. The\r
- PAL procedure supports the Static Registers calling\r
- convention. It could be called at physical and virtual mode.\r
-\r
- @param Index Index of PAL_MC_ERROR_INFO within the list of PAL\r
- procedures.\r
- @param InfoIndex Unsigned 64-bit integer identifying the\r
- error information that is being requested.\r
- See PAL_MC_ERROR_INFO.InfoIndex.\r
- @param LevelIndex 8-byte formatted value identifying the\r
- structure to return error information\r
- on. See PAL_MC_ERROR_INFO_LEVEL_INDEX.\r
- @param ErrorTypeIndex Unsigned 64-bit integer denoting the\r
- type of error information that is\r
- being requested for the structure\r
- identified in LevelIndex.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -6 Argument was valid, but no error\r
- information was available\r
-\r
- @return R9 Error information returned. The format of this\r
- value is dependant on the input values passed.\r
- @return R10 If this value is zero, all the error information\r
- specified by err_type_index has been returned. If\r
- this value is one, more structure-specific error\r
- information is available and the caller needs to\r
- make this procedure call again with level_index\r
- unchanged and err_type_index, incremented.\r
-\r
-**/\r
-#define PAL_MC_ERROR_INFO 25\r
-\r
-/**\r
- PAL Procedure - PAL_MC_EXPECTED.\r
-\r
- Set/Reset Expected Machine Check Indicator. It is required by\r
- IPF. The PAL procedure supports the Static Registers calling\r
- convention. It could be called at physical mode.\r
-\r
- @param Index Index of PAL_MC_EXPECTED within the list of PAL\r
- procedures.\r
- @param Expected Unsigned integer with a value of 0 or 1 to\r
- set or reset the hardware resource\r
- PALE_CHECK examines for expected machine\r
- checks.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Unsigned integer denoting whether a machine check\r
- was previously expected.\r
-\r
-**/\r
-#define PAL_MC_EXPECTED 23\r
-\r
-/**\r
- PAL Procedure - PAL_MC_REGISTER_MEM.\r
-\r
- Register min-state save area with PAL for machine checks and\r
- inits. It is required by IPF. The PAL procedure supports the\r
- Static Registers calling convention. It could be called at\r
- physical mode.\r
-\r
- @param Index Index of PAL_MC_REGISTER_MEM within the list of PAL\r
- procedures.\r
- @param Address Physical address of the buffer to be\r
- registered with PAL.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
-**/\r
-#define PAL_MC_REGISTER_MEM 27\r
-\r
-/**\r
- PAL Procedure - PAL_MC_RESUME.\r
-\r
- Restore minimal architected state and return to interrupted\r
- process. It is required by IPF. The PAL procedure supports the\r
- Static Registers calling convention. It could be called at\r
- physical mode.\r
-\r
- @param Index Index of PAL_MC_RESUME within the list of PAL\r
- procedures.\r
- @param SetCmci Unsigned 64 bit integer denoting whether to\r
- set the CMC interrupt. A value of 0 indicates\r
- not to set the interrupt, a value of 1\r
- indicated to set the interrupt, and all other\r
- values are reserved.\r
- @param SavePtr Physical address of min-state save area used\r
- to used to restore processor state.\r
- @param NewContext Unsigned 64-bit integer denoting whether\r
- the caller is returning to a new context.\r
- A value of 0 indicates the caller is\r
- returning to the interrupted context, a\r
- value of 1 indicates that the caller is\r
- returning to a new context.\r
-\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
-**/\r
-#define PAL_MC_RESUME 26\r
-\r
-/**\r
- PAL Procedure - PAL_HALT.\r
-\r
- Enter the low-power HALT state or an implementation-dependent\r
- low-power state. It is optinal. The PAL procedure supports the\r
- Static Registers calling convention. It could be called at\r
- physical mode.\r
-\r
- @param Index Index of PAL_HALT within the list of PAL\r
- procedures.\r
- @param HaltState Unsigned 64-bit integer denoting low power\r
- state requested.\r
- @param IoDetailPtr 8-byte aligned physical address pointer to\r
- information on the type of I/O\r
- (load/store) requested.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Value returned if a load instruction is requested\r
- in the io_detail_ptr\r
-\r
-**/\r
-#define PAL_HALT 28\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_HALT_INFO.\r
-\r
- Return the low power capabilities of the processor. It is\r
- required by IPF. The PAL procedure supports the\r
- Stacked Registers calling convention. It could be called at\r
- physical and virtual mode.\r
-\r
- @param Index Index of PAL_HALT_INFO within the list of PAL\r
- procedures.\r
- @param PowerBuffer 64-bit pointer to a 64-byte buffer aligned\r
- on an 8-byte boundary.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
-**/\r
-#define PAL_HALT_INFO 257\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_HALT_LIGHT.\r
-\r
- Enter the low power LIGHT HALT state. It is required by\r
- IPF. The PAL procedure supports the Static Registers calling\r
- convention. It could be called at physical and virtual mode.\r
-\r
- @param Index Index of PAL_HALT_LIGHT within the list of PAL\r
- procedures.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
-**/\r
-#define PAL_HALT_LIGHT 29\r
-\r
-/**\r
- PAL Procedure - PAL_CACHE_LINE_INIT.\r
-\r
- Initialize tags and data of a cache line for processor\r
- testing. It is required by IPF. The PAL procedure supports the\r
- Static Registers calling convention. It could be called at\r
- physical and virtual mode.\r
-\r
- @param Index Index of PAL_CACHE_LINE_INIT within the list of PAL\r
- procedures.\r
- @param Address Unsigned 64-bit integer value denoting the\r
- physical address from which the physical page\r
- number is to be generated. The address must be\r
- an implemented physical address, bit 63 must\r
- be zero.\r
- @param DataValue 64-bit data value which is used to\r
- initialize the cache line.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
-**/\r
-#define PAL_CACHE_LINE_INIT 31\r
-\r
-/**\r
- PAL Procedure - PAL_CACHE_READ.\r
-\r
- Read tag and data of a cache line for diagnostic testing. It\r
- is optional. The PAL procedure supports the\r
- Satcked Registers calling convention. It could be called at\r
- physical mode.\r
-\r
- @param Index Index of PAL_CACHE_READ within the list of PAL\r
- procedures.\r
- @param LineId 8-byte formatted value describing where in the\r
- cache to read the data.\r
- @param Address 64-bit 8-byte aligned physical address from\r
- which to read the data. The address must be an\r
- implemented physical address on the processor\r
- model with bit 63 set to zero.\r
-\r
- @retval 1 The word at address was found in the\r
- cache, but the line was invalid.\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -5 The word at address was not found in the\r
- cache.\r
- @retval -7 The operation requested is not supported\r
- for this cache_type and level.\r
-\r
- @return R9 Right-justified value returned from the cache\r
- line.\r
- @return R10 The number of bits returned in data.\r
- @return R11 The status of the cache line.\r
-\r
-**/\r
-#define PAL_CACHE_READ 259\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_CACHE_WRITE.\r
-\r
- Write tag and data of a cache for diagnostic testing. It is\r
- optional. The PAL procedure supports the Satcked Registers\r
- calling convention. It could be called at physical mode.\r
-\r
- @param Index Index of PAL_CACHE_WRITE within the list of PAL\r
- procedures.\r
- @param LineId 8-byte formatted value describing where in the\r
- cache to write the data.\r
- @param Address 64-bit 8-byte aligned physical address at\r
- which the data should be written. The address\r
- must be an implemented physical address on the\r
- processor model with bit 63 set to 0.\r
- @param Data Unsigned 64-bit integer value to write into\r
- the specified part of the cache.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -7 The operation requested is not supported\r
- for this cache_type and level.\r
-\r
-**/\r
-#define PAL_CACHE_WRITE 260\r
-\r
-/**\r
- PAL Procedure - PAL_TEST_INFO.\r
-\r
- Returns alignment and size requirements needed for the memory\r
- buffer passed to the PAL_TEST_PROC procedure as well as\r
- information on self-test control words for the processor self\r
- tests. It is required by IPF. The PAL procedure supports the\r
- Static Registers calling convention. It could be called at\r
- physical mode.\r
-\r
- @param Index Index of PAL_TEST_INFO within the list of PAL\r
- procedures.\r
- @param TestPhase Unsigned integer that specifies which phase\r
- of the processor self-test information is\r
- being requested on. A value of 0 indicates\r
- the phase two of the processor self-test and\r
- a value of 1 indicates phase one of the\r
- processor self-test. All other values are\r
- reserved.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Unsigned 64-bit integer denoting the number of\r
- bytes of main memory needed to perform the second\r
- phase of processor self-test.\r
- @return R10 Unsigned 64-bit integer denoting the alignment\r
- required for the memory buffer.\r
- @return R11 48-bit wide bit-field indicating if control of\r
- the processor self-tests is supported and which\r
- bits of the test_control field are defined for\r
- use.\r
-\r
-**/\r
-#define PAL_TEST_INFO 37\r
-\r
-/**\r
-\r
- @param BufferSize Indicates the size in bytes of the memory\r
- buffer that is passed to this procedure.\r
- BufferSize must be greater than or equal in\r
- size to the bytes_needed return value from\r
- PAL_TEST_INFO, otherwise this procedure will\r
- return with an invalid argument return\r
- value.\r
-\r
- @param TestPhase Defines which phase of the processor\r
- self-tests are requested to be run. A value\r
- of zero indicates to run phase two of the\r
- processor self-tests. Phase two of the\r
- processor self-tests are ones that require\r
- external memory to execute correctly. A\r
- value of one indicates to run phase one of\r
- the processor self-tests. Phase one of the\r
- processor self-tests are tests run during\r
- PALE_RESET and do not depend on external\r
- memory to run correctly. When the caller\r
- requests to have phase one of the processor\r
- self-test run via this procedure call, a\r
- memory buffer may be needed to save and\r
- restore state as required by the PAL calling\r
- conventions. The procedure PAL_TEST_INFO\r
- informs the caller about the requirements of\r
- the memory buffer.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 BufferSize:56;\r
- UINT64 TestPhase:8;\r
-} PAL_TEST_INFO_INFO;\r
-\r
-/**\r
-\r
- @param TestControl This is an ordered implementation-specific\r
- control word that allows the user control\r
- over the length and runtime of the\r
- processor self-tests. This control word is\r
- ordered from the longest running tests up\r
- to the shortest running tests with bit 0\r
- controlling the longest running test. PAL\r
- may not implement all 47-bits of the\r
- test_control word. PAL communicates if a\r
- bit provides control by placing a zero in\r
- that bit. If a bit provides no control,\r
- PAL will place a one in it. PAL will have\r
- two sets of test_control bits for the two\r
- phases of the processor self-test. PAL\r
- provides information about implemented\r
- test_control bits at the hand-off from PAL\r
- to SAL for the firmware recovery check.\r
- These test_control bits provide control\r
- for phase one of processor self-test. It\r
- also provides this information via the PAL\r
- procedure call PAL_TEST_INFO for both the\r
- phase one and phase two processor tests\r
- depending on which information the caller\r
- is requesting. PAL interprets these bits\r
- as input parameters on two occasions. The\r
- first time is when SAL passes control back\r
- to PAL after the firmware recovery check.\r
- The second time is when a call to\r
- PAL_TEST_PROC is made. When PAL interprets\r
- these bits it will only interpret\r
- implemented test_control bits and will\r
- ignore the values located in the\r
- unimplemented test_control bits. PAL\r
- interprets the implemented bits such that\r
- if a bit contains a zero, this indicates\r
- to run the test. If a bit contains a one,\r
- this indicates to PAL to skip the test. If\r
- the cs bit indicates that control is not\r
- available, the test_control bits will be\r
- ignored or generate an illegal argument in\r
- procedure calls if the caller sets these\r
- bits.\r
-\r
- @param ControlSupport This bit defines if an implementation\r
- supports control of the PAL self-tests\r
- via the self-test control word. If\r
- this bit is 0, the implementation does\r
- not support control of the processor\r
- self-tests via the self-test control\r
- word. If this bit is 1, the\r
- implementation does support control of\r
- the processor self-tests via the\r
- self-test control word. If control is\r
- not supported, GR37 will be ignored at\r
- the hand-off between SAL and PAL after\r
- the firmware recovery check and the\r
- PAL procedures related to the\r
- processor self-tests may return\r
- illegal arguments if a user tries to\r
- use the self-test control features.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 TestControl:47;\r
- UINT64 ControlSupport:1;\r
- UINT64 Reserved:16;\r
-} PAL_SELF_TEST_CONTROL;\r
-\r
-/**\r
-\r
- @param Attributes Specifies the memory attributes that are\r
- allowed to be used with the memory buffer\r
- passed to this procedure. The attributes\r
- parameter is a vector where each bit\r
- represents one of the virtual memory\r
- attributes defined by the architecture.See\r
- MEMORY_AATRIBUTES. The caller is required\r
- to support the cacheable attribute for the\r
- memory buffer, otherwise an invalid\r
- argument will be returned.\r
-\r
-\r
- @param TestControl Is the self-test control word\r
- corresponding to the test_phase passed.\r
- This test_control directs the coverage and\r
- runtime of the processor self-tests\r
- specified by the test_phase input\r
- argument. Information on if this\r
- feature is implemented and the number of\r
- bits supported can be obtained by the\r
- PAL_TEST_INFO procedure call. If this\r
- feature is implemented by the processor,\r
- the caller can selectively skip parts of\r
- the processor self-test by setting\r
- test_control bits to a one. If a bit has a\r
- zero, this test will be run. The values in\r
- the unimplemented bits are ignored. If\r
- PAL_TEST_INFO indicated that the self-test\r
- control word is not implemented, this\r
- procedure will return with an invalid\r
- argument status if the caller sets any of\r
- the test_control bits. See\r
- PAL_SELF_TEST_CONTROL.\r
-**/\r
-typedef struct {\r
- UINT64 Attributes:8;\r
- UINT64 Reserved:8;\r
- UINT64 TestControl:48;\r
-} PAL_TEST_CONTROL;\r
-\r
-/**\r
- PAL Procedure - PAL_TEST_PROC.\r
-\r
- Perform late processor self test. It is required by IPF. The\r
- PAL procedure supports the Static Registers calling\r
- convention. It could be called at physical mode.\r
-\r
- @param Index Index of PAL_TEST_PROC within the list of PAL\r
- procedures.\r
- @param TestAddress 64-bit physical address of main memory\r
- area to be used by processor self-test.\r
- The memory region passed must be\r
- cacheable, bit 63 must be zero.\r
- @param TestInfo Input argument specifying the size of the\r
- memory buffer passed and the phase of the\r
- processor self-test that should be run. See\r
- PAL_TEST_INFO.\r
- @param TestParam Input argument specifying the self-test\r
- control word and the allowable memory\r
- attributes that can be used with the memory\r
- buffer. See PAL_TEST_CONTROL.\r
-\r
- @retval 1 Call completed without error, but hardware\r
- failures occurred during self-test.\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Formatted 8-byte value denoting the state of the\r
- processor after self-test\r
-\r
-**/\r
-#define PAL_TEST_PROC 258\r
-\r
-/**\r
-\r
- @param NumberOfInterruptControllers Number of interrupt\r
- controllers currently\r
- enabled on the system.\r
-\r
- @param NumberOfProcessors Number of processors currently\r
- enabled on the system.\r
-\r
-**/\r
-typedef struct {\r
- UINT32 NumberOfInterruptControllers;\r
- UINT32 NumberOfProcessors;\r
-} PAL_PLATFORM_INFO;\r
-\r
-/**\r
- PAL Procedure - PAL_COPY_INFO.\r
-\r
- Return information needed to relocate PAL procedures and PAL\r
- PMI code to memory. It is required by IPF. The PAL procedure\r
- supports the Static Registers calling convention. It could be\r
- called at physical mode.\r
-\r
- @param Index Index of PAL_COPY_INFO within the list of PAL\r
- procedures.\r
- @param CopyType Unsigned integer denoting type of procedures\r
- for which copy information is requested.\r
- @param PlatformInfo 8-byte formatted value describing the\r
- number of processors and the number of\r
- interrupt controllers currently enabled\r
- on the system. See PAL_PLATFORM_INFO.\r
- @param McaProcStateInfo Unsigned integer denoting the number\r
- of bytes that SAL needs for the\r
- min-state save area for each\r
- processor.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Unsigned integer denoting the number of bytes of\r
- PAL information that must be copied to main\r
- memory.\r
- @return R10 Unsigned integer denoting the starting alignment\r
- of the data to be copied.\r
-\r
-**/\r
-#define PAL_COPY_INFO 30\r
-\r
-/**\r
- PAL Procedure - PAL_COPY_PAL.\r
-\r
- Relocate PAL procedures and PAL PMI code to memory. It is\r
- required by IPF. The PAL procedure supports the Stacked\r
- Registers calling convention. It could be called at physical\r
- mode.\r
-\r
- @param Index Index of PAL_COPY_PAL within the list of PAL\r
- procedures.\r
- @param TargetAddress Physical address of a memory buffer to\r
- copy relocatable PAL procedures and PAL\r
- PMI code.\r
- @param AllocSize Unsigned integer denoting the size of the\r
- buffer passed by SAL for the copy operation.\r
- @param CopyOption Unsigned integer indicating whether\r
- relocatable PAL code and PAL PMI code\r
- should be copied from firmware address\r
- space to main memory.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Unsigned integer denoting the offset of PAL_PROC\r
- in the relocatable segment copied.\r
-\r
-**/\r
-#define PAL_COPY_PAL 256\r
-\r
-/**\r
- PAL Procedure - PAL_ENTER_IA_32_ENV.\r
-\r
- Enter IA-32 System environment. It is optional. The PAL\r
- procedure supports the Static Registers calling convention.\r
- It could be called at physical mode.\r
-\r
- Note: Since this is a special call, it does not follow the PAL\r
- static register calling convention. GR28 contains the index of\r
- PAL_ENTER_IA_32_ENV within the list of PAL procedures. All other\r
- input arguments including GR29-GR31 are setup by SAL to values\r
- as required by the IA-32 operating system defined in Table\r
- 11-67. The registers that are designated as preserved, scratch,\r
- input arguments and procedure return values by the static\r
- procedure calling convention are not followed by this call. For\r
- instance, GR5 and GR6 need not be preserved since these are\r
- regarded as scratch by the IA-32 operating system. Note: In an\r
- MP system, this call must be COMPLETED on the first CPU to enter\r
- the IA-32 System Environment (may or may not be the BSP) prior\r
- to being called on the remaining processors in the MP system.\r
-\r
- @param Index GR28 contains the index of the\r
- PAL_ENTER_IA_32_ENV call within the list of PAL\r
- procedures.\r
-\r
-\r
- @retval The status is returned in GR4.\r
- -1 - Un-implemented procedure 0 JMPE detected\r
- at privilege level\r
-\r
- 0 - 1 SAL allocated buffer for IA-32 System\r
- Environment operation is too small\r
-\r
- 2 - IA-32 Firmware Checksum Error\r
-\r
- 3 - SAL allocated buffer for IA-32 System\r
- Environment operation is not properly aligned\r
-\r
- 4 - Error in SAL MP Info Table\r
-\r
- 5 - Error in SAL Memory Descriptor Table\r
-\r
- 6 - Error in SAL System Table\r
-\r
- 7 - Inconsistent IA-32 state\r
-\r
- 8 - IA-32 Firmware Internal Error\r
-\r
- 9 - IA-32 Soft Reset (Note: remaining register\r
- state is undefined for this termination\r
- reason)\r
-\r
- 10 - Machine Check Error\r
-\r
- 11 - Error in SAL I/O Intercept Table\r
-\r
- 12 - Processor exit due to other processor in\r
- MP system terminating the IA32 system\r
- environment. (Note: remaining register state\r
- is undefined for this termination reason.)\r
-\r
- 13 - Itanium architecture-based state\r
- corruption by either SAL PMI handler or I/O\r
- Intercept callback function.\r
-\r
-\r
-**/\r
-#define PAL_ENTER_IA_32_ENV 33\r
-\r
-/**\r
- PAL Procedure - PAL_PMI_ENTRYPOINT.\r
-\r
- Register PMI memory entrypoints with processor. It is required\r
- by IPF. The PAL procedure supports the Stacked Registers\r
- calling convention. It could be called at physical mode.\r
-\r
- @param Index Index of PAL_PMI_ENTRYPOINT within the list of\r
- PAL procedures.\r
- @param SalPmiEntry 256-byte aligned physical address of SAL\r
- PMI entrypoint in memory.\r
-\r
- @retval 0 Call completed without error\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
-**/\r
-#define PAL_PMI_ENTRYPOINT 32\r
-\r
-\r
-/**\r
-\r
- The ASCII brand identification string will be copied to the\r
- address specified in the address input argument. The processor\r
- brand identification string is defined to be a maximum of 128\r
- characters long; 127 bytes will contain characters and the 128th\r
- byte is defined to be NULL (0). A processor may return less than\r
- the 127 ASCII characters as long as the string is null\r
- terminated. The string length will be placed in the brand_info\r
- return argument.\r
-\r
-**/\r
-#define PAL_BRAND_INFO_ID_REQUEST 0\r
-\r
-/**\r
- PAL Procedure - PAL_BRAND_INFO.\r
-\r
- Provides processor branding information. It is optional by\r
- IPF. The PAL procedure supports the Stacked Registers calling\r
- convention. It could be called at physical and Virtual mode.\r
-\r
- @param Index Index of PAL_BRAND_INFO within the list of PAL\r
- procedures.\r
- @param InfoRequest Unsigned 64-bit integer specifying the\r
- information that is being requested. (See\r
- PAL_BRAND_INFO_ID_REQUEST)\r
- @param Address Unsigned 64-bit integer specifying the\r
- address of the 128-byte block to which the\r
- processor brand string shall be written.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -6 Input argument is not implemented.\r
-\r
- @return R9 Brand information returned. The format of this\r
- value is dependent on the input values passed.\r
-\r
-**/\r
-#define PAL_BRAND_INFO 274\r
-\r
-/**\r
- PAL Procedure - PAL_GET_HW_POLICY.\r
-\r
- Returns the current hardware resource sharing policy of the\r
- processor. It is optional by IPF. The PAL procedure supports\r
- the Static Registers calling convention. It could be called at\r
- physical and Virtual mode.\r
-\r
-\r
- @param Index Index of PAL_GET_HW_POLICY within the list of PAL\r
- procedures.\r
- @param ProcessorNumber Unsigned 64-bit integer that specifies\r
- for which logical processor\r
- information is being requested. This\r
- input argument must be zero for the\r
- first call to this procedure and can\r
- be a maximum value of one less than\r
- the number of logical processors\r
- impacted by the hardware resource\r
- sharing policy, which is returned by\r
- the R10 return value.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
- @return R9 Unsigned 64-bit integer representing the current\r
- hardware resource sharing policy.\r
- @return R10 Unsigned 64-bit integer that returns the number\r
- of logical processors impacted by the policy\r
- input argument.\r
- @return R11 Unsigned 64-bit integer containing the logical\r
- address of one of the logical processors\r
- impacted by policy modification.\r
-\r
-**/\r
-#define PAL_GET_HW_POLICY 48\r
-\r
-\r
-//\r
-// Value of PAL_SET_HW_POLICY.Policy\r
-//\r
-#define PAL_SET_HW_POLICY_PERFORMANCE 0\r
-#define PAL_SET_HW_POLICY_FAIRNESS 1\r
-#define PAL_SET_HW_POLICY_HIGH_PRIORITY 2\r
-#define PAL_SET_HW_POLICY_EXCLUSIVE_HIGH_PRIORITY 3\r
-\r
-/**\r
- PAL Procedure - PAL_SET_HW_POLICY.\r
-\r
- Sets the current hardware resource sharing policy of the\r
- processor. It is optional by IPF. The PAL procedure supports\r
- the Static Registers calling convention. It could be called at\r
- physical and Virtual mode.\r
-\r
- @param Index Index of PAL_SET_HW_POLICY within the list of PAL\r
- procedures.\r
- @param Policy Unsigned 64-bit integer specifying the hardware\r
- resource sharing policy the caller is setting.\r
- See Value of PAL_SET_HW_POLICY.Policy above.\r
-\r
- @retval 1 Call completed successfully but could not\r
- change the hardware policy since a\r
- competing logical processor is set in\r
- exclusive high priority.\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
-**/\r
-#define PAL_SET_HW_POLICY 49\r
-\r
-\r
-/**\r
-\r
- @param Mode Bit2:0, Indicates the mode of operation for this\r
- procedure: 0 - Query mode 1 - Error inject mode\r
- (err_inj should also be specified) 2 - Cancel\r
- outstanding trigger. All other fields in\r
- PAL_MC_ERROR_TYPE_INFO,\r
- PAL_MC_ERROR_STRUCTURE_INFO and\r
- PAL_MC_ERROR_DATA_BUFFER are ignored. All other\r
- values are reserved.\r
-\r
- @param ErrorInjection Bit5:3, indicates the mode of error\r
- injection: 0 - Error inject only (no\r
- error consumption) 1 - Error inject\r
- and consume All other values are\r
- reserved.\r
-\r
-\r
- @param ErrorSeverity Bit7:6, indicates the severity desired\r
- for error injection/query. Definitions\r
- of the different error severity types\r
- 0 - Corrected error 1 - Recoverable\r
- error 2 - Fatal error 3 - Reserved\r
-\r
-\r
- @param ErrorStructure Bit12:8, Indicates the structure\r
- identification for error\r
- injection/query: 0 - Any structure\r
- (cannot be used during query mode).\r
- When selected, the structure type used\r
- for error injection is determined by\r
- PAL. 1 - Cache 2 - TLB 3 - Register\r
- file 4 - Bus/System interconnect 5-15\r
- - Reserved 16-31 - Processor\r
- specific error injection\r
- capabilities.ErrorDataBuffer is used\r
- to specify error types. Please refer\r
- to the processor specific\r
- documentation for additional details.\r
-\r
- @param StructureHierarchy Bit15:13, Indicates the structure\r
- hierarchy for error\r
- injection/query: 0 - Any level of\r
- hierarchy (cannot be used during\r
- query mode). When selected, the\r
- structure hierarchy used for error\r
- injection is determined by PAL. 1\r
- - Error structure hierarchy\r
- level-1 2 - Error structure\r
- hierarchy level-2 3 - Error\r
- structure hierarchy level-3 4 -\r
- Error structure hierarchy level-4\r
- All other values are reserved.\r
- Reserved 63:16 Reserved\r
-\r
-**/\r
-typedef struct {\r
- UINT64 Mode:3;\r
- UINT64 ErrorInjection:3;\r
- UINT64 ErrorSeverity:2;\r
- UINT64 ErrorStructure:5;\r
- UINT64 StructureHierarchy:3;\r
- UINT64 Reserved:48;\r
-} PAL_MC_ERROR_TYPE_INFO;\r
-\r
-/**\r
-\r
- @param StructInfoIsValid Bit0 When 1, indicates that the\r
- structure information fields\r
- (c_t,cl_p,cl_id) are valid and\r
- should be used for error injection.\r
- When 0, the structure information\r
- fields are ignored, and the values\r
- of these fields used for error\r
- injection are\r
- implementation-specific.\r
-\r
- @param CacheType Bit2:1 Indicates which cache should be used\r
- for error injection: 0 - Reserved 1 -\r
- Instruction cache 2 - Data or unified cache\r
- 3 - Reserved\r
-\r
-\r
- @param PortionOfCacheLine Bit5:3 Indicates the portion of the\r
- cache line where the error should\r
- be injected: 0 - Reserved 1 - Tag\r
- 2 - Data 3 - mesi All other\r
- values are reserved.\r
-\r
- @param Mechanism Bit8:6 Indicates which mechanism is used to\r
- identify the cache line to be used for error\r
- injection: 0 - Reserved 1 - Virtual address\r
- provided in the inj_addr field of the buffer\r
- pointed to by err_data_buffer should be used\r
- to identify the cache line for error\r
- injection. 2 - Physical address provided in\r
- the inj_addr field of the buffer pointed to\r
- by err_data_buffershould be used to identify\r
- the cache line for error injection. 3 - way\r
- and index fields provided in err_data_buffer\r
- should be used to identify the cache line\r
- for error injection. All other values are\r
- reserved.\r
-\r
- @param DataPoisonOfCacheLine Bit9 When 1, indicates that a\r
- multiple bit, non-correctable\r
- error should be injected in the\r
- cache line specified by cl_id.\r
- If this injected error is not\r
- consumed, it may eventually\r
- cause a data-poisoning event\r
- resulting in a corrected error\r
- signal, when the associated\r
- cache line is cast out (implicit\r
- or explicit write-back of the\r
- cache line). The error severity\r
- specified by err_sev in\r
- err_type_info must be set to 0\r
- (corrected error) when this bit\r
- is set.\r
-\r
-\r
- @param TrigerInfoIsValid Bit32 When 1, indicates that the\r
- trigger information fields (trigger,\r
- trigger_pl) are valid and should be\r
- used for error injection. When 0,\r
- the trigger information fields are\r
- ignored and error injection is\r
- performed immediately.\r
-\r
- @param Triger Bit36:33 Indicates the operation type to be\r
- used as the error trigger condition. The\r
- address corresponding to the trigger is\r
- specified in the trigger_addr field of the\r
- buffer pointed to by err_data_buffer: 0 -\r
- Instruction memory access. The trigger match\r
- conditions for this operation type are similar\r
- to the IBR address breakpoint match conditions\r
- 1 - Data memory access. The trigger match\r
- conditions for this operation type are similar\r
- to the DBR address breakpoint match conditions\r
- All other values are reserved.\r
-\r
- @param PrivilegeOfTriger Bit39:37 Indicates the privilege\r
- level of the context during which\r
- the error should be injected: 0 -\r
- privilege level 0 1 - privilege\r
- level 1 2 - privilege level 2 3 -\r
- privilege level 3 All other values\r
- are reserved. If the implementation\r
- does not support privilege level\r
- qualifier for triggers (i.e. if\r
- trigger_pl is 0 in the capabilities\r
- vector), this field is ignored and\r
- triggers can be taken at any\r
- privilege level.\r
-\r
-**/\r
-typedef struct {\r
- UINT64 StructInfoIsValid:1;\r
- UINT64 CacheType:2;\r
- UINT64 PortionOfCacheLine:3;\r
- UINT64 Mechanism:3;\r
- UINT64 DataPoisonOfCacheLine:1;\r
- UINT64 Reserved1:22;\r
- UINT64 TrigerInfoIsValid:1;\r
- UINT64 Triger:4;\r
- UINT64 PrivilegeOfTriger:3;\r
- UINT64 Reserved2:24;\r
-} PAL_MC_ERROR_STRUCT_INFO;\r
-\r
-/**\r
-\r
- Buffer Pointed to by err_data_buffer - TLB\r
-\r
-**/\r
-typedef struct {\r
- UINT64 TrigerAddress;\r
- UINT64 VirtualPageNumber:52;\r
- UINT64 Reserved1:8;\r
- UINT64 RegionId:24;\r
- UINT64 Reserved2:40;\r
-} PAL_MC_ERROR_DATA_BUFFER_TLB;\r
-\r
-/**\r
- PAL Procedure - PAL_MC_ERROR_INJECT.\r
-\r
- Injects the requested processor error or returns information\r
- on the supported injection capabilities for this particular\r
- processor implementation. It is optional by IPF. The PAL\r
- procedure supports the Stacked Registers calling convention.\r
- It could be called at physical and Virtual mode.\r
-\r
- @param Index Index of PAL_MC_ERROR_INJECT within the list of PAL\r
- procedures.\r
- @param ErrorTypeInfo Unsigned 64-bit integer specifying the\r
- first level error information which\r
- identifies the error structure and\r
- corresponding structure hierarchy, and\r
- the error severity.\r
- @param ErrorStructInfo Unsigned 64-bit integer identifying\r
- the optional structure specific\r
- information that provides the second\r
- level details for the requested error.\r
- @param ErrorDataBuffer 64-bit physical address of a buffer\r
- providing additional parameters for\r
- the requested error. The address of\r
- this buffer must be 8-byte aligned.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -4 Call completed with error; the requested\r
- error could not be injected due to failure in\r
- locating the target location in the specified\r
- structure.\r
- @retval -5 Argument was valid, but requested error\r
- injection capability is not supported.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
- @return R9 64-bit vector specifying the supported error\r
- injection capabilities for the input argument\r
- combination of struct_hier, err_struct and\r
- err_sev fields in ErrorTypeInfo.\r
- @return R10 64-bit vector specifying the architectural\r
- resources that are used by the procedure.\r
-\r
-**/\r
-#define PAL_MC_ERROR_INJECT 276\r
-\r
-\r
-//\r
-// Types of PAL_GET_PSTATE.Type\r
-//\r
-#define PAL_GET_PSTATE_RECENT 0\r
-#define PAL_GET_PSTATE_AVERAGE_NEW_START 1\r
-#define PAL_GET_PSTATE_AVERAGE 2\r
-#define PAL_GET_PSTATE_NOW 3\r
-\r
-/**\r
- PAL Procedure - PAL_GET_PSTATE.\r
-\r
- Returns the performance index of the processor. It is optional\r
- by IPF. The PAL procedure supports the Stacked Registers\r
- calling convention. It could be called at physical and Virtual\r
- mode.\r
-\r
- @param Index Index of PAL_GET_PSTATE within the list of PAL\r
- procedures.\r
- @param Type Type of performance_index value to be returned\r
- by this procedure.See PAL_GET_PSTATE.Type above.\r
-\r
- @retval 1 Call completed without error, but accuracy\r
- of performance index has been impacted by a\r
- thermal throttling event, or a\r
- hardware-initiated event.\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
- @return R9 Unsigned integer denoting the processor\r
- performance for the time duration since the last\r
- PAL_GET_PSTATE procedure call was made. The\r
- value returned is between 0 and 100, and is\r
- relative to the performance index of the highest\r
- available P-state.\r
-\r
-**/\r
-#define PAL_GET_PSTATE 262\r
-\r
-/**\r
-\r
- Layout of PAL_PSTATE_INFO.PStateBuffer\r
-\r
-**/\r
-typedef struct {\r
- UINT32 PerformanceIndex:7;\r
- UINT32 Reserved1:5;\r
- UINT32 TypicalPowerDissipation:20;\r
- UINT32 TransitionLatency1;\r
- UINT32 TransitionLatency2;\r
- UINT32 Reserved2;\r
-} PAL_PSTATE_INFO_BUFFER;\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_PSTATE_INFO.\r
-\r
- Returns information about the P-states supported by the\r
- processor. It is optional by IPF. The PAL procedure supports\r
- the Static Registers calling convention. It could be called\r
- at physical and Virtual mode.\r
-\r
- @param Index Index of PAL_PSTATE_INFO within the list of PAL\r
- procedures.\r
- @param PStateBuffer 64-bit pointer to a 256-byte buffer\r
- aligned on an 8-byte boundary. See\r
- PAL_PSTATE_INFO_BUFFER above.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
-\r
- @return R9 Unsigned integer denoting the number of P-states\r
- supported. The maximum value of this field is 16.\r
- @return R10 Dependency domain information\r
-\r
-**/\r
-#define PAL_PSTATE_INFO 44\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_SET_PSTATE.\r
-\r
- To request a processor transition to a given P-state. It is\r
- optional by IPF. The PAL procedure supports the Stacked\r
- Registers calling convention. It could be called at physical\r
- and Virtual mode.\r
-\r
- @param Index Index of PAL_SET_PSTATE within the list of PAL\r
- procedures.\r
- @param PState Unsigned integer denoting the processor\r
- P-state being requested.\r
- @param ForcePState Unsigned integer denoting whether the\r
- P-state change should be forced for the\r
- logical processor.\r
-\r
- @retval 1 Call completed without error, but\r
- transition request was not accepted\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
-**/\r
-#define PAL_SET_PSTATE 263\r
-\r
-/**\r
- PAL Procedure - PAL_SHUTDOWN.\r
-\r
- Put the logical processor into a low power state which can be\r
- exited only by a reset event. It is optional by IPF. The PAL\r
- procedure supports the Static Registers calling convention. It\r
- could be called at physical mode.\r
-\r
- @param Index Index of PAL_SHUTDOWN within the list of PAL\r
- procedures.\r
- @param NotifyPlatform 8-byte aligned physical address\r
- pointer providing details on how to\r
- optionally notify the platform that\r
- the processor is entering a shutdown\r
- state.\r
-\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
-**/\r
-#define PAL_SHUTDOWN 45\r
-\r
-/**\r
-\r
- Layout of PAL_MEMORY_BUFFER.ControlWord\r
-\r
-**/\r
-typedef struct {\r
- UINT64 Registration:1;\r
- UINT64 ProbeInterrupt:1;\r
- UINT64 Reserved:62;\r
-} PAL_MEMORY_CONTROL_WORD;\r
-\r
-/**\r
- PAL Procedure - PAL_MEMORY_BUFFER.\r
-\r
- Provides cacheable memory to PAL for exclusive use during\r
- runtime. It is optional by IPF. The PAL procedure supports the\r
- Static Registers calling convention. It could be called at\r
- physical mode.\r
-\r
- @param Index Index of PAL_MEMORY_BUFFER within the list of PAL\r
- procedures.\r
- @param BaseAddress Physical address of the memory buffer\r
- allocated for PAL use.\r
- @param AllocSize Unsigned integer denoting the size of the\r
- memory buffer.\r
- @param ControlWord Formatted bit vector that provides control\r
- options for this procedure. See\r
- PAL_MEMORY_CONTROL_WORD above.\r
-\r
- @retval 1 Call has not completed a buffer relocation\r
- due to a pending interrupt\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
- @return R9 Returns the minimum size of the memory buffer\r
- required if the alloc_size input argument was\r
- not large enough.\r
-\r
-**/\r
-#define PAL_MEMORY_BUFFER 277\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_VP_CREATE.\r
-\r
- Initializes a new vpd for the operation of a new virtual\r
- processor in the virtual environment. It is optional by IPF.\r
- The PAL procedure supports the Stacked Registers calling\r
- convention. It could be called at Virtual mode.\r
-\r
- @param Index Index of PAL_VP_CREATE within the list of PAL\r
- procedures.\r
- @param Vpd 64-bit host virtual pointer to the Virtual\r
- Processor Descriptor (VPD).\r
- @param HostIva 64-bit host virtual pointer to the host IVT\r
- for the virtual processor\r
- @param OptionalHandler 64-bit non-zero host-virtual pointer\r
- to an optional handler for\r
- virtualization intercepts.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
-**/\r
-#define PAL_VP_CREATE 265\r
-\r
-/**\r
-\r
- Virtual Environment Information Parameter\r
-\r
-**/\r
-typedef struct {\r
- UINT64 Reserved1:8;\r
- UINT64 Opcode:1;\r
- UINT64 Reserved:53;\r
-} PAL_VP_ENV_INFO_RETURN;\r
-\r
-/**\r
- PAL Procedure - PAL_VP_ENV_INFO.\r
-\r
- Returns the parameters needed to enter a virtual environment.\r
- It is optional by IPF. The PAL procedure supports the Stacked\r
- Registers calling convention. It could be called at Virtual\r
- mode.\r
-\r
- @param Index Index of PAL_VP_ENV_INFO within the list of PAL\r
- procedures.\r
- @param Vpd 64-bit host virtual pointer to the Virtual\r
- Processor Descriptor (VPD).\r
- @param HostIva 64-bit host virtual pointer to the host IVT\r
- for the virtual processor\r
- @param OptionalHandler 64-bit non-zero host-virtual pointer\r
- to an optional handler for\r
- virtualization intercepts.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
- @return R9 Unsigned integer denoting the number of bytes\r
- required by the PAL virtual environment buffer\r
- during PAL_VP_INIT_ENV\r
- @return R10 64-bit vector of virtual environment\r
- information. See PAL_VP_ENV_INFO_RETURN.\r
-\r
-\r
-**/\r
-#define PAL_VP_ENV_INFO 266\r
-\r
-/**\r
- PAL Procedure - PAL_VP_EXIT_ENV.\r
-\r
- Allows a logical processor to exit a virtual environment.\r
- It is optional by IPF. The PAL procedure supports the Stacked\r
- Registers calling convention. It could be called at Virtual\r
- mode.\r
-\r
- @param Index Index of PAL_VP_EXIT_ENV within the list of PAL\r
- procedures.\r
- @param Iva Optional 64-bit host virtual pointer to the IVT\r
- when this procedure is done\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
-**/\r
-#define PAL_VP_EXIT_ENV 267\r
-\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_VP_INIT_ENV.\r
-\r
- Allows a logical processor to enter a virtual environment. It\r
- is optional by IPF. The PAL procedure supports the Stacked\r
- Registers calling convention. It could be called at Virtual\r
- mode.\r
-\r
- @param Index Index of PAL_VP_INIT_ENV within the list of PAL\r
- procedures.\r
- @param ConfigOptions 64-bit vector of global configuration\r
- settings.\r
- @param PhysicalBase Host physical base address of a block of\r
- contiguous physical memory for the PAL\r
- virtual environment buffer 1) This\r
- memory area must be allocated by the VMM\r
- and be 4K aligned. The first logical\r
- processor to enter the environment will\r
- initialize the physical block for\r
- virtualization operations.\r
- @param VirtualBase Host virtual base address of the\r
- corresponding physical memory block for\r
- the PAL virtual environment buffer : The\r
- VMM must maintain the host virtual to host\r
- physical data and instruction translations\r
- in TRs for addresses within the allocated\r
- address space. Logical processors in this\r
- virtual environment will use this address\r
- when transitioning to virtual mode\r
- operations.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
- @return R9 Virtualization Service Address - VSA specifies\r
- the virtual base address of the PAL\r
- virtualization services in this virtual\r
- environment.\r
-\r
-\r
-**/\r
-#define PAL_VP_INIT_ENV 268\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_VP_REGISTER.\r
-\r
- Register a different host IVT and/or a different optional\r
- virtualization intercept handler for the virtual processor\r
- specified by vpd. It is optional by IPF. The PAL procedure\r
- supports the Stacked Registers calling convention. It could be\r
- called at Virtual mode.\r
-\r
- @param Index Index of PAL_VP_REGISTER within the list of PAL\r
- procedures.\r
- @param Vpd 64-bit host virtual pointer to the Virtual\r
- Processor Descriptor (VPD) host_iva 64-bit host\r
- virtual pointer to the host IVT for the virtual\r
- processor\r
- @param OptionalHandler 64-bit non-zero host-virtual pointer\r
- to an optional handler for\r
- virtualization intercepts.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
-**/\r
-#define PAL_VP_REGISTER 269\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_VP_RESTORE.\r
-\r
- Restores virtual processor state for the specified vpd on the\r
- logical processor. It is optional by IPF. The PAL procedure\r
- supports the Stacked Registers calling convention. It could be\r
- called at Virtual mode.\r
-\r
- @param Index Index of PAL_VP_RESTORE within the list of PAL\r
- procedures.\r
- @param Vpd 64-bit host virtual pointer to the Virtual\r
- Processor Descriptor (VPD) host_iva 64-bit host\r
- virtual pointer to the host IVT for the virtual\r
- processor\r
- @param PalVector Vector specifies PAL procedure\r
- implementation-specific state to be\r
- restored.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
-**/\r
-#define PAL_VP_RESTORE 270\r
-\r
-/**\r
- PAL Procedure - PAL_VP_SAVE.\r
-\r
- Saves virtual processor state for the specified vpd on the\r
- logical processor. It is optional by IPF. The PAL procedure\r
- supports the Stacked Registers calling convention. It could be\r
- called at Virtual mode.\r
-\r
- @param Index Index of PAL_VP_SAVE within the list of PAL\r
- procedures.\r
- @param Vpd 64-bit host virtual pointer to the Virtual\r
- Processor Descriptor (VPD) host_iva 64-bit host\r
- virtual pointer to the host IVT for the virtual\r
- processor\r
- @param PalVector Vector specifies PAL procedure\r
- implementation-specific state to be\r
- restored.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
-**/\r
-#define PAL_VP_SAVE 271\r
-\r
-\r
-/**\r
- PAL Procedure - PAL_VP_TERMINATE.\r
-\r
- Terminates operation for the specified virtual processor. It\r
- is optional by IPF. The PAL procedure supports the Stacked\r
- Registers calling convention. It could be called at Virtual\r
- mode.\r
-\r
- @param Index Index of PAL_VP_TERMINATE within the list of PAL\r
- procedures.\r
- @param Vpd 64-bit host virtual pointer to the Virtual\r
- Processor Descriptor (VPD)\r
- @param Iva Optional 64-bit host virtual pointer to the IVT\r
- when this procedure is done.\r
-\r
- @retval 0 Call completed without error\r
- @retval -1 Unimplemented procedure\r
- @retval -2 Invalid argument\r
- @retval -3 Call completed with error.\r
- @retval -9 Call requires PAL memory buffer.\r
-\r
-**/\r
-#define PAL_VP_TERMINATE 272\r
-\r
+#include <IndustryStandard/Pal.h>\r
\r
/**\r
Makes a PAL procedure call.\r