mirror of
https://github.com/acidanthera/audk.git
synced 2025-04-08 17:05:09 +02:00
28889a7898
REF: https://github.com/tianocore/tianocore.github.io/wiki/ UEFI-Capsule-on-Disk-Introducation CoDCheckCapsuleOnDiskFlag() is to check if CapsuleOnDisk flag in "OsIndications" Variable is enabled. It is used to indicate whether capsule on disk is provisioned in normal boot path. CoDClearCapsuleOnDiskFlag() is to to clear CapsuleOnDisk flags, including "OsIndications" and "BootNext" variable. CoDRelocateCapsule() is to relocate the capsules from EFI system partition. Depends on PcdCapsuleInRamSupport, there are two solutions to relocate the capsule on disk images: When Capsule In Ram is supported, the Capsule On Disk images are relocated into memory, and call UpdateCapsule() service to deliver the capsules. When Capsule In Ram is not supported, the Capsule On Disk images are relocated into a temp file which will be stored in root directory on a platform specific storage device. CapsuleOnDiskLoadPei PEIM will retrieve the capsules from the relocation temp file and report capsule hobs for them. CoDRemoveTempFile() is to remove the relocation temp file in the next boot after capsules are processed. Cc: Jian J Wang <jian.j.wang@intel.com> Cc: Hao A Wu <hao.a.wu@intel.com> Cc: Chao B Zhang <chao.b.zhang@intel.com> Signed-off-by: Wei6 Xu <wei6.xu@intel.com> Reviewed-by: Chao B Zhang <chao.b.zhang@intel.com> Acked-by: Hao A Wu <hao.a.wu@intel.com>
76 lines
2.3 KiB
C
76 lines
2.3 KiB
C
/** @file
|
|
Defines several datastructures used by Capsule On Disk feature.
|
|
They are mainly used for FAT files.
|
|
|
|
Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef _CAPSULES_ON_DISK_H_
|
|
#define _CAPSULES_ON_DISK_H_
|
|
|
|
#include <Uefi.h>
|
|
#include <Pi/PiMultiPhase.h>
|
|
|
|
#include <Library/UefiLib.h>
|
|
#include <Library/DebugLib.h>
|
|
#include <Library/BaseLib.h>
|
|
#include <Library/UefiBootServicesTableLib.h>
|
|
#include <Library/UefiRuntimeServicesTableLib.h>
|
|
#include <Library/UefiRuntimeLib.h>
|
|
#include <Library/BaseMemoryLib.h>
|
|
#include <Library/MemoryAllocationLib.h>
|
|
#include <Library/FileHandleLib.h>
|
|
#include <Library/CapsuleLib.h>
|
|
#include <Library/DevicePathLib.h>
|
|
#include <Library/PrintLib.h>
|
|
#include <Library/UefiBootManagerLib.h>
|
|
|
|
#include <Protocol/SimpleFileSystem.h>
|
|
#include <Protocol/DiskIo.h>
|
|
#include <Protocol/BlockIo.h>
|
|
|
|
#include <Guid/CapsuleVendor.h>
|
|
#include <Guid/FileInfo.h>
|
|
#include <Guid/GlobalVariable.h>
|
|
|
|
//
|
|
// This data structure is the part of FILE_INFO_ENTRY
|
|
//
|
|
#define FILE_INFO_SIGNATURE SIGNATURE_32 ('F', 'L', 'I', 'F')
|
|
|
|
//
|
|
// LoadOptionNumber of the boot option where the capsules is relocated.
|
|
//
|
|
#define COD_RELOCATION_LOAD_OPTION_VAR_NAME L"CodRelocationLoadOption"
|
|
|
|
//
|
|
// (20 * (6+5+2))+1) unicode characters from EFI FAT spec (doubled for bytes)
|
|
//
|
|
#define MAX_FILE_NAME_SIZE 522
|
|
#define MAX_FILE_NAME_LEN (MAX_FILE_NAME_SIZE / sizeof(CHAR16))
|
|
#define MAX_FILE_INFO_LEN (OFFSET_OF(EFI_FILE_INFO, FileName) + MAX_FILE_NAME_LEN)
|
|
|
|
typedef struct {
|
|
UINTN Signature;
|
|
LIST_ENTRY Link; /// Linked list members.
|
|
EFI_FILE_INFO *FileInfo; /// Pointer to the FileInfo struct for this file or NULL.
|
|
CHAR16 *FileNameFirstPart; /// Text to the left of right-most period in the file name. String is capitialized
|
|
CHAR16 *FileNameSecondPart; /// Text to the right of right-most period in the file name.String is capitialized. Maybe NULL
|
|
} FILE_INFO_ENTRY;
|
|
|
|
typedef struct {
|
|
//
|
|
// image address.
|
|
//
|
|
VOID *ImageAddress;
|
|
//
|
|
// The file info of the image comes from.
|
|
// if FileInfo == NULL. means image does not come from file
|
|
//
|
|
EFI_FILE_INFO *FileInfo;
|
|
} IMAGE_INFO;
|
|
|
|
#endif // _CAPSULES_ON_DISK_H_
|