diff options
Diffstat (limited to 'src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi')
8 files changed, 162 insertions, 162 deletions
diff --git a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiDependency.h b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiDependency.h index da2cfee5f5..4f8e6b86c3 100644 --- a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiDependency.h +++ b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiDependency.h @@ -2,13 +2,13 @@ Present the dependency expression values in PI. Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR> - This program and the accompanying materials - are licensed and made available under the terms and conditions of the BSD License - which accompanies this distribution. The full text of the license may be found at - http://opensource.org/licenses/bsd-license.php + This program and the accompanying materials + are licensed and made available under the terms and conditions of the BSD License + which accompanies this distribution. The full text of the license may be found at + http://opensource.org/licenses/bsd-license.php - THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, - WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. + THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, + WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. @par Revision Reference: PI Version 1.0 @@ -17,16 +17,16 @@ #ifndef __PI_DEPENDENCY_H__ #define __PI_DEPENDENCY_H__ -/// +/// /// If present, this must be the first and only opcode, /// EFI_DEP_BEFORE may be used by DXE and SMM drivers. -/// +/// #define EFI_DEP_BEFORE 0x00 -/// +/// /// If present, this must be the first and only opcode, /// EFI_DEP_AFTER may be used by DXE and SMM drivers. -/// +/// #define EFI_DEP_AFTER 0x01 #define EFI_DEP_PUSH 0x02 @@ -38,10 +38,10 @@ #define EFI_DEP_END 0x08 -/// +/// /// If present, this must be the first opcode, /// EFI_DEP_SOR is only used by DXE driver. -/// +/// #define EFI_DEP_SOR 0x09 -#endif +#endif diff --git a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiDxeCis.h b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiDxeCis.h index 70a34af138..0c2c84f231 100644 --- a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiDxeCis.h +++ b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiDxeCis.h @@ -2,13 +2,13 @@ Include file matches things in PI. Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.<BR> -This program and the accompanying materials are licensed and made available under -the terms and conditions of the BSD License that accompanies this distribution. +This program and the accompanying materials are licensed and made available under +the terms and conditions of the BSD License that accompanies this distribution. The full text of the license may be found at -http://opensource.org/licenses/bsd-license.php. +http://opensource.org/licenses/bsd-license.php. -THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, -WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. +THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. @par Revision Reference: PI Version 1.6 @@ -49,8 +49,8 @@ typedef enum { /// EfiGcdMemoryTypeMemoryMappedIo, /// - /// A memory region that is visible to the boot processor. - /// This memory supports byte-addressable non-volatility. + /// A memory region that is visible to the boot processor. + /// This memory supports byte-addressable non-volatility. /// EfiGcdMemoryTypePersistent, // @@ -89,7 +89,7 @@ typedef enum { /// /// The type of allocation to perform. -/// +/// typedef enum { /// /// The GCD memory space map is searched from the lowest address up to the highest address @@ -97,22 +97,22 @@ typedef enum { /// EfiGcdAllocateAnySearchBottomUp, /// - /// The GCD memory space map is searched from the lowest address up + /// The GCD memory space map is searched from the lowest address up /// to the specified MaxAddress looking for unallocated memory ranges. /// EfiGcdAllocateMaxAddressSearchBottomUp, /// - /// The GCD memory space map is checked to see if the memory range starting + /// The GCD memory space map is checked to see if the memory range starting /// at the specified Address is available. /// EfiGcdAllocateAddress, /// - /// The GCD memory space map is searched from the highest address down to the lowest address + /// The GCD memory space map is searched from the highest address down to the lowest address /// looking for unallocated memory ranges. /// EfiGcdAllocateAnySearchTopDown, /// - /// The GCD memory space map is searched from the specified MaxAddress + /// The GCD memory space map is searched from the specified MaxAddress /// down to the lowest address looking for unallocated memory ranges. /// EfiGcdAllocateMaxAddressSearchTopDown, @@ -121,35 +121,35 @@ typedef enum { /// /// EFI_GCD_MEMORY_SPACE_DESCRIPTOR. -/// +/// typedef struct { /// /// The physical address of the first byte in the memory region. Type /// EFI_PHYSICAL_ADDRESS is defined in the AllocatePages() function /// description in the UEFI 2.0 specification. - /// + /// EFI_PHYSICAL_ADDRESS BaseAddress; /// /// The number of bytes in the memory region. - /// + /// UINT64 Length; /// /// The bit mask of attributes that the memory region is capable of supporting. The bit /// mask of available attributes is defined in the GetMemoryMap() function description /// in the UEFI 2.0 specification. - /// + /// UINT64 Capabilities; /// /// The bit mask of attributes that the memory region is currently using. The bit mask of /// available attributes is defined in GetMemoryMap(). - /// + /// UINT64 Attributes; /// /// Type of the memory region. Type EFI_GCD_MEMORY_TYPE is defined in the /// AddMemorySpace() function description. - /// + /// EFI_GCD_MEMORY_TYPE GcdMemoryType; /// @@ -157,7 +157,7 @@ typedef struct { /// PhysicalStart and NumberOfBytes. If this field is NULL, then the memory /// resource is not currently allocated. Type EFI_HANDLE is defined in /// InstallProtocolInterface() in the UEFI 2.0 specification. - /// + /// EFI_HANDLE ImageHandle; /// @@ -166,19 +166,19 @@ typedef struct { /// field is NULL, then the memory resource is not associated with a device that is /// described by a device handle. Type EFI_HANDLE is defined in /// InstallProtocolInterface() in the UEFI 2.0 specification. - /// + /// EFI_HANDLE DeviceHandle; } EFI_GCD_MEMORY_SPACE_DESCRIPTOR; /// /// EFI_GCD_IO_SPACE_DESCRIPTOR. -/// +/// typedef struct { /// /// Physical address of the first byte in the I/O region. Type /// EFI_PHYSICAL_ADDRESS is defined in the AllocatePages() function /// description in the UEFI 2.0 specification. - /// + /// EFI_PHYSICAL_ADDRESS BaseAddress; /// @@ -186,18 +186,18 @@ typedef struct { /// UINT64 Length; - /// + /// /// Type of the I/O region. Type EFI_GCD_IO_TYPE is defined in the /// AddIoSpace() function description. - /// + /// EFI_GCD_IO_TYPE GcdIoType; - /// + /// /// The image handle of the agent that allocated the I/O resource described by /// PhysicalStart and NumberOfBytes. If this field is NULL, then the I/O /// resource is not currently allocated. Type EFI_HANDLE is defined in /// InstallProtocolInterface() in the UEFI 2.0 specification. - /// + /// EFI_HANDLE ImageHandle; /// @@ -206,7 +206,7 @@ typedef struct { /// the I/O resource is not associated with a device that is described by a device handle. /// Type EFI_HANDLE is defined in InstallProtocolInterface() in the UEFI /// 2.0 specification. - /// + /// EFI_HANDLE DeviceHandle; } EFI_GCD_IO_SPACE_DESCRIPTOR; @@ -220,7 +220,7 @@ typedef struct { of the memory resource being added. @param Length The size, in bytes, of the memory resource that is being added. - @param Capabilities The bit mask of attributes that the memory + @param Capabilities The bit mask of attributes that the memory resource region supports. @retval EFI_SUCCESS The memory resource was added to the global @@ -228,13 +228,13 @@ typedef struct { @retval EFI_INVALID_PARAMETER GcdMemoryType is invalid. @retval EFI_INVALID_PARAMETER Length is zero. @retval EFI_OUT_OF_RESOURCES There are not enough system resources to add - the memory resource to the global coherency + the memory resource to the global coherency domain of the processor. @retval EFI_UNSUPPORTED The processor does not support one or more bytes - of the memory resource range specified by + of the memory resource range specified by BaseAddress and Length. @retval EFI_ACCESS_DENIED One or more bytes of the memory resource range - specified by BaseAddress and Length conflicts + specified by BaseAddress and Length conflicts with a memory resource range that was previously added to the global coherency domain of the processor. @retval EFI_ACCESS_DENIED One or more bytes of the memory resource range @@ -262,7 +262,7 @@ EFI_STATUS @param Length The size in bytes of the memory resource range that is being allocated. @param BaseAddress A pointer to a physical address to allocate. - @param Imagehandle The image handle of the agent that is allocating + @param Imagehandle The image handle of the agent that is allocating the memory resource. @param DeviceHandle The device handle for which the memory resource is being allocated. @@ -302,7 +302,7 @@ EFI_STATUS @retval EFI_SUCCESS The memory resource was freed from the global coherency domain of the processor. - @retval EFI_INVALID_PARAMETER Length is zero. + @retval EFI_INVALID_PARAMETER Length is zero. @retval EFI_UNSUPPORTED The processor does not support one or more bytes of the memory resource range specified by BaseAddress and Length. @retval EFI_NOT_FOUND The memory resource range specified by BaseAddress and @@ -327,7 +327,7 @@ EFI_STATUS @retval EFI_SUCCESS The memory resource was removed from the global coherency domain of the processor. - @retval EFI_INVALID_PARAMETER Length is zero. + @retval EFI_INVALID_PARAMETER Length is zero. @retval EFI_UNSUPPORTED The processor does not support one or more bytes of the memory resource range specified by BaseAddress and Length. @retval EFI_NOT_FOUND One or more bytes of the memory resource range specified by @@ -374,7 +374,7 @@ EFI_STATUS @param Attributes The bit mask of attributes to set for the memory region. @retval EFI_SUCCESS The attributes were set for the memory region. - @retval EFI_INVALID_PARAMETER Length is zero. + @retval EFI_INVALID_PARAMETER Length is zero. @retval EFI_UNSUPPORTED The processor does not support one or more bytes of the memory resource range specified by BaseAddress and Length. @retval EFI_UNSUPPORTED The bit mask of attributes is not support for the memory resource @@ -610,8 +610,8 @@ EFI_STATUS /** Loads and executed DXE drivers from firmware volumes. - The Dispatch() function searches for DXE drivers in firmware volumes that have been - installed since the last time the Dispatch() service was called. It then evaluates + The Dispatch() function searches for DXE drivers in firmware volumes that have been + installed since the last time the Dispatch() service was called. It then evaluates the dependency expressions of all the DXE drivers and loads and executes those DXE drivers whose dependency expression evaluate to TRUE. This service must interact with the Security Architectural Protocol to authenticate DXE drivers before they are executed. @@ -679,7 +679,7 @@ EFI_STATUS @retval EFI_VOLUME_CORRUPTED The firmware volume described by FirmwareVolumeHeader and Size is corrupted. @retval EFI_OUT_OF_RESOURCES There are not enough system resources available to produce the - EFI_FIRMWARE_VOLUME_PROTOCOL and EFI_DEVICE_PATH_PROTOCOL + EFI_FIRMWARE_VOLUME_PROTOCOL and EFI_DEVICE_PATH_PROTOCOL for the firmware volume described by FirmwareVolumeHeader and Size. **/ diff --git a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiI2c.h b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiI2c.h index 4aa55f5e3e..d7abd505b4 100644 --- a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiI2c.h +++ b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiI2c.h @@ -2,13 +2,13 @@ Include file matches things in PI. Copyright (c) 2013, Intel Corporation. All rights reserved.<BR> -This program and the accompanying materials are licensed and made available under -the terms and conditions of the BSD License that accompanies this distribution. +This program and the accompanying materials are licensed and made available under +the terms and conditions of the BSD License that accompanies this distribution. The full text of the license may be found at -http://opensource.org/licenses/bsd-license.php. +http://opensource.org/licenses/bsd-license.php. -THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, -WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. +THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. @par Revision Reference: PI Version 1.3 diff --git a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiMultiPhase.h b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiMultiPhase.h index 1669740484..08f1fcbdf9 100644 --- a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiMultiPhase.h +++ b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiMultiPhase.h @@ -2,13 +2,13 @@ Include file matches things in PI for multiple module types. Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR> -This program and the accompanying materials are licensed and made available under -the terms and conditions of the BSD License that accompanies this distribution. +This program and the accompanying materials are licensed and made available under +the terms and conditions of the BSD License that accompanies this distribution. The full text of the license may be found at -http://opensource.org/licenses/bsd-license.php. +http://opensource.org/licenses/bsd-license.php. -THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, -WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. +THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. @par Revision Reference: These elements are defined in UEFI Platform Initialization Specification 1.2. @@ -30,10 +30,10 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. 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 + The supported 32-bit range is 0xA0000000-0xBFFFFFFF + The supported 64-bit range is 0xA000000000000000-0xBFFFFFFFFFFFFFFF - @param StatusCode The status code value to convert into a warning code. + @param StatusCode The status code value to convert into a warning code. StatusCode must be in the range 0x00000000..0x1FFFFFFF. @return The value specified by StatusCode in the PI reserved range. @@ -47,7 +47,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. #define EFI_REQUEST_UNLOAD_IMAGE DXE_ERROR (1) /// -/// If this value is returned by an API, it means the capability is not yet +/// If this value is returned by an API, it means the capability is not yet /// installed/available/ready to use. /// #define EFI_NOT_AVAILABLE_YET DXE_ERROR (2) @@ -66,9 +66,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. /// #define PI_ENCODE_ERROR(a) (MAX_BIT | (MAX_BIT >> 2) | (a)) -/// +/// /// Return status codes defined in SMM CIS. -/// +/// #define EFI_INTERRUPT_PENDING PI_ENCODE_ERROR (0) #define EFI_WARN_INTERRUPT_SOURCE_PENDING PI_ENCODE_WARNING (0) @@ -76,7 +76,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. /// /// Bitmask of values for Authentication Status. -/// Authentication Status is returned from EFI_GUIDED_SECTION_EXTRACTION_PROTOCOL +/// Authentication Status is returned from EFI_GUIDED_SECTION_EXTRACTION_PROTOCOL /// and the EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI /// /// xx00 Image was not signed. @@ -123,7 +123,7 @@ typedef struct { /// Designates the address of the MMRAM, as seen by software executing on the /// processors. This address may or may not match PhysicalStart. /// - EFI_PHYSICAL_ADDRESS CpuStart; + EFI_PHYSICAL_ADDRESS CpuStart; /// /// Describes the number of bytes in the MMRAM region. /// diff --git a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiPeiCis.h b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiPeiCis.h index 1c72b10c01..8427675b43 100644 --- a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiPeiCis.h +++ b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiPeiCis.h @@ -2,14 +2,14 @@ PI PEI master include file. This file should match the PI spec. Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.<BR> -This program and the accompanying materials are licensed and made available under -the terms and conditions of the BSD License that accompanies this distribution. +This program and the accompanying materials are licensed and made available under +the terms and conditions of the BSD License that accompanies this distribution. The full text of the license may be found at -http://opensource.org/licenses/bsd-license.php. - +http://opensource.org/licenses/bsd-license.php. -THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, -WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. + +THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. @par Revision Reference: PI Version 1.6. @@ -24,22 +24,22 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. /// /// The handles of EFI FV. -/// +/// typedef VOID *EFI_PEI_FV_HANDLE; /// /// The handles of EFI FFS. -/// +/// typedef VOID *EFI_PEI_FILE_HANDLE; /// /// Declare the forward reference data structure for EFI_PEI_SERVICE. -/// +/// typedef struct _EFI_PEI_SERVICES EFI_PEI_SERVICES; /// /// Declare the forward reference data structure for EFI_PEI_NOTIFY_DESCRIPTOR. -/// +/// typedef struct _EFI_PEI_NOTIFY_DESCRIPTOR EFI_PEI_NOTIFY_DESCRIPTOR; @@ -48,8 +48,8 @@ typedef struct _EFI_PEI_NOTIFY_DESCRIPTOR EFI_PEI_NOTIFY_DESCRIPTOR; /** - The PEI Dispatcher will invoke each PEIM one time. During this pass, the PEI - Dispatcher will pass control to the PEIM at the AddressOfEntryPoint in the PE Header. + The PEI Dispatcher will invoke each PEIM one time. During this pass, the PEI + Dispatcher will pass control to the PEIM at the AddressOfEntryPoint in the PE Header. @param FileHandle Pointer to the FFS file header. @param PeiServices Describes the list of possible PEI Services. @@ -95,7 +95,7 @@ EFI_STATUS /// /// The data structure through which a PEIM describes available services to the PEI Foundation. -/// +/// typedef struct { /// /// This field is a set of flags describing the characteristics of this imported table entry. @@ -112,10 +112,10 @@ typedef struct { VOID *Ppi; } EFI_PEI_PPI_DESCRIPTOR; -/// -/// The data structure in a given PEIM that tells the PEI +/// +/// The data structure in a given PEIM that tells the PEI /// Foundation where to invoke the notification service. -/// +/// struct _EFI_PEI_NOTIFY_DESCRIPTOR { /// /// Details if the type of notification are callback or dispatch. @@ -147,9 +147,9 @@ typedef union { } EFI_PEI_DESCRIPTOR; /** - This service is the first one provided by the PEI Foundation. This function - installs an interface in the PEI PPI database by GUID. The purpose of the - service is to publish an interface that other parties can use to call + This service is the first one provided by the PEI Foundation. This function + installs an interface in the PEI PPI database by GUID. The purpose of the + service is to publish an interface that other parties can use to call additional PEIMs. @param PeiServices An indirect pointer to the EFI_PEI_SERVICES table @@ -157,8 +157,8 @@ typedef union { @param PpiList A pointer to the list of interfaces that the caller shall install. @retval EFI_SUCCESS The interface was successfully installed. - @retval EFI_INVALID_PARAMETER The PpiList pointer is NULL or Any of the PEI PPI - descriptors in the list do not have the + @retval EFI_INVALID_PARAMETER The PpiList pointer is NULL or Any of the PEI PPI + descriptors in the list do not have the EFI_PEI_PPI_DESCRIPTOR_PPI bit set in the Flags field. @retval EFI_OUT_OF_RESOURCES There is no additional space in the PPI database. @@ -171,10 +171,10 @@ EFI_STATUS ); /** - This function reinstalls an interface in the PEI PPI database by GUID. - The purpose of the service is to publish an interface that other parties - can use to replace a same-named interface in the protocol database - with a different interface. + This function reinstalls an interface in the PEI PPI database by GUID. + The purpose of the service is to publish an interface that other parties + can use to replace a same-named interface in the protocol database + with a different interface. @param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation. @@ -182,7 +182,7 @@ EFI_STATUS @param NewPpi A pointer to the new interfaces that the caller shall install. @retval EFI_SUCCESS The interface was successfully installed. - @retval EFI_INVALID_PARAMETER The PpiList pointer is NULL or Any of the PEI PPI descriptors in the + @retval EFI_INVALID_PARAMETER The PpiList pointer is NULL or Any of the PEI PPI descriptors in the list do not have the EFI_PEI_PPI_DESCRIPTOR_PPI bit set in the Flags field. @retval EFI_OUT_OF_RESOURCES There is no additional space in the PPI database. @retval EFI_NOT_FOUND The PPI for which the reinstallation was requested has not been installed. @@ -197,7 +197,7 @@ EFI_STATUS ); /** - This function locates an interface in the PEI PPI database by GUID. + This function locates an interface in the PEI PPI database by GUID. @param PeiServices An indirect pointer to the EFI_PEI_SERVICES published by the PEI Foundation. @param Guid A pointer to the GUID whose corresponding interface needs to be found. @@ -220,16 +220,16 @@ EFI_STATUS ); /** - This function installs a notification service to be called back when a - given interface is installed or reinstalled. The purpose of the service - is to publish an interface that other parties can use to call additional PPIs + This function installs a notification service to be called back when a + given interface is installed or reinstalled. The purpose of the service + is to publish an interface that other parties can use to call additional PPIs that may materialize later. @param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation @param NotifyList A pointer to the list of notification interfaces that the caller shall install. @retval EFI_SUCCESS The interface was successfully installed. - @retval EFI_INVALID_PARAMETER The PpiList pointer is NULL, or any of the PEI PPI descriptors in the + @retval EFI_INVALID_PARAMETER The PpiList pointer is NULL, or any of the PEI PPI descriptors in the list do not have the EFI_PEI_PPI_DESCRIPTOR_NOTIFY_TYPES bit set in the Flags field. @retval EFI_OUT_OF_RESOURCES There is no additional space in the PPI database. @@ -274,7 +274,7 @@ EFI_STATUS ); /** - This function returns the pointer to the list of Hand-Off Blocks (HOBs) in memory. + This function returns the pointer to the list of Hand-Off Blocks (HOBs) in memory. @param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation @param HobList A pointer to the list of HOBs that the PEI Foundation will initialize @@ -312,8 +312,8 @@ EFI_STATUS ); /** - The purpose of the service is to abstract the capability of the PEI - Foundation to discover instances of firmware volumes in the system. + The purpose of the service is to abstract the capability of the PEI + Foundation to discover instances of firmware volumes in the system. This service enables PEIMs to discover additional firmware volumes. The PEI Foundation uses this service to abstract the locations and formats of various firmware volumes. These volumes include @@ -449,7 +449,7 @@ EFI_STATUS ); /** - The purpose of the service is to publish an interface that allows + The purpose of the service is to publish an interface that allows PEIMs to allocate memory ranges that are managed by the PEI Foundation. Prior to InstallPeiMemory() being called, PEI will allocate pages from the heap. @@ -460,12 +460,12 @@ EFI_STATUS @param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation. @param MemoryType The type of memory to allocate. @param Pages The number of contiguous 4 KB pages to allocate. - @param Memory A pointer to a physical address. On output, the address is set to the base + @param Memory A pointer to a physical address. On output, the address is set to the base of the page range that was allocated. @retval EFI_SUCCESS The memory range was successfully allocated. @retval EFI_OUT_OF_RESOURCES The pages could not be allocated. - @retval EFI_INVALID_PARAMETER The type is not equal to EfiLoaderCode, EfiLoaderData, EfiRuntimeServicesCode, + @retval EFI_INVALID_PARAMETER The type is not equal to EfiLoaderCode, EfiLoaderData, EfiRuntimeServicesCode, EfiRuntimeServicesData, EfiBootServicesCode, EfiBootServicesData, EfiACPIReclaimMemory, EfiReservedMemoryType, or EfiACPIMemoryNVS. @@ -501,7 +501,7 @@ EFI_STATUS ); /** - The purpose of this service is to publish an interface that + The purpose of this service is to publish an interface that allows PEIMs to allocate memory ranges that are managed by the PEI Foundation. @param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation. @@ -597,7 +597,7 @@ EFI_STATUS This service resets the entire platform, including all processors and devices, and reboots the system. - This service will never return EFI_SUCCESS. + This service will never return EFI_SUCCESS. @param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation. @@ -739,7 +739,7 @@ typedef struct { @retval EFI_INVALID_PARAMETER FileHandle does not represent a valid file. @retval EFI_INVALID_PARAMETER FileInfo is NULL. - + **/ typedef EFI_STATUS @@ -839,7 +839,7 @@ EFI_STATUS @param FileHandle PEIM's file handle. Must be the currently executing PEIM. - + @retval EFI_SUCCESS The PEIM was successfully registered for shadowing. @retval EFI_ALREADY_STARTED The PEIM was previously @@ -861,8 +861,8 @@ EFI_STATUS #define PEI_SPECIFICATION_MAJOR_REVISION 1 #define PEI_SPECIFICATION_MINOR_REVISION 60 /// -/// Specification inconsistency here: -/// In the PI1.0 spec, PEI_SERVICES_SIGNATURE is defined as 0x5652455320494550. But +/// Specification inconsistency here: +/// In the PI1.0 spec, PEI_SERVICES_SIGNATURE is defined as 0x5652455320494550. But /// to pass a multiple tool chain, it appends an ULL. /// // @@ -870,14 +870,14 @@ EFI_STATUS // #define PEI_SERVICES_SIGNATURE 0x5652455320494550ULL /// -/// Specification inconsistency here: -/// In the PI1.0 specification, there is a typo error in PEI_SERVICES_REVISION. In the specification the defintion is +/// Specification inconsistency here: +/// In the PI1.0 specification, there is a typo error in PEI_SERVICES_REVISION. In the specification the defintion is /// #define ((PEI_SPECIFICATION_MAJOR_REVISION<<16) |(PEI_SPECIFICATION_MINOR_REVISION)) /// and it should be as follows: /// #define PEI_SERVICES_REVISION ((PEI_SPECIFICATION_MAJOR_REVISION<<16) | (PEI_SPECIFICATION_MINOR_REVISION)) -/// +/// /// EFI_PEI_SERVICES is a collection of functions whose implementation is provided by the PEI /// Foundation. These services fall into various classes, including the following: /// - Managing the boot mode @@ -963,63 +963,63 @@ struct _EFI_PEI_SERVICES { /// EFI_SEC_PEI_HAND_OFF structure holds information about /// PEI core's operating environment, such as the size of location of /// temporary RAM, the stack location and BFV location. -/// +/// typedef struct _EFI_SEC_PEI_HAND_OFF { /// /// Size of the data structure. - /// + /// UINT16 DataSize; /// - /// Points to the first byte of the boot firmware volume, - /// which the PEI Dispatcher should search for + /// Points to the first byte of the boot firmware volume, + /// which the PEI Dispatcher should search for /// PEI modules. - /// + /// VOID *BootFirmwareVolumeBase; /// /// Size of the boot firmware volume, in bytes. - /// + /// UINTN BootFirmwareVolumeSize; /// /// Points to the first byte of the temporary RAM. - /// + /// VOID *TemporaryRamBase; /// /// Size of the temporary RAM, in bytes. - /// + /// UINTN TemporaryRamSize; /// - /// Points to the first byte of the temporary RAM - /// available for use by the PEI Foundation. The area - /// described by PeiTemporaryRamBase and PeiTemporaryRamSize + /// Points to the first byte of the temporary RAM + /// available for use by the PEI Foundation. The area + /// described by PeiTemporaryRamBase and PeiTemporaryRamSize /// must not extend outside beyond the area described by /// TemporaryRamBase & TemporaryRamSize. This area should not - /// overlap with the area reported by StackBase and + /// overlap with the area reported by StackBase and /// StackSize. /// VOID *PeiTemporaryRamBase; /// - /// The size of the available temporary RAM available for + /// The size of the available temporary RAM available for /// use by the PEI Foundation, in bytes. - /// + /// UINTN PeiTemporaryRamSize; /// - /// Points to the first byte of the stack. - /// This are may be part of the memory described by - /// TemporaryRamBase and TemporaryRamSize + /// Points to the first byte of the stack. + /// This are may be part of the memory described by + /// TemporaryRamBase and TemporaryRamSize /// or may be an entirely separate area. - /// + /// VOID *StackBase; /// /// Size of the stack, in bytes. - /// + /// UINTN StackSize; } EFI_SEC_PEI_HAND_OFF; diff --git a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiS3BootScript.h b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiS3BootScript.h index 466f084ee0..e4ce6880ac 100644 --- a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiS3BootScript.h +++ b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiS3BootScript.h @@ -1,5 +1,5 @@ /** @file - This file contains the boot script defintions that are shared between the + This file contains the boot script defintions that are shared between the Boot Script Executor PPI and the Boot Script Save Protocol. Copyright (c) 2009, Intel Corporation. All rights reserved.<BR> diff --git a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiSmmCis.h b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiSmmCis.h index eb9f13f13e..087ec4d60e 100644 --- a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiSmmCis.h +++ b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiSmmCis.h @@ -69,24 +69,24 @@ typedef EFI_MM_INTERRUPT_UNREGISTER EFI_SMM_INTERRUPT_UNREGISTER; typedef struct _EFI_SMM_ENTRY_CONTEXT { EFI_SMM_STARTUP_THIS_AP SmmStartupThisAp; /// - /// A number between zero and the NumberOfCpus field. This field designates which + /// A number between zero and the NumberOfCpus field. This field designates which /// processor is executing the SMM Foundation. /// UINTN CurrentlyExecutingCpu; /// - /// The number of possible processors in the platform. This is a 1 based + /// The number of possible processors in the platform. This is a 1 based /// counter. This does not indicate the number of processors that entered SMM. /// UINTN NumberOfCpus; /// - /// Points to an array, where each element describes the number of bytes in the - /// corresponding save state specified by CpuSaveState. There are always - /// NumberOfCpus entries in the array. + /// Points to an array, where each element describes the number of bytes in the + /// corresponding save state specified by CpuSaveState. There are always + /// NumberOfCpus entries in the array. /// UINTN *CpuSaveStateSize; /// - /// Points to an array, where each element is a pointer to a CPU save state. The - /// corresponding element in CpuSaveStateSize specifies the number of bytes in the + /// Points to an array, where each element is a pointer to a CPU save state. The + /// corresponding element in CpuSaveStateSize specifies the number of bytes in the /// save state area. There are always NumberOfCpus entries in the array. /// VOID **CpuSaveState; @@ -106,8 +106,8 @@ VOID /// /// System Management System Table (SMST) /// -/// The System Management System Table (SMST) is a table that contains a collection of common -/// services for managing SMRAM allocation and providing basic I/O services. These services are +/// The System Management System Table (SMST) is a table that contains a collection of common +/// services for managing SMRAM allocation and providing basic I/O services. These services are /// intended for both preboot and runtime usage. /// struct _EFI_SMM_SYSTEM_TABLE2 { @@ -150,7 +150,7 @@ struct _EFI_SMM_SYSTEM_TABLE2 { /// /// - /// A number between zero and and the NumberOfCpus field. This field designates + /// A number between zero and and the NumberOfCpus field. This field designates /// which processor is executing the SMM infrastructure. /// UINTN CurrentlyExecutingCpu; @@ -159,14 +159,14 @@ struct _EFI_SMM_SYSTEM_TABLE2 { /// UINTN NumberOfCpus; /// - /// Points to an array, where each element describes the number of bytes in the - /// corresponding save state specified by CpuSaveState. There are always - /// NumberOfCpus entries in the array. + /// Points to an array, where each element describes the number of bytes in the + /// corresponding save state specified by CpuSaveState. There are always + /// NumberOfCpus entries in the array. /// UINTN *CpuSaveStateSize; /// - /// Points to an array, where each element is a pointer to a CPU save state. The - /// corresponding element in CpuSaveStateSize specifies the number of bytes in the + /// Points to an array, where each element is a pointer to a CPU save state. The + /// corresponding element in CpuSaveStateSize specifies the number of bytes in the /// save state area. There are always NumberOfCpus entries in the array. /// VOID **CpuSaveState; @@ -180,8 +180,8 @@ struct _EFI_SMM_SYSTEM_TABLE2 { /// UINTN NumberOfTableEntries; /// - /// A pointer to the UEFI Configuration Tables. The number of entries in the table is - /// NumberOfTableEntries. + /// A pointer to the UEFI Configuration Tables. The number of entries in the table is + /// NumberOfTableEntries. /// EFI_CONFIGURATION_TABLE *SmmConfigurationTable; diff --git a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiStatusCode.h b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiStatusCode.h index 7eebb34518..e555caf08f 100644 --- a/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiStatusCode.h +++ b/src/vendorcode/intel/edk2/UDK2017/MdePkg/Include/Pi/PiStatusCode.h @@ -2,16 +2,16 @@ StatusCode related definitions in PI. Copyright (c) 2009 - 2017, Intel Corporation. All rights reserved.<BR> -This program and the accompanying materials are licensed and made available under -the terms and conditions of the BSD License that accompanies this distribution. +This program and the accompanying materials are licensed and made available under +the terms and conditions of the BSD License that accompanies this distribution. The full text of the license may be found at -http://opensource.org/licenses/bsd-license.php. +http://opensource.org/licenses/bsd-license.php. -THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, -WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. +THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. @par Revision Reference: - These status codes are defined in UEFI Platform Initialization Specification 1.2, + These status codes are defined in UEFI Platform Initialization Specification 1.2, Volume 3: Shared Architectural Elements. **/ @@ -133,7 +133,7 @@ typedef struct { #define EFI_SOFTWARE 0x03000000 ///@} -/// +/// /// Computing Unit Subclass definitions. /// Values of 8-127 are reserved for future use by this specification. /// Values of 128-255 are reserved for OEM use. @@ -1187,9 +1187,9 @@ typedef struct { /// definitions in the EFI specification. /// ///@{ -#define EFI_SW_EC_ARM_RESET EXCEPT_ARM_RESET -#define EFI_SW_EC_ARM_UNDEFINED_INSTRUCTION EXCEPT_ARM_UNDEFINED_INSTRUCTION -#define EFI_SW_EC_ARM_SOFTWARE_INTERRUPT EXCEPT_ARM_SOFTWARE_INTERRUPT +#define EFI_SW_EC_ARM_RESET EXCEPT_ARM_RESET +#define EFI_SW_EC_ARM_UNDEFINED_INSTRUCTION EXCEPT_ARM_UNDEFINED_INSTRUCTION +#define EFI_SW_EC_ARM_SOFTWARE_INTERRUPT EXCEPT_ARM_SOFTWARE_INTERRUPT #define EFI_SW_EC_ARM_PREFETCH_ABORT EXCEPT_ARM_PREFETCH_ABORT #define EFI_SW_EC_ARM_DATA_ABORT EXCEPT_ARM_DATA_ABORT #define EFI_SW_EC_ARM_RESERVED EXCEPT_ARM_RESERVED |