mirror of
https://github.com/acidanthera/audk.git
synced 2025-04-08 17:05:09 +02:00
2e351cbe8e
https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Bob Feng <bob.c.feng@intel.com>
106 lines
1.7 KiB
C
106 lines
1.7 KiB
C
/** @file
|
|
Header file for helper functions useful for accessing files.
|
|
|
|
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef _EFI_MEMORY_FILE_H
|
|
#define _EFI_MEMORY_FILE_H
|
|
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <Common/UefiBaseTypes.h>
|
|
|
|
//
|
|
// Common data structures
|
|
//
|
|
typedef struct {
|
|
CHAR8 *FileImage;
|
|
CHAR8 *Eof;
|
|
CHAR8 *CurrentFilePointer;
|
|
} MEMORY_FILE;
|
|
|
|
|
|
//
|
|
// Functions declarations
|
|
//
|
|
|
|
EFI_STATUS
|
|
GetMemoryFile (
|
|
IN CHAR8 *InputFileName,
|
|
OUT EFI_HANDLE *OutputMemoryFile
|
|
)
|
|
;
|
|
/**
|
|
|
|
Routine Description:
|
|
|
|
This opens a file, reads it into memory and returns a memory file
|
|
object.
|
|
|
|
Arguments:
|
|
|
|
InputFile Memory file image.
|
|
OutputMemoryFile Handle to memory file
|
|
|
|
Returns:
|
|
|
|
EFI_STATUS
|
|
OutputMemoryFile is valid if !EFI_ERROR
|
|
|
|
**/
|
|
|
|
|
|
EFI_STATUS
|
|
FreeMemoryFile (
|
|
IN EFI_HANDLE InputMemoryFile
|
|
)
|
|
;
|
|
/**
|
|
|
|
Routine Description:
|
|
|
|
Frees all memory associated with the input memory file.
|
|
|
|
Arguments:
|
|
|
|
InputMemoryFile Handle to memory file
|
|
|
|
Returns:
|
|
|
|
EFI_STATUS
|
|
|
|
**/
|
|
|
|
|
|
CHAR8 *
|
|
ReadMemoryFileLine (
|
|
IN EFI_HANDLE InputMemoryFile
|
|
)
|
|
;
|
|
/**
|
|
|
|
Routine Description:
|
|
|
|
This function reads a line from the memory file. The newline characters
|
|
are stripped and a null terminated string is returned.
|
|
|
|
If the string pointer returned is non-NULL, then the caller must free the
|
|
memory associated with this string.
|
|
|
|
Arguments:
|
|
|
|
InputMemoryFile Handle to memory file
|
|
|
|
Returns:
|
|
|
|
NULL if error or EOF
|
|
NULL character termincated string otherwise (MUST BE FREED BY CALLER)
|
|
|
|
**/
|
|
|
|
|
|
#endif
|