iPXE
Data Structures | Macros | Typedefs | Enumerations | Functions
PiMultiPhase.h File Reference

Include file matches things in PI for multiple module types. More...

#include <ipxe/efi/Pi/PiFirmwareVolume.h>
#include <ipxe/efi/Pi/PiFirmwareFile.h>
#include <ipxe/efi/Pi/PiBootMode.h>
#include <ipxe/efi/Pi/PiHob.h>
#include <ipxe/efi/Pi/PiDependency.h>
#include <ipxe/efi/Pi/PiStatusCode.h>
#include <ipxe/efi/Pi/PiS3BootScript.h>

Go to the source code of this file.

Data Structures

struct  EFI_MMRAM_DESCRIPTOR
 Structure describing a MMRAM region and its accessibility attributes. More...
 
struct  _EFI_MM_RESERVED_MMRAM_REGION
 Structure describing a MMRAM region which cannot be used for the MMRAM heap. More...
 
struct  EFI_PCD_INFO
 

Macros

#define DXE_ERROR(StatusCode)   (MAX_BIT | (MAX_BIT >> 2) | StatusCode)
 Produces an error code in the range reserved for use by the Platform Initialization Architecture Specification. More...
 
#define EFI_REQUEST_UNLOAD_IMAGE   DXE_ERROR (1)
 If this value is returned by an EFI image, then the image should be unloaded. More...
 
#define EFI_NOT_AVAILABLE_YET   DXE_ERROR (2)
 If this value is returned by an API, it means the capability is not yet installed/available/ready to use. More...
 
#define PI_ENCODE_WARNING(a)   ((MAX_BIT >> 2) | (a))
 Success and warning codes reserved for use by PI. More...
 
#define PI_ENCODE_ERROR(a)   (MAX_BIT | (MAX_BIT >> 2) | (a))
 Error codes reserved for use by PI. More...
 
#define EFI_INTERRUPT_PENDING   PI_ENCODE_ERROR (0)
 Return status codes defined in SMM CIS. More...
 
#define EFI_WARN_INTERRUPT_SOURCE_PENDING   PI_ENCODE_WARNING (0)
 
#define EFI_WARN_INTERRUPT_SOURCE_QUIESCED   PI_ENCODE_WARNING (1)
 
#define EFI_MMRAM_OPEN   0x00000001
 MMRAM states and capabilities. More...
 
#define EFI_MMRAM_CLOSED   0x00000002
 
#define EFI_MMRAM_LOCKED   0x00000004
 
#define EFI_CACHEABLE   0x00000008
 
#define EFI_ALLOCATED   0x00000010
 
#define EFI_NEEDS_TESTING   0x00000020
 
#define EFI_NEEDS_ECC_INITIALIZATION   0x00000040
 
#define EFI_SMRAM_OPEN   EFI_MMRAM_OPEN
 
#define EFI_SMRAM_CLOSED   EFI_MMRAM_CLOSED
 
#define EFI_SMRAM_LOCKED   EFI_MMRAM_LOCKED
 
#define EFI_AUTH_STATUS_PLATFORM_OVERRIDE   0x01
 Bitmask of values for Authentication Status. More...
 
#define EFI_AUTH_STATUS_IMAGE_SIGNED   0x02
 Bitmask of values for Authentication Status. More...
 
#define EFI_AUTH_STATUS_NOT_TESTED   0x04
 Bitmask of values for Authentication Status. More...
 
#define EFI_AUTH_STATUS_TEST_FAILED   0x08
 Bitmask of values for Authentication Status. More...
 
#define EFI_AUTH_STATUS_ALL   0x0f
 Bitmask of values for Authentication Status. More...
 

Typedefs

typedef EFI_MMRAM_DESCRIPTOR EFI_SMRAM_DESCRIPTOR
 
typedef struct _EFI_MM_RESERVED_MMRAM_REGION EFI_MM_RESERVED_MMRAM_REGION
 Structure describing a MMRAM region which cannot be used for the MMRAM heap. More...
 
typedef VOID(EFIAPIEFI_AP_PROCEDURE) (IN OUT VOID *Buffer)
 The function prototype for invoking a function on an Application Processor. More...
 
typedef EFI_STATUS(EFIAPIEFI_AP_PROCEDURE2) (IN VOID *ProcedureArgument)
 The function prototype for invoking a function on an Application Processor. More...
 

Enumerations

enum  EFI_PCD_TYPE {
  EFI_PCD_TYPE_8, EFI_PCD_TYPE_16, EFI_PCD_TYPE_32, EFI_PCD_TYPE_64,
  EFI_PCD_TYPE_BOOL, EFI_PCD_TYPE_PTR
}
 

Functions

 FILE_LICENCE (BSD2_PATENT)
 

Detailed Description

Include file matches things in PI for multiple module types.

Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Revision Reference:
These elements are defined in UEFI Platform Initialization Specification 1.2.

Definition in file PiMultiPhase.h.

Macro Definition Documentation

◆ DXE_ERROR

#define DXE_ERROR (   StatusCode)    (MAX_BIT | (MAX_BIT >> 2) | StatusCode)

Produces an error code in the range reserved for use by the Platform Initialization Architecture Specification.

The supported 32-bit range is 0xA0000000-0xBFFFFFFF The supported 64-bit range is 0xA000000000000000-0xBFFFFFFFFFFFFFFF

Parameters
StatusCodeThe status code value to convert into a warning code. StatusCode must be in the range 0x00000000..0x1FFFFFFF.
Returns
The value specified by StatusCode in the PI reserved range.

Definition at line 38 of file PiMultiPhase.h.

◆ EFI_REQUEST_UNLOAD_IMAGE

#define EFI_REQUEST_UNLOAD_IMAGE   DXE_ERROR (1)

If this value is returned by an EFI image, then the image should be unloaded.

Definition at line 43 of file PiMultiPhase.h.

◆ EFI_NOT_AVAILABLE_YET

#define EFI_NOT_AVAILABLE_YET   DXE_ERROR (2)

If this value is returned by an API, it means the capability is not yet installed/available/ready to use.

Definition at line 49 of file PiMultiPhase.h.

◆ PI_ENCODE_WARNING

#define PI_ENCODE_WARNING (   a)    ((MAX_BIT >> 2) | (a))

Success and warning codes reserved for use by PI.

Supported 32-bit range is 0x20000000-0x3fffffff. Supported 64-bit range is 0x2000000000000000-0x3fffffffffffffff.

Definition at line 56 of file PiMultiPhase.h.

◆ PI_ENCODE_ERROR

#define PI_ENCODE_ERROR (   a)    (MAX_BIT | (MAX_BIT >> 2) | (a))

Error codes reserved for use by PI.

Supported 32-bit range is 0xa0000000-0xbfffffff. Supported 64-bit range is 0xa000000000000000-0xbfffffffffffffff.

Definition at line 63 of file PiMultiPhase.h.

◆ EFI_INTERRUPT_PENDING

#define EFI_INTERRUPT_PENDING   PI_ENCODE_ERROR (0)

Return status codes defined in SMM CIS.

Definition at line 68 of file PiMultiPhase.h.

◆ EFI_WARN_INTERRUPT_SOURCE_PENDING

#define EFI_WARN_INTERRUPT_SOURCE_PENDING   PI_ENCODE_WARNING (0)

Definition at line 70 of file PiMultiPhase.h.

◆ EFI_WARN_INTERRUPT_SOURCE_QUIESCED

#define EFI_WARN_INTERRUPT_SOURCE_QUIESCED   PI_ENCODE_WARNING (1)

Definition at line 71 of file PiMultiPhase.h.

◆ EFI_AUTH_STATUS_PLATFORM_OVERRIDE

#define EFI_AUTH_STATUS_PLATFORM_OVERRIDE   0x01

Bitmask of values for Authentication Status.

Authentication Status is returned from EFI_GUIDED_SECTION_EXTRACTION_PROTOCOL and the EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI

xx00 Image was not signed. xxx1 Platform security policy override. Assumes the same meaning as 0010 (the image was signed, the signature was tested, and the signature passed authentication test). 0010 Image was signed, the signature was tested, and the signature passed authentication test. 0110 Image was signed and the signature was not tested. 1010 Image was signed, the signature was tested, and the signature failed the authentication test.

Definition at line 86 of file PiMultiPhase.h.

◆ EFI_AUTH_STATUS_IMAGE_SIGNED

#define EFI_AUTH_STATUS_IMAGE_SIGNED   0x02

Bitmask of values for Authentication Status.

Authentication Status is returned from EFI_GUIDED_SECTION_EXTRACTION_PROTOCOL and the EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI

xx00 Image was not signed. xxx1 Platform security policy override. Assumes the same meaning as 0010 (the image was signed, the signature was tested, and the signature passed authentication test). 0010 Image was signed, the signature was tested, and the signature passed authentication test. 0110 Image was signed and the signature was not tested. 1010 Image was signed, the signature was tested, and the signature failed the authentication test.

Definition at line 87 of file PiMultiPhase.h.

◆ EFI_AUTH_STATUS_NOT_TESTED

#define EFI_AUTH_STATUS_NOT_TESTED   0x04

Bitmask of values for Authentication Status.

Authentication Status is returned from EFI_GUIDED_SECTION_EXTRACTION_PROTOCOL and the EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI

xx00 Image was not signed. xxx1 Platform security policy override. Assumes the same meaning as 0010 (the image was signed, the signature was tested, and the signature passed authentication test). 0010 Image was signed, the signature was tested, and the signature passed authentication test. 0110 Image was signed and the signature was not tested. 1010 Image was signed, the signature was tested, and the signature failed the authentication test.

Definition at line 88 of file PiMultiPhase.h.

◆ EFI_AUTH_STATUS_TEST_FAILED

#define EFI_AUTH_STATUS_TEST_FAILED   0x08

Bitmask of values for Authentication Status.

Authentication Status is returned from EFI_GUIDED_SECTION_EXTRACTION_PROTOCOL and the EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI

xx00 Image was not signed. xxx1 Platform security policy override. Assumes the same meaning as 0010 (the image was signed, the signature was tested, and the signature passed authentication test). 0010 Image was signed, the signature was tested, and the signature passed authentication test. 0110 Image was signed and the signature was not tested. 1010 Image was signed, the signature was tested, and the signature failed the authentication test.

Definition at line 89 of file PiMultiPhase.h.

◆ EFI_AUTH_STATUS_ALL

#define EFI_AUTH_STATUS_ALL   0x0f

Bitmask of values for Authentication Status.

Authentication Status is returned from EFI_GUIDED_SECTION_EXTRACTION_PROTOCOL and the EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI

xx00 Image was not signed. xxx1 Platform security policy override. Assumes the same meaning as 0010 (the image was signed, the signature was tested, and the signature passed authentication test). 0010 Image was signed, the signature was tested, and the signature passed authentication test. 0110 Image was signed and the signature was not tested. 1010 Image was signed, the signature was tested, and the signature failed the authentication test.

Definition at line 90 of file PiMultiPhase.h.

◆ EFI_MMRAM_OPEN

#define EFI_MMRAM_OPEN   0x00000001

MMRAM states and capabilities.

Definition at line 96 of file PiMultiPhase.h.

◆ EFI_MMRAM_CLOSED

#define EFI_MMRAM_CLOSED   0x00000002

Definition at line 97 of file PiMultiPhase.h.

◆ EFI_MMRAM_LOCKED

#define EFI_MMRAM_LOCKED   0x00000004

Definition at line 98 of file PiMultiPhase.h.

◆ EFI_CACHEABLE

#define EFI_CACHEABLE   0x00000008

Definition at line 99 of file PiMultiPhase.h.

◆ EFI_ALLOCATED

#define EFI_ALLOCATED   0x00000010

Definition at line 100 of file PiMultiPhase.h.

◆ EFI_NEEDS_TESTING

#define EFI_NEEDS_TESTING   0x00000020

Definition at line 101 of file PiMultiPhase.h.

◆ EFI_NEEDS_ECC_INITIALIZATION

#define EFI_NEEDS_ECC_INITIALIZATION   0x00000040

Definition at line 102 of file PiMultiPhase.h.

◆ EFI_SMRAM_OPEN

#define EFI_SMRAM_OPEN   EFI_MMRAM_OPEN

Definition at line 104 of file PiMultiPhase.h.

◆ EFI_SMRAM_CLOSED

#define EFI_SMRAM_CLOSED   EFI_MMRAM_CLOSED

Definition at line 105 of file PiMultiPhase.h.

◆ EFI_SMRAM_LOCKED

#define EFI_SMRAM_LOCKED   EFI_MMRAM_LOCKED

Definition at line 106 of file PiMultiPhase.h.

Typedef Documentation

◆ EFI_SMRAM_DESCRIPTOR

Definition at line 136 of file PiMultiPhase.h.

◆ EFI_MM_RESERVED_MMRAM_REGION

Structure describing a MMRAM region which cannot be used for the MMRAM heap.

◆ EFI_AP_PROCEDURE

typedef VOID(EFIAPI * EFI_AP_PROCEDURE) (IN OUT VOID *Buffer)

The function prototype for invoking a function on an Application Processor.

This definition is used by the UEFI MP Serices Protocol, and the PI SMM System Table.

Parameters
[in,out]BufferThe pointer to private data buffer.

Definition at line 193 of file PiMultiPhase.h.

◆ EFI_AP_PROCEDURE2

typedef EFI_STATUS(EFIAPI * EFI_AP_PROCEDURE2) (IN VOID *ProcedureArgument)

The function prototype for invoking a function on an Application Processor.

This definition is used by the UEFI MM MP Serices Protocol.

Parameters
[in]ProcedureArgumentThe pointer to private data buffer.
Return values
EFI_SUCCESSExcutive the procedure successfully

Definition at line 209 of file PiMultiPhase.h.

Enumeration Type Documentation

◆ EFI_PCD_TYPE

Enumerator
EFI_PCD_TYPE_8 
EFI_PCD_TYPE_16 
EFI_PCD_TYPE_32 
EFI_PCD_TYPE_64 
EFI_PCD_TYPE_BOOL 
EFI_PCD_TYPE_PTR 

Definition at line 154 of file PiMultiPhase.h.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( BSD2_PATENT  )