You've already forked slimbootloader
mirror of
https://github.com/Dasharo/slimbootloader.git
synced 2026-03-06 15:26:20 -08:00
Mike Crowe
990e3e81e6
Convert the line endings stored for all text files in the repository to LF. The majority previously used DOS-style CRLF line endings. Add a .gitattributes file to enforce this and treat certain extensions as never being text files. Update PatchCheck.py to insist on LF line endings rather than CRLF. However, its other checks fail on this commit due to lots of pre-existing complaints that it only notices because the line endings have changed. Silicon/QemuSocPkg/FspBin/Patches/0001-Build-QEMU-FSP-2.0-binaries.patch needs to be treated as binary since it contains a mixture of line endings. This change has implications depending on the client platform you are using the repository from: * Windows The usual configuration for Git on Windows means that text files will be checked out to the work tree with DOS-style CRLF line endings. If that's not the case then you can configure Git to do so for the entire machine with: git config --global core.autocrlf true or for just the repository with: git config core.autocrlf true Line endings will be normalised to LF when they are committed to the repository. If you commit a text file with only LF line endings then it will be converted to CRLF line endings in your work tree. * Linux, MacOS and other Unices The usual configuration for Git on such platforms is to check files out of the repository with LF line endings. This is probably the right thing for you. In the unlikely even that you are using Git on Unix but editing or compiling on Windows for some reason then you may need to tweak your configuration to force the use of CRLF line endings as described above. * General For more information see https://docs.github.com/en/get-started/getting-started-with-git/configuring-git-to-handle-line-endings . Fixes: https://github.com/slimbootloader/slimbootloader/issues/1400 Signed-off-by: Mike Crowe <mac@mcrowe.com>
506 lines
15 KiB
C
506 lines
15 KiB
C
/** @file
|
|
File system level API library interface
|
|
|
|
Copyright (c) 2017 - 2020, Intel Corporation. All rights reserved.<BR>
|
|
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
#include <PiPei.h>
|
|
#include <Library/BaseMemoryLib.h>
|
|
#include <Library/DebugLib.h>
|
|
#include <Library/FileSystemLib.h>
|
|
#include <Library/PcdLib.h>
|
|
#include <Library/MemoryAllocationLib.h>
|
|
#include <Library/FatLib.h>
|
|
#include <Library/Ext23Lib.h>
|
|
|
|
#define FILE_SYSTEM_CB_SIGNATURE SIGNATURE_32( 'F', 'S', 'C', 'B' )
|
|
#define FILE_CB_SIGNATURE SIGNATURE_32( 'F', 'I', 'C', 'B' )
|
|
|
|
typedef struct {
|
|
UINTN Signature;
|
|
EFI_HANDLE FsHandle;
|
|
UINT32 SwPartNo;
|
|
LIST_ENTRY OpenFiles;
|
|
} FILE_SYSTEM_CONTROL_BLOCK;
|
|
|
|
typedef struct {
|
|
LIST_ENTRY Link;
|
|
UINTN Signature;
|
|
EFI_HANDLE FileHandle;
|
|
EFI_HANDLE FileSystemControlBlock;
|
|
} FILE_CONTROL_BLOCK;
|
|
|
|
STATIC BOOLEAN mFileSystemRegistered = FALSE;
|
|
STATIC FILE_SYSTEM_FUNC mFileSystemFuncs[EnumFileSystemTypeAuto];
|
|
|
|
STATIC
|
|
VOID
|
|
RegisterFileSystems (
|
|
VOID
|
|
)
|
|
{
|
|
OS_FILE_SYSTEM_TYPE FsType;
|
|
|
|
if (mFileSystemRegistered == FALSE) {
|
|
ZeroMem (&mFileSystemFuncs, sizeof (mFileSystemFuncs));
|
|
|
|
FsType = EnumFileSystemTypeFat;
|
|
if (FixedPcdGet32 (PcdSupportedFileSystemMask) & (1 << FsType)) {
|
|
mFileSystemFuncs[FsType].InitFileSystem = FatInitFileSystem;
|
|
mFileSystemFuncs[FsType].CloseFileSystem = FatCloseFileSystem;
|
|
mFileSystemFuncs[FsType].OpenFile = FatFsOpenFile;
|
|
mFileSystemFuncs[FsType].GetFileSize = FatFsGetFileSize;
|
|
mFileSystemFuncs[FsType].ReadFile = FatFsReadFile;
|
|
mFileSystemFuncs[FsType].CloseFile = FatFsCloseFile;
|
|
mFileSystemFuncs[FsType].ListDir = FatFsListDir;
|
|
}
|
|
|
|
FsType = EnumFileSystemTypeExt2;
|
|
if (FixedPcdGet32 (PcdSupportedFileSystemMask) & (1 << FsType)) {
|
|
mFileSystemFuncs[FsType].InitFileSystem = ExtInitFileSystem;
|
|
mFileSystemFuncs[FsType].CloseFileSystem = ExtCloseFileSystem;
|
|
mFileSystemFuncs[FsType].OpenFile = ExtFsOpenFile;
|
|
mFileSystemFuncs[FsType].GetFileSize = ExtFsGetFileSize;
|
|
mFileSystemFuncs[FsType].ReadFile = ExtFsReadFile;
|
|
mFileSystemFuncs[FsType].CloseFile = ExtFsCloseFile;
|
|
mFileSystemFuncs[FsType].ListDir = ExtFsListDir;
|
|
}
|
|
mFileSystemRegistered = TRUE;
|
|
}
|
|
}
|
|
|
|
/**
|
|
Get SW partition no. of detected file system
|
|
|
|
@param[in] FsHandle file system handle.
|
|
@param[out] SwPartNo sw part no.
|
|
|
|
@retval EFI_SUCCESS found sw part no.
|
|
@retval EFI_INVALID_PARAMETER Invalid FsHandle
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
GetFileSystemCurrentPartNo (
|
|
IN EFI_HANDLE FsHandle,
|
|
OUT UINT32 *SwPartNo
|
|
)
|
|
{
|
|
FILE_SYSTEM_CONTROL_BLOCK *FileSystemControlBlock;
|
|
|
|
FileSystemControlBlock = (FILE_SYSTEM_CONTROL_BLOCK *)FsHandle;
|
|
if (FileSystemControlBlock == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
ASSERT (FileSystemControlBlock->Signature == FILE_SYSTEM_CB_SIGNATURE);
|
|
|
|
*SwPartNo = FileSystemControlBlock->SwPartNo;
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
Get detected file system type
|
|
|
|
@param[in] FsHandle file system handle.
|
|
|
|
@retval OS_FILE_SYSTEM_TYPE file system type enum
|
|
|
|
**/
|
|
OS_FILE_SYSTEM_TYPE
|
|
EFIAPI
|
|
GetFileSystemType (
|
|
IN EFI_HANDLE FsHandle
|
|
)
|
|
{
|
|
UINTN Signature;
|
|
OS_FILE_SYSTEM_TYPE FsType;
|
|
EFI_HANDLE SubFsHandle;
|
|
FILE_SYSTEM_CONTROL_BLOCK *FileSystemControlBlock;
|
|
|
|
FsType = EnumFileSystemMax;
|
|
FileSystemControlBlock = (FILE_SYSTEM_CONTROL_BLOCK *)FsHandle;
|
|
if (FileSystemControlBlock == NULL) {
|
|
return FsType;
|
|
}
|
|
ASSERT (FileSystemControlBlock->Signature == FILE_SYSTEM_CB_SIGNATURE);
|
|
|
|
SubFsHandle = FileSystemControlBlock->FsHandle;
|
|
if (SubFsHandle != NULL) {
|
|
Signature = *(UINTN *)SubFsHandle;
|
|
if (Signature == FS_FAT_SIGNATURE) {
|
|
FsType = EnumFileSystemTypeFat;
|
|
} else if (Signature == FS_EXT_SIGNATURE) {
|
|
FsType = EnumFileSystemTypeExt2;
|
|
}
|
|
}
|
|
return FsType;
|
|
}
|
|
|
|
/**
|
|
Initialize file systems.
|
|
|
|
@param[in] SwPart Software partition index.
|
|
@param[in] FsType Filesystem type.
|
|
@param[in] PartHandle Partition handle.
|
|
@param[out] FsHandle FAT file system handle.
|
|
|
|
@retval EFI_SUCCESS The file system was initialized successfully.
|
|
@retval EFI_INVALID_PARAMETER Parameter is not valid.
|
|
@retval EFI_NOT_FOUND FAT file system was not detected on this partition.
|
|
@retval EFI_OUT_OF_RESOURCES Insufficant memory resource pool.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
InitFileSystem (
|
|
IN UINT32 SwPart,
|
|
IN UINT32 FsType,
|
|
IN EFI_HANDLE PartHandle,
|
|
OUT EFI_HANDLE *FsHandle
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
UINT32 Type;
|
|
EFI_HANDLE Handle;
|
|
FILE_SYSTEM_CONTROL_BLOCK *FileSystemControlBlock;
|
|
|
|
Status = EFI_INVALID_PARAMETER;
|
|
|
|
if (FsType >= EnumFileSystemMax) {
|
|
return Status;
|
|
}
|
|
|
|
RegisterFileSystems ();
|
|
|
|
for (Type = EnumFileSystemTypeFat; Type < EnumFileSystemTypeAuto; Type++) {
|
|
if (mFileSystemFuncs[Type].InitFileSystem == NULL) {
|
|
continue;
|
|
}
|
|
if ((FsType == EnumFileSystemTypeAuto) || (FsType == Type)) {
|
|
Handle = NULL;
|
|
Status = mFileSystemFuncs[Type].InitFileSystem (SwPart, PartHandle, &Handle);
|
|
if (!EFI_ERROR (Status)) {
|
|
break;
|
|
}
|
|
|
|
if (Handle != NULL) {
|
|
mFileSystemFuncs[Type].CloseFileSystem (Handle);
|
|
}
|
|
}
|
|
}
|
|
|
|
if (!EFI_ERROR (Status)) {
|
|
FileSystemControlBlock = (FILE_SYSTEM_CONTROL_BLOCK *) AllocatePool (sizeof (FILE_SYSTEM_CONTROL_BLOCK));
|
|
if (FileSystemControlBlock == NULL) {
|
|
return EFI_OUT_OF_RESOURCES;
|
|
}
|
|
|
|
FileSystemControlBlock->Signature = FILE_SYSTEM_CB_SIGNATURE;
|
|
FileSystemControlBlock->FsHandle = Handle;
|
|
FileSystemControlBlock->SwPartNo = SwPart;
|
|
InitializeListHead (&FileSystemControlBlock->OpenFiles);
|
|
|
|
*FsHandle = (EFI_HANDLE)FileSystemControlBlock;
|
|
}
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
Clean-up allocated memory/etc. for file system
|
|
|
|
@param[in] FsHandle File system handle to clean-up.
|
|
|
|
@retval none
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
CloseFileSystem (
|
|
IN EFI_HANDLE FsHandle
|
|
)
|
|
{
|
|
OS_FILE_SYSTEM_TYPE FsType;
|
|
FILE_SYSTEM_CONTROL_BLOCK *FileSystemControlBlock;
|
|
FILE_CONTROL_BLOCK *FileControlBlock;
|
|
LIST_ENTRY *Node;
|
|
|
|
FileSystemControlBlock = (FILE_SYSTEM_CONTROL_BLOCK *)FsHandle;
|
|
if (FileSystemControlBlock == NULL) {
|
|
return;
|
|
}
|
|
|
|
FsType = GetFileSystemType (FsHandle);
|
|
if (FsType >= EnumFileSystemTypeAuto) {
|
|
return;
|
|
}
|
|
|
|
Node = GetFirstNode (&FileSystemControlBlock->OpenFiles);
|
|
while (!IsNull (&FileSystemControlBlock->OpenFiles, Node)) {
|
|
FileControlBlock = (FILE_CONTROL_BLOCK *)Node;
|
|
if (FileControlBlock->Signature == FILE_CB_SIGNATURE) {
|
|
DEBUG ((DEBUG_INFO, " Close file handle 0x%p\n", FileControlBlock->FileHandle));
|
|
CloseFile (FileControlBlock);
|
|
}
|
|
Node = GetNextNode (&FileSystemControlBlock->OpenFiles, Node);
|
|
}
|
|
|
|
if (mFileSystemFuncs[FsType].CloseFileSystem == NULL) {
|
|
return;
|
|
}
|
|
|
|
mFileSystemFuncs[FsType].CloseFileSystem (FileSystemControlBlock->FsHandle);
|
|
FreePool (FileSystemControlBlock);
|
|
DEBUG ((DEBUG_INFO, "CloseFileSystem: FsType %d\n", FsType));
|
|
}
|
|
|
|
/**
|
|
Open a file by its name and return its file handle.
|
|
|
|
@param[in] FsHandle file system handle.
|
|
@param[in] FileName The file name to get.
|
|
@param[out] FileHandle file handle
|
|
|
|
@retval EFI_SUCCESS The file opened correctly.
|
|
@retval EFI_INVALID_PARAMETER Parameter is not valid.
|
|
@retval EFI_DEVICE_ERROR A device error occurred.
|
|
@retval EFI_NOT_FOUND A requested file cannot be found.
|
|
@retval EFI_OUT_OF_RESOURCES Insufficant memory resource pool.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
OpenFile (
|
|
IN EFI_HANDLE FsHandle,
|
|
IN CHAR16 *FileName,
|
|
OUT EFI_HANDLE *FileHandle
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
OS_FILE_SYSTEM_TYPE FsType;
|
|
EFI_HANDLE FsFileHandle;
|
|
FILE_SYSTEM_CONTROL_BLOCK *FileSystemControlBlock;
|
|
FILE_CONTROL_BLOCK *FileControlBlock;
|
|
|
|
FileSystemControlBlock = (FILE_SYSTEM_CONTROL_BLOCK *)FsHandle;
|
|
ASSERT (FileSystemControlBlock != NULL);
|
|
if (FileSystemControlBlock == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
FsType = GetFileSystemType (FsHandle);
|
|
if (FsType >= EnumFileSystemTypeAuto) {
|
|
return EFI_NOT_READY;
|
|
}
|
|
|
|
if (mFileSystemFuncs[FsType].OpenFile == NULL) {
|
|
return EFI_UNSUPPORTED;
|
|
}
|
|
|
|
Status = mFileSystemFuncs[FsType].OpenFile (FileSystemControlBlock->FsHandle, FileName, &FsFileHandle);
|
|
if (EFI_ERROR (Status)) {
|
|
return Status;
|
|
}
|
|
|
|
FileControlBlock = (FILE_CONTROL_BLOCK *) AllocatePool (sizeof (FILE_CONTROL_BLOCK));
|
|
if (FileControlBlock == NULL) {
|
|
return EFI_OUT_OF_RESOURCES;
|
|
}
|
|
|
|
FileControlBlock->Signature = FILE_CB_SIGNATURE;
|
|
FileControlBlock->FileHandle = FsFileHandle;
|
|
FileControlBlock->FileSystemControlBlock = FileSystemControlBlock;
|
|
InsertTailList (&FileSystemControlBlock->OpenFiles, &FileControlBlock->Link);
|
|
|
|
*FileHandle = (EFI_HANDLE) FileControlBlock;
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
Get file size by opened file handle.
|
|
|
|
@param[in] FileHandle file handle
|
|
@param[out] FileSize Pointer to file buffer size.
|
|
|
|
@retval EFI_SUCCESS The file was loaded correctly.
|
|
@retval EFI_INVALID_PARAMETER Parameter is not valid.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
GetFileSize (
|
|
IN EFI_HANDLE FileHandle,
|
|
OUT UINTN *FileSize
|
|
)
|
|
{
|
|
OS_FILE_SYSTEM_TYPE FsType;
|
|
FILE_SYSTEM_CONTROL_BLOCK *FileSystemControlBlock;
|
|
FILE_CONTROL_BLOCK *FileControlBlock;
|
|
|
|
FileControlBlock = (FILE_CONTROL_BLOCK *)FileHandle;
|
|
ASSERT (FileControlBlock != NULL);
|
|
if (FileControlBlock == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
ASSERT (FileControlBlock->Signature == FILE_CB_SIGNATURE);
|
|
|
|
FileSystemControlBlock = (FILE_SYSTEM_CONTROL_BLOCK *)FileControlBlock->FileSystemControlBlock;
|
|
ASSERT (FileSystemControlBlock->Signature == FILE_SYSTEM_CB_SIGNATURE);
|
|
|
|
FsType = GetFileSystemType (FileSystemControlBlock);
|
|
if (FsType >= EnumFileSystemTypeAuto) {
|
|
return EFI_NOT_READY;
|
|
}
|
|
|
|
if (mFileSystemFuncs[FsType].GetFileSize == NULL) {
|
|
return EFI_UNSUPPORTED;
|
|
}
|
|
|
|
return mFileSystemFuncs[FsType].GetFileSize (FileControlBlock->FileHandle, FileSize);
|
|
}
|
|
|
|
/**
|
|
Read file into memory by opened file handle.
|
|
|
|
@param[in] FileHandle file handle
|
|
@param[out] FileBufferPtr Allocated file buffer pointer.
|
|
@param[out] FileSize Pointer to file buffer size.
|
|
|
|
@retval EFI_SUCCESS The file was loaded correctly.
|
|
@retval EFI_INVALID_PARAMETER Parameter is not valid.
|
|
@retval EFI_DEVICE_ERROR A device error occurred.
|
|
@retval EFI_NOT_FOUND A requested file cannot be found.
|
|
@retval EFI_OUT_OF_RESOURCES Insufficant memory resource pool.
|
|
@retval EFI_BUFFER_TOO_SMALL Buffer size is too small.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
ReadFile (
|
|
IN EFI_HANDLE FileHandle,
|
|
OUT VOID **FileBuffer,
|
|
OUT UINTN *FileSize
|
|
)
|
|
{
|
|
OS_FILE_SYSTEM_TYPE FsType;
|
|
FILE_SYSTEM_CONTROL_BLOCK *FileSystemControlBlock;
|
|
FILE_CONTROL_BLOCK *FileControlBlock;
|
|
|
|
ASSERT (FileHandle != NULL);
|
|
if (FileHandle == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
ASSERT (*FileBuffer != NULL);
|
|
if (*FileBuffer == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
FileControlBlock = (FILE_CONTROL_BLOCK *)FileHandle;
|
|
ASSERT (FileControlBlock->Signature == FILE_CB_SIGNATURE);
|
|
|
|
FileSystemControlBlock = (FILE_SYSTEM_CONTROL_BLOCK *)FileControlBlock->FileSystemControlBlock;
|
|
ASSERT (FileSystemControlBlock->Signature == FILE_SYSTEM_CB_SIGNATURE);
|
|
|
|
FsType = GetFileSystemType (FileSystemControlBlock);
|
|
if (FsType >= EnumFileSystemTypeAuto) {
|
|
return EFI_NOT_READY;
|
|
}
|
|
|
|
if (mFileSystemFuncs[FsType].ReadFile == NULL) {
|
|
return EFI_UNSUPPORTED;
|
|
}
|
|
|
|
return mFileSystemFuncs[FsType].ReadFile (FileSystemControlBlock->FsHandle, FileControlBlock->FileHandle, FileBuffer, FileSize);
|
|
}
|
|
|
|
/**
|
|
Close a file by opened file handle
|
|
|
|
@param[in] FileHandle file handle
|
|
|
|
@retval none
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
CloseFile (
|
|
IN EFI_HANDLE FileHandle
|
|
)
|
|
{
|
|
OS_FILE_SYSTEM_TYPE FsType;
|
|
FILE_SYSTEM_CONTROL_BLOCK *FileSystemControlBlock;
|
|
FILE_CONTROL_BLOCK *FileControlBlock;
|
|
|
|
FileControlBlock = (FILE_CONTROL_BLOCK *)FileHandle;
|
|
ASSERT (FileControlBlock != NULL);
|
|
ASSERT (FileControlBlock->Signature == FILE_CB_SIGNATURE);
|
|
if (FileControlBlock == NULL || FileControlBlock->Signature != FILE_CB_SIGNATURE) {
|
|
return;
|
|
}
|
|
|
|
FileSystemControlBlock = (FILE_SYSTEM_CONTROL_BLOCK *)FileControlBlock->FileSystemControlBlock;
|
|
ASSERT (FileSystemControlBlock != NULL);
|
|
ASSERT (FileSystemControlBlock->Signature == FILE_SYSTEM_CB_SIGNATURE);
|
|
if (FileSystemControlBlock == NULL) {
|
|
return;
|
|
}
|
|
|
|
FsType = GetFileSystemType (FileSystemControlBlock);
|
|
if (FsType >= EnumFileSystemTypeAuto) {
|
|
return;
|
|
}
|
|
|
|
if (mFileSystemFuncs[FsType].CloseFile == NULL) {
|
|
return;
|
|
}
|
|
|
|
RemoveEntryList (&FileControlBlock->Link);
|
|
mFileSystemFuncs[FsType].CloseFile (FileControlBlock->FileHandle);
|
|
FreePool (FileControlBlock);
|
|
}
|
|
|
|
/**
|
|
List directories or files
|
|
|
|
@param[in] FsHandle file system handle.
|
|
@param[in] DirFilePath directory or file path
|
|
|
|
@retval EFI_SUCCESS list directories of files successfully
|
|
@retval EFI_UNSUPPORTED this api is not supported
|
|
@retval Others an error occurs
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
ListDir (
|
|
IN EFI_HANDLE FsHandle,
|
|
IN CHAR16 *DirFilePath
|
|
)
|
|
{
|
|
DEBUG_CODE_BEGIN ();
|
|
OS_FILE_SYSTEM_TYPE FsType;
|
|
FILE_SYSTEM_CONTROL_BLOCK *FileSystemControlBlock;
|
|
|
|
FileSystemControlBlock = (FILE_SYSTEM_CONTROL_BLOCK *)FsHandle;
|
|
ASSERT (FileSystemControlBlock != NULL);
|
|
if (FileSystemControlBlock == NULL) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
FsType = GetFileSystemType (FsHandle);
|
|
if (FsType >= EnumFileSystemTypeAuto) {
|
|
return EFI_NOT_READY;
|
|
}
|
|
|
|
if (mFileSystemFuncs[FsType].ListDir != NULL) {
|
|
return mFileSystemFuncs[FsType].ListDir (FileSystemControlBlock->FsHandle, DirFilePath);
|
|
}
|
|
DEBUG_CODE_END ();
|
|
|
|
return EFI_UNSUPPORTED;
|
|
}
|