FatPkg: Clean up source files
1. Do not use tab characters 2. No trailing white space in one line 3. All files must end with CRLF Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Liming Gao <liming.gao@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
/** @file
|
||||
Data structures for FAT recovery PEIM
|
||||
|
||||
Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>
|
||||
Copyright (c) 2006 - 2018, 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
|
||||
@@ -193,16 +193,16 @@ typedef struct {
|
||||
This function finds the the recovery file named FileName on a specified FAT volume and returns
|
||||
its FileHandle pointer.
|
||||
|
||||
@param PrivateData Global memory map for accessing global
|
||||
variables.
|
||||
@param VolumeIndex The index of the volume.
|
||||
@param FileName The recovery file name to find.
|
||||
@param Handle The output file handle.
|
||||
@param PrivateData Global memory map for accessing global
|
||||
variables.
|
||||
@param VolumeIndex The index of the volume.
|
||||
@param FileName The recovery file name to find.
|
||||
@param Handle The output file handle.
|
||||
|
||||
@retval EFI_DEVICE_ERROR Some error occured when operating the FAT
|
||||
volume.
|
||||
@retval EFI_NOT_FOUND The recovery file was not found.
|
||||
@retval EFI_SUCCESS The recovery file was successfully found on the
|
||||
@retval EFI_DEVICE_ERROR Some error occured when operating the FAT
|
||||
volume.
|
||||
@retval EFI_NOT_FOUND The recovery file was not found.
|
||||
@retval EFI_SUCCESS The recovery file was successfully found on the
|
||||
FAT volume.
|
||||
|
||||
**/
|
||||
@@ -221,14 +221,14 @@ FindRecoveryFile (
|
||||
returns the number and maximum size in bytes of the capsules discovered.Entry 1 is assumed to be
|
||||
the highest load priority and entry N is assumed to be the lowest priority.
|
||||
|
||||
@param PeiServices General-purpose services that are available to
|
||||
every PEIM.
|
||||
@param This Indicates the
|
||||
EFI_PEI_DEVICE_RECOVERY_MODULE_PPI instance.
|
||||
@param NumberRecoveryCapsules Pointer to a caller-allocated UINTN.On output,
|
||||
*NumberRecoveryCapsules contains the number of
|
||||
recovery capsule images available for retrieval
|
||||
from this PEIM instance.
|
||||
@param PeiServices General-purpose services that are available to
|
||||
every PEIM.
|
||||
@param This Indicates the
|
||||
EFI_PEI_DEVICE_RECOVERY_MODULE_PPI instance.
|
||||
@param NumberRecoveryCapsules Pointer to a caller-allocated UINTN.On output,
|
||||
*NumberRecoveryCapsules contains the number of
|
||||
recovery capsule images available for retrieval
|
||||
from this PEIM instance.
|
||||
|
||||
@retval EFI_SUCCESS The function completed successfully.
|
||||
|
||||
@@ -246,26 +246,26 @@ GetNumberRecoveryCapsules (
|
||||
Returns the size and type of the requested recovery capsule.
|
||||
This function returns the size and type of the capsule specified by CapsuleInstance.
|
||||
|
||||
@param PeiServices General-purpose services that are available to
|
||||
every PEIM.
|
||||
@param This Indicates the
|
||||
EFI_PEI_DEVICE_RECOVERY_MODULE_PPI instance.
|
||||
@param CapsuleInstance Specifies for which capsule instance to
|
||||
retrieve the information.T his parameter must
|
||||
be between one and the value returned by
|
||||
GetNumberRecoveryCapsules() in
|
||||
NumberRecoveryCapsules.
|
||||
@param Size A pointer to a caller-allocated UINTN in which
|
||||
the size of the requested recovery module is
|
||||
returned.
|
||||
@param CapsuleType A pointer to a caller-allocated EFI_GUID in
|
||||
which the type of the requested recovery
|
||||
capsule is returned.T he semantic meaning of
|
||||
the value returned is defined by the
|
||||
implementation.
|
||||
@param PeiServices General-purpose services that are available to
|
||||
every PEIM.
|
||||
@param This Indicates the
|
||||
EFI_PEI_DEVICE_RECOVERY_MODULE_PPI instance.
|
||||
@param CapsuleInstance Specifies for which capsule instance to
|
||||
retrieve the information.T his parameter must
|
||||
be between one and the value returned by
|
||||
GetNumberRecoveryCapsules() in
|
||||
NumberRecoveryCapsules.
|
||||
@param Size A pointer to a caller-allocated UINTN in which
|
||||
the size of the requested recovery module is
|
||||
returned.
|
||||
@param CapsuleType A pointer to a caller-allocated EFI_GUID in
|
||||
which the type of the requested recovery
|
||||
capsule is returned.T he semantic meaning of
|
||||
the value returned is defined by the
|
||||
implementation.
|
||||
|
||||
@retval EFI_SUCCESS The capsule type and size were retrieved.
|
||||
@retval EFI_INVALID_PARAMETER The input CapsuleInstance does not match any
|
||||
@retval EFI_SUCCESS The capsule type and size were retrieved.
|
||||
@retval EFI_INVALID_PARAMETER The input CapsuleInstance does not match any
|
||||
discovered recovery capsule.
|
||||
|
||||
**/
|
||||
@@ -286,12 +286,12 @@ GetRecoveryCapsuleInfo (
|
||||
This function, by whatever mechanism, retrieves a DXE capsule from some device
|
||||
and loads it into memory. Note that the published interface is device neutral.
|
||||
|
||||
@param[in] PeiServices General-purpose services that are available
|
||||
@param[in] PeiServices General-purpose services that are available
|
||||
to every PEIM
|
||||
@param[in] This Indicates the EFI_PEI_DEVICE_RECOVERY_MODULE_PPI
|
||||
instance.
|
||||
@param[in] CapsuleInstance Specifies which capsule instance to retrieve.
|
||||
@param[out] Buffer Specifies a caller-allocated buffer in which
|
||||
@param[out] Buffer Specifies a caller-allocated buffer in which
|
||||
the requested recovery capsule will be returned.
|
||||
|
||||
@retval EFI_SUCCESS The capsule was loaded correctly.
|
||||
@@ -316,11 +316,11 @@ LoadRecoveryCapsule (
|
||||
to a Null-terminated Unicode string.
|
||||
Here does not expand DBCS FAT chars.
|
||||
|
||||
@param FatSize The size of the string Fat in bytes.
|
||||
@param Fat A pointer to a Null-terminated string that contains
|
||||
an 8.3 file name using an OEM character set.
|
||||
@param Str A pointer to a Null-terminated Unicode string. The
|
||||
string must be allocated in advance to hold FatSize
|
||||
@param FatSize The size of the string Fat in bytes.
|
||||
@param Fat A pointer to a Null-terminated string that contains
|
||||
an 8.3 file name using an OEM character set.
|
||||
@param Str A pointer to a Null-terminated Unicode string. The
|
||||
string must be allocated in advance to hold FatSize
|
||||
Unicode characters
|
||||
|
||||
**/
|
||||
@@ -335,8 +335,8 @@ EngFatToStr (
|
||||
/**
|
||||
Performs a case-insensitive comparison of two Null-terminated Unicode strings.
|
||||
|
||||
@param PrivateData Global memory map for accessing global variables
|
||||
@param Str1 First string to perform case insensitive comparison.
|
||||
@param PrivateData Global memory map for accessing global variables
|
||||
@param Str1 First string to perform case insensitive comparison.
|
||||
@param Str2 Second string to perform case insensitive comparison.
|
||||
|
||||
**/
|
||||
@@ -352,15 +352,15 @@ EngStriColl (
|
||||
Reads a block of data from the block device by calling
|
||||
underlying Block I/O service.
|
||||
|
||||
@param PrivateData Global memory map for accessing global variables
|
||||
@param BlockDeviceNo The index for the block device number.
|
||||
@param Lba The logic block address to read data from.
|
||||
@param BufferSize The size of data in byte to read.
|
||||
@param Buffer The buffer of the
|
||||
@param PrivateData Global memory map for accessing global variables
|
||||
@param BlockDeviceNo The index for the block device number.
|
||||
@param Lba The logic block address to read data from.
|
||||
@param BufferSize The size of data in byte to read.
|
||||
@param Buffer The buffer of the
|
||||
|
||||
@retval EFI_DEVICE_ERROR The specified block device number exceeds the maximum
|
||||
device number.
|
||||
@retval EFI_DEVICE_ERROR The maximum address has exceeded the maximum address
|
||||
@retval EFI_DEVICE_ERROR The specified block device number exceeds the maximum
|
||||
device number.
|
||||
@retval EFI_DEVICE_ERROR The maximum address has exceeded the maximum address
|
||||
of the block device.
|
||||
|
||||
**/
|
||||
@@ -380,16 +380,16 @@ FatReadBlock (
|
||||
volume structure. Note there should be a valid Block device number
|
||||
already set.
|
||||
|
||||
@param PrivateData Global memory map for accessing global
|
||||
variables.
|
||||
@param Volume On input, the BlockDeviceNumber field of the
|
||||
Volume should be a valid value. On successful
|
||||
output, all fields except the VolumeNumber
|
||||
field is initialized.
|
||||
@param PrivateData Global memory map for accessing global
|
||||
variables.
|
||||
@param Volume On input, the BlockDeviceNumber field of the
|
||||
Volume should be a valid value. On successful
|
||||
output, all fields except the VolumeNumber
|
||||
field is initialized.
|
||||
|
||||
@retval EFI_SUCCESS A FAT is found and the volume structure is
|
||||
initialized.
|
||||
@retval EFI_NOT_FOUND There is no FAT on the corresponding device.
|
||||
@retval EFI_SUCCESS A FAT is found and the volume structure is
|
||||
initialized.
|
||||
@retval EFI_NOT_FOUND There is no FAT on the corresponding device.
|
||||
@retval EFI_DEVICE_ERROR There is something error while accessing device.
|
||||
|
||||
**/
|
||||
@@ -403,13 +403,13 @@ FatGetBpbInfo (
|
||||
/**
|
||||
Gets the next cluster in the cluster chain.
|
||||
|
||||
@param PrivateData Global memory map for accessing global variables
|
||||
@param Volume The volume
|
||||
@param Cluster The cluster
|
||||
@param NextCluster The cluster number of the next cluster
|
||||
@param PrivateData Global memory map for accessing global variables
|
||||
@param Volume The volume
|
||||
@param Cluster The cluster
|
||||
@param NextCluster The cluster number of the next cluster
|
||||
|
||||
@retval EFI_SUCCESS The address is got
|
||||
@retval EFI_INVALID_PARAMETER ClusterNo exceeds the MaxCluster of the volume.
|
||||
@retval EFI_SUCCESS The address is got
|
||||
@retval EFI_INVALID_PARAMETER ClusterNo exceeds the MaxCluster of the volume.
|
||||
@retval EFI_DEVICE_ERROR Read disk error
|
||||
|
||||
**/
|
||||
@@ -425,11 +425,11 @@ FatGetNextCluster (
|
||||
/**
|
||||
Disk reading.
|
||||
|
||||
@param PrivateData the global memory map;
|
||||
@param BlockDeviceNo the block device to read;
|
||||
@param StartingAddress the starting address.
|
||||
@param Size the amount of data to read.
|
||||
@param Buffer the buffer holding the data
|
||||
@param PrivateData the global memory map;
|
||||
@param BlockDeviceNo the block device to read;
|
||||
@param StartingAddress the starting address.
|
||||
@param Size the amount of data to read.
|
||||
@param Buffer the buffer holding the data
|
||||
|
||||
@retval EFI_SUCCESS The function completed successfully.
|
||||
@retval EFI_DEVICE_ERROR Something error.
|
||||
@@ -448,13 +448,13 @@ FatReadDisk (
|
||||
/**
|
||||
Set a file's CurrentPos and CurrentCluster, then compute StraightReadAmount.
|
||||
|
||||
@param PrivateData the global memory map
|
||||
@param File the file
|
||||
@param Pos the Position which is offset from the file's
|
||||
CurrentPos
|
||||
@param PrivateData the global memory map
|
||||
@param File the file
|
||||
@param Pos the Position which is offset from the file's
|
||||
CurrentPos
|
||||
|
||||
@retval EFI_SUCCESS Success.
|
||||
@retval EFI_INVALID_PARAMETER Pos is beyond file's size.
|
||||
@retval EFI_SUCCESS Success.
|
||||
@retval EFI_INVALID_PARAMETER Pos is beyond file's size.
|
||||
@retval EFI_DEVICE_ERROR Something error while accessing media.
|
||||
|
||||
**/
|
||||
@@ -469,13 +469,13 @@ FatSetFilePos (
|
||||
/**
|
||||
Reads file data. Updates the file's CurrentPos.
|
||||
|
||||
@param PrivateData Global memory map for accessing global variables
|
||||
@param File The file.
|
||||
@param Size The amount of data to read.
|
||||
@param Buffer The buffer storing the data.
|
||||
@param PrivateData Global memory map for accessing global variables
|
||||
@param File The file.
|
||||
@param Size The amount of data to read.
|
||||
@param Buffer The buffer storing the data.
|
||||
|
||||
@retval EFI_SUCCESS The data is read.
|
||||
@retval EFI_INVALID_PARAMETER File is invalid.
|
||||
@retval EFI_SUCCESS The data is read.
|
||||
@retval EFI_INVALID_PARAMETER File is invalid.
|
||||
@retval EFI_DEVICE_ERROR Something error while accessing media.
|
||||
|
||||
**/
|
||||
@@ -494,14 +494,14 @@ FatReadFile (
|
||||
The function updates the CurrentPos of the parent dir to after the item read.
|
||||
If no more items were found, the function returns EFI_NOT_FOUND.
|
||||
|
||||
@param PrivateData Global memory map for accessing global variables
|
||||
@param ParentDir The parent directory.
|
||||
@param SubFile The File structure containing the sub file that
|
||||
is caught.
|
||||
@param PrivateData Global memory map for accessing global variables
|
||||
@param ParentDir The parent directory.
|
||||
@param SubFile The File structure containing the sub file that
|
||||
is caught.
|
||||
|
||||
@retval EFI_SUCCESS The next sub file is obtained.
|
||||
@retval EFI_INVALID_PARAMETER The ParentDir is not a directory.
|
||||
@retval EFI_NOT_FOUND No more sub file exists.
|
||||
@retval EFI_SUCCESS The next sub file is obtained.
|
||||
@retval EFI_INVALID_PARAMETER The ParentDir is not a directory.
|
||||
@retval EFI_NOT_FOUND No more sub file exists.
|
||||
@retval EFI_DEVICE_ERROR Something error while accessing media.
|
||||
|
||||
**/
|
||||
|
Reference in New Issue
Block a user