mirror of
https://github.com/CloverHackyColor/CloverBootloader.git
synced 2024-11-29 12:35:53 +01:00
1180 lines
38 KiB
C
1180 lines
38 KiB
C
/** @file
|
|
Functions implementation related with Mtftp for UefiPxeBc Driver.
|
|
|
|
Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#include "PxeBcImpl.h"
|
|
|
|
CHAR8 *mMtftpOptions[PXE_MTFTP_OPTION_MAXIMUM_INDEX] = {
|
|
"blksize",
|
|
"timeout",
|
|
"tsize",
|
|
"multicast",
|
|
"windowsize"
|
|
};
|
|
|
|
/**
|
|
This is a callback function when packets are received or transmitted in Mtftp driver.
|
|
|
|
A callback function that is provided by the caller to intercept
|
|
the EFI_MTFTP6_OPCODE_DATA or EFI_MTFTP6_OPCODE_DATA8 packets processed in the
|
|
EFI_MTFTP6_PROTOCOL.ReadFile() function, and alternatively to intercept
|
|
EFI_MTFTP6_OPCODE_OACK or EFI_MTFTP6_OPCODE_ERROR packets during a call to
|
|
EFI_MTFTP6_PROTOCOL.ReadFile(), WriteFile() or ReadDirectory().
|
|
|
|
@param[in] This Pointer to EFI_MTFTP6_PROTOCOL.
|
|
@param[in] Token Pointer to EFI_MTFTP6_TOKEN.
|
|
@param[in] PacketLen Length of EFI_MTFTP6_PACKET.
|
|
@param[in] Packet Pointer to EFI_MTFTP6_PACKET to be checked.
|
|
|
|
@retval EFI_SUCCESS The current operation succeeded.
|
|
@retval EFI_ABORTED Abort the current transfer process.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
PxeBcMtftp6CheckPacket (
|
|
IN EFI_MTFTP6_PROTOCOL *This,
|
|
IN EFI_MTFTP6_TOKEN *Token,
|
|
IN UINT16 PacketLen,
|
|
IN EFI_MTFTP6_PACKET *Packet
|
|
)
|
|
{
|
|
PXEBC_PRIVATE_DATA *Private;
|
|
EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL *Callback;
|
|
EFI_STATUS Status;
|
|
|
|
Private = (PXEBC_PRIVATE_DATA *)Token->Context;
|
|
Callback = Private->PxeBcCallback;
|
|
Status = EFI_SUCCESS;
|
|
|
|
if (Packet->OpCode == EFI_MTFTP6_OPCODE_ERROR) {
|
|
//
|
|
// Store the tftp error message into mode data and set the received flag.
|
|
//
|
|
Private->Mode.TftpErrorReceived = TRUE;
|
|
Private->Mode.TftpError.ErrorCode = (UINT8)Packet->Error.ErrorCode;
|
|
AsciiStrnCpyS (
|
|
Private->Mode.TftpError.ErrorString,
|
|
PXE_MTFTP_ERROR_STRING_LENGTH,
|
|
(CHAR8 *)Packet->Error.ErrorMessage,
|
|
PXE_MTFTP_ERROR_STRING_LENGTH - 1
|
|
);
|
|
Private->Mode.TftpError.ErrorString[PXE_MTFTP_ERROR_STRING_LENGTH - 1] = '\0';
|
|
}
|
|
|
|
if (Callback != NULL) {
|
|
//
|
|
// Callback to user if has when received any tftp packet.
|
|
//
|
|
Status = Callback->Callback (
|
|
Callback,
|
|
Private->Function,
|
|
TRUE,
|
|
PacketLen,
|
|
(EFI_PXE_BASE_CODE_PACKET *)Packet
|
|
);
|
|
if (Status != EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE) {
|
|
//
|
|
// User wants to abort current process if not EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE.
|
|
//
|
|
Status = EFI_ABORTED;
|
|
} else {
|
|
//
|
|
// User wants to continue current process if EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE.
|
|
//
|
|
Status = EFI_SUCCESS;
|
|
}
|
|
}
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
This function is to get the size of a file using Tftp.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to EFI_MTFTP6_CONFIG_DATA.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] WindowSize Pointer to required window size.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
|
|
@retval EFI_SUCCESS Successfully obtained the size of file.
|
|
@retval EFI_NOT_FOUND Parse the tftp options failed.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval Others Has not obtained the size of the file.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcMtftp6GetFileSize (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN EFI_MTFTP6_CONFIG_DATA *Config,
|
|
IN UINT8 *Filename,
|
|
IN UINTN *BlockSize,
|
|
IN UINTN *WindowSize,
|
|
IN OUT UINT64 *BufferSize
|
|
)
|
|
{
|
|
EFI_MTFTP6_PROTOCOL *Mtftp6;
|
|
EFI_MTFTP6_OPTION ReqOpt[3];
|
|
EFI_MTFTP6_PACKET *Packet;
|
|
EFI_MTFTP6_OPTION *Option;
|
|
UINT32 PktLen;
|
|
UINT8 OptBuf[PXE_MTFTP_OPTBUF_MAXNUM_INDEX];
|
|
UINTN OptBufSize;
|
|
UINT32 OptCnt;
|
|
EFI_STATUS Status;
|
|
|
|
*BufferSize = 0;
|
|
Status = EFI_DEVICE_ERROR;
|
|
Mtftp6 = Private->Mtftp6;
|
|
Packet = NULL;
|
|
Option = NULL;
|
|
PktLen = 0;
|
|
OptBufSize = PXE_MTFTP_OPTBUF_MAXNUM_INDEX;
|
|
OptCnt = 1;
|
|
Config->InitialServerPort = PXEBC_BS_DOWNLOAD_PORT;
|
|
|
|
Status = Mtftp6->Configure (Mtftp6, Config);
|
|
if (EFI_ERROR (Status)) {
|
|
return Status;
|
|
}
|
|
|
|
//
|
|
// Build the required options for get info.
|
|
//
|
|
ReqOpt[0].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_TSIZE_INDEX];
|
|
PxeBcUintnToAscDec (0, OptBuf, OptBufSize);
|
|
ReqOpt[0].ValueStr = OptBuf;
|
|
|
|
if (BlockSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_BLKSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = (UINT8 *)(ReqOpt[OptCnt-1].ValueStr + AsciiStrLen ((CHAR8 *)ReqOpt[OptCnt-1].ValueStr) + 1);
|
|
OptBufSize -= (AsciiStrLen ((CHAR8 *)ReqOpt[OptCnt-1].ValueStr) + 1);
|
|
PxeBcUintnToAscDec (*BlockSize, ReqOpt[OptCnt].ValueStr, OptBufSize);
|
|
OptCnt++;
|
|
}
|
|
|
|
if (WindowSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_WINDOWSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = (UINT8 *)(ReqOpt[OptCnt-1].ValueStr + AsciiStrLen ((CHAR8 *)ReqOpt[OptCnt-1].ValueStr) + 1);
|
|
OptBufSize -= (AsciiStrLen ((CHAR8 *)ReqOpt[OptCnt-1].ValueStr) + 1);
|
|
PxeBcUintnToAscDec (*WindowSize, ReqOpt[OptCnt].ValueStr, OptBufSize);
|
|
OptCnt++;
|
|
}
|
|
|
|
Status = Mtftp6->GetInfo (
|
|
Mtftp6,
|
|
NULL,
|
|
Filename,
|
|
NULL,
|
|
(UINT8)OptCnt,
|
|
ReqOpt,
|
|
&PktLen,
|
|
&Packet
|
|
);
|
|
if (EFI_ERROR (Status)) {
|
|
if (Status == EFI_TFTP_ERROR) {
|
|
//
|
|
// Store the tftp error message into mode data and set the received flag.
|
|
//
|
|
Private->Mode.TftpErrorReceived = TRUE;
|
|
Private->Mode.TftpError.ErrorCode = (UINT8)Packet->Error.ErrorCode;
|
|
AsciiStrnCpyS (
|
|
Private->Mode.TftpError.ErrorString,
|
|
PXE_MTFTP_ERROR_STRING_LENGTH,
|
|
(CHAR8 *)Packet->Error.ErrorMessage,
|
|
PXE_MTFTP_ERROR_STRING_LENGTH - 1
|
|
);
|
|
Private->Mode.TftpError.ErrorString[PXE_MTFTP_ERROR_STRING_LENGTH - 1] = '\0';
|
|
}
|
|
|
|
goto ON_ERROR;
|
|
}
|
|
|
|
//
|
|
// Parse the options in the reply packet.
|
|
//
|
|
OptCnt = 0;
|
|
Status = Mtftp6->ParseOptions (
|
|
Mtftp6,
|
|
PktLen,
|
|
Packet,
|
|
(UINT32 *)&OptCnt,
|
|
&Option
|
|
);
|
|
if (EFI_ERROR (Status)) {
|
|
goto ON_ERROR;
|
|
}
|
|
|
|
//
|
|
// Parse out the value of "tsize" option.
|
|
//
|
|
Status = EFI_NOT_FOUND;
|
|
while (OptCnt != 0) {
|
|
if (AsciiStrnCmp ((CHAR8 *)Option[OptCnt - 1].OptionStr, "tsize", 5) == 0) {
|
|
*BufferSize = AsciiStrDecimalToUint64 ((CHAR8 *)(Option[OptCnt - 1].ValueStr));
|
|
Status = EFI_SUCCESS;
|
|
}
|
|
|
|
OptCnt--;
|
|
}
|
|
|
|
FreePool (Option);
|
|
|
|
ON_ERROR:
|
|
if (Packet != NULL) {
|
|
FreePool (Packet);
|
|
}
|
|
|
|
Mtftp6->Configure (Mtftp6, NULL);
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
This function is to get data of a file using Tftp.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to EFI_MTFTP6_CONFIG_DATA.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] WindowSize Pointer to required window size.
|
|
@param[in] BufferPtr Pointer to buffer.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
@param[in] DontUseBuffer Indicates whether with a receive buffer.
|
|
|
|
@retval EFI_SUCCESS Successfully read the data from the special file.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval Others Read data from file failed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcMtftp6ReadFile (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN EFI_MTFTP6_CONFIG_DATA *Config,
|
|
IN UINT8 *Filename,
|
|
IN UINTN *BlockSize,
|
|
IN UINTN *WindowSize,
|
|
IN UINT8 *BufferPtr,
|
|
IN OUT UINT64 *BufferSize,
|
|
IN BOOLEAN DontUseBuffer
|
|
)
|
|
{
|
|
EFI_MTFTP6_PROTOCOL *Mtftp6;
|
|
EFI_MTFTP6_TOKEN Token;
|
|
EFI_MTFTP6_OPTION ReqOpt[2];
|
|
UINT32 OptCnt;
|
|
UINT8 BlksizeBuf[10];
|
|
UINT8 WindowsizeBuf[10];
|
|
EFI_STATUS Status;
|
|
|
|
Status = EFI_DEVICE_ERROR;
|
|
Mtftp6 = Private->Mtftp6;
|
|
OptCnt = 0;
|
|
Config->InitialServerPort = PXEBC_BS_DOWNLOAD_PORT;
|
|
|
|
Status = Mtftp6->Configure (Mtftp6, Config);
|
|
if (EFI_ERROR (Status)) {
|
|
return Status;
|
|
}
|
|
|
|
if (BlockSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_BLKSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = BlksizeBuf;
|
|
PxeBcUintnToAscDec (*BlockSize, ReqOpt[OptCnt].ValueStr, sizeof (BlksizeBuf));
|
|
OptCnt++;
|
|
}
|
|
|
|
if (WindowSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_WINDOWSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = WindowsizeBuf;
|
|
PxeBcUintnToAscDec (*WindowSize, ReqOpt[OptCnt].ValueStr, sizeof (WindowsizeBuf));
|
|
OptCnt++;
|
|
}
|
|
|
|
Token.Event = NULL;
|
|
Token.OverrideData = NULL;
|
|
Token.Filename = Filename;
|
|
Token.ModeStr = NULL;
|
|
Token.OptionCount = OptCnt;
|
|
Token.OptionList = ReqOpt;
|
|
Token.Context = Private;
|
|
|
|
if (DontUseBuffer) {
|
|
Token.BufferSize = 0;
|
|
Token.Buffer = NULL;
|
|
} else {
|
|
Token.BufferSize = *BufferSize;
|
|
Token.Buffer = BufferPtr;
|
|
}
|
|
|
|
Token.CheckPacket = PxeBcMtftp6CheckPacket;
|
|
Token.TimeoutCallback = NULL;
|
|
Token.PacketNeeded = NULL;
|
|
|
|
Status = Mtftp6->ReadFile (Mtftp6, &Token);
|
|
//
|
|
// Get the real size of received buffer.
|
|
//
|
|
*BufferSize = Token.BufferSize;
|
|
|
|
Mtftp6->Configure (Mtftp6, NULL);
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
This function is used to write the data of a file using Tftp.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to EFI_MTFTP6_CONFIG_DATA.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] Overwrite Indicate whether with overwrite attribute.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] BufferPtr Pointer to buffer.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
|
|
@retval EFI_SUCCESS Successfully wrote the data into a special file.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval other Write data into file failed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcMtftp6WriteFile (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN EFI_MTFTP6_CONFIG_DATA *Config,
|
|
IN UINT8 *Filename,
|
|
IN BOOLEAN Overwrite,
|
|
IN UINTN *BlockSize,
|
|
IN UINT8 *BufferPtr,
|
|
IN OUT UINT64 *BufferSize
|
|
)
|
|
{
|
|
EFI_MTFTP6_PROTOCOL *Mtftp6;
|
|
EFI_MTFTP6_TOKEN Token;
|
|
EFI_MTFTP6_OPTION ReqOpt[1];
|
|
UINT32 OptCnt;
|
|
UINT8 OptBuf[128];
|
|
EFI_STATUS Status;
|
|
|
|
Status = EFI_DEVICE_ERROR;
|
|
Mtftp6 = Private->Mtftp6;
|
|
OptCnt = 0;
|
|
Config->InitialServerPort = PXEBC_BS_DOWNLOAD_PORT;
|
|
|
|
Status = Mtftp6->Configure (Mtftp6, Config);
|
|
if (EFI_ERROR (Status)) {
|
|
return Status;
|
|
}
|
|
|
|
if (BlockSize != NULL) {
|
|
ReqOpt[0].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_BLKSIZE_INDEX];
|
|
ReqOpt[0].ValueStr = OptBuf;
|
|
PxeBcUintnToAscDec (*BlockSize, ReqOpt[0].ValueStr, PXE_MTFTP_OPTBUF_MAXNUM_INDEX);
|
|
OptCnt++;
|
|
}
|
|
|
|
Token.Event = NULL;
|
|
Token.OverrideData = NULL;
|
|
Token.Filename = Filename;
|
|
Token.ModeStr = NULL;
|
|
Token.OptionCount = OptCnt;
|
|
Token.OptionList = ReqOpt;
|
|
Token.BufferSize = *BufferSize;
|
|
Token.Buffer = BufferPtr;
|
|
Token.CheckPacket = PxeBcMtftp6CheckPacket;
|
|
Token.TimeoutCallback = NULL;
|
|
Token.PacketNeeded = NULL;
|
|
|
|
Status = Mtftp6->WriteFile (Mtftp6, &Token);
|
|
//
|
|
// Get the real size of transmitted buffer.
|
|
//
|
|
*BufferSize = Token.BufferSize;
|
|
|
|
Mtftp6->Configure (Mtftp6, NULL);
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
This function is to read the data (file) from a directory using Tftp.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to EFI_MTFTP6_CONFIG_DATA.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] WindowSize Pointer to required window size.
|
|
@param[in] BufferPtr Pointer to buffer.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
@param[in] DontUseBuffer Indicates whether to use a receive buffer.
|
|
|
|
@retval EFI_SUCCESS Successfully obtained the data from the file included in directory.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval Others Operation failed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcMtftp6ReadDirectory (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN EFI_MTFTP6_CONFIG_DATA *Config,
|
|
IN UINT8 *Filename,
|
|
IN UINTN *BlockSize,
|
|
IN UINTN *WindowSize,
|
|
IN UINT8 *BufferPtr,
|
|
IN OUT UINT64 *BufferSize,
|
|
IN BOOLEAN DontUseBuffer
|
|
)
|
|
{
|
|
EFI_MTFTP6_PROTOCOL *Mtftp6;
|
|
EFI_MTFTP6_TOKEN Token;
|
|
EFI_MTFTP6_OPTION ReqOpt[2];
|
|
UINT32 OptCnt;
|
|
UINT8 BlksizeBuf[10];
|
|
UINT8 WindowsizeBuf[10];
|
|
EFI_STATUS Status;
|
|
|
|
Status = EFI_DEVICE_ERROR;
|
|
Mtftp6 = Private->Mtftp6;
|
|
OptCnt = 0;
|
|
Config->InitialServerPort = PXEBC_BS_DOWNLOAD_PORT;
|
|
|
|
Status = Mtftp6->Configure (Mtftp6, Config);
|
|
if (EFI_ERROR (Status)) {
|
|
return Status;
|
|
}
|
|
|
|
if (BlockSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_BLKSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = BlksizeBuf;
|
|
PxeBcUintnToAscDec (*BlockSize, ReqOpt[OptCnt].ValueStr, sizeof (BlksizeBuf));
|
|
OptCnt++;
|
|
}
|
|
|
|
if (WindowSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_WINDOWSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = WindowsizeBuf;
|
|
PxeBcUintnToAscDec (*WindowSize, ReqOpt[OptCnt].ValueStr, sizeof (WindowsizeBuf));
|
|
OptCnt++;
|
|
}
|
|
|
|
Token.Event = NULL;
|
|
Token.OverrideData = NULL;
|
|
Token.Filename = Filename;
|
|
Token.ModeStr = NULL;
|
|
Token.OptionCount = OptCnt;
|
|
Token.OptionList = ReqOpt;
|
|
Token.Context = Private;
|
|
|
|
if (DontUseBuffer) {
|
|
Token.BufferSize = 0;
|
|
Token.Buffer = NULL;
|
|
} else {
|
|
Token.BufferSize = *BufferSize;
|
|
Token.Buffer = BufferPtr;
|
|
}
|
|
|
|
Token.CheckPacket = PxeBcMtftp6CheckPacket;
|
|
Token.TimeoutCallback = NULL;
|
|
Token.PacketNeeded = NULL;
|
|
|
|
Status = Mtftp6->ReadDirectory (Mtftp6, &Token);
|
|
//
|
|
// Get the real size of received buffer.
|
|
//
|
|
*BufferSize = Token.BufferSize;
|
|
|
|
Mtftp6->Configure (Mtftp6, NULL);
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
This is a callback function when packets are received or transmitted in Mtftp driver.
|
|
|
|
A callback function that is provided by the caller to intercept
|
|
the EFI_MTFTP6_OPCODE_DATA or EFI_MTFTP4_OPCODE_DATA8 packets processed in the
|
|
EFI_MTFTP4_PROTOCOL.ReadFile() function, and alternatively to intercept
|
|
EFI_MTFTP4_OPCODE_OACK or EFI_MTFTP4_OPCODE_ERROR packets during a call to
|
|
EFI_MTFTP4_PROTOCOL.ReadFile(), WriteFile() or ReadDirectory().
|
|
|
|
@param[in] This Pointer to EFI_MTFTP4_PROTOCOL.
|
|
@param[in] Token Pointer to EFI_MTFTP4_TOKEN.
|
|
@param[in] PacketLen Length of EFI_MTFTP4_PACKET.
|
|
@param[in] Packet Pointer to EFI_MTFTP4_PACKET to be checked.
|
|
|
|
@retval EFI_SUCCESS The current operation succeeded.
|
|
@retval EFI_ABORTED Abort the current transfer process.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
PxeBcMtftp4CheckPacket (
|
|
IN EFI_MTFTP4_PROTOCOL *This,
|
|
IN EFI_MTFTP4_TOKEN *Token,
|
|
IN UINT16 PacketLen,
|
|
IN EFI_MTFTP4_PACKET *Packet
|
|
)
|
|
{
|
|
PXEBC_PRIVATE_DATA *Private;
|
|
EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL *Callback;
|
|
EFI_STATUS Status;
|
|
|
|
Private = (PXEBC_PRIVATE_DATA *)Token->Context;
|
|
Callback = Private->PxeBcCallback;
|
|
Status = EFI_SUCCESS;
|
|
|
|
if (Packet->OpCode == EFI_MTFTP4_OPCODE_ERROR) {
|
|
//
|
|
// Store the tftp error message into mode data and set the received flag.
|
|
//
|
|
Private->Mode.TftpErrorReceived = TRUE;
|
|
Private->Mode.TftpError.ErrorCode = (UINT8)Packet->Error.ErrorCode;
|
|
AsciiStrnCpyS (
|
|
Private->Mode.TftpError.ErrorString,
|
|
PXE_MTFTP_ERROR_STRING_LENGTH,
|
|
(CHAR8 *)Packet->Error.ErrorMessage,
|
|
PXE_MTFTP_ERROR_STRING_LENGTH - 1
|
|
);
|
|
Private->Mode.TftpError.ErrorString[PXE_MTFTP_ERROR_STRING_LENGTH - 1] = '\0';
|
|
}
|
|
|
|
if (Callback != NULL) {
|
|
//
|
|
// Callback to user if has when received any tftp packet.
|
|
//
|
|
Status = Callback->Callback (
|
|
Callback,
|
|
Private->Function,
|
|
TRUE,
|
|
PacketLen,
|
|
(EFI_PXE_BASE_CODE_PACKET *)Packet
|
|
);
|
|
if (Status != EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE) {
|
|
//
|
|
// User wants to abort current process if not EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE.
|
|
//
|
|
Status = EFI_ABORTED;
|
|
} else {
|
|
//
|
|
// User wants to continue current process if EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE.
|
|
//
|
|
Status = EFI_SUCCESS;
|
|
}
|
|
}
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
This function is to get size of a file using Tftp.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to EFI_MTFTP4_CONFIG_DATA.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] WindowSize Pointer to required window size.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
|
|
@retval EFI_SUCCESS Successfully obtained the size of file.
|
|
@retval EFI_NOT_FOUND Parse the tftp options failed.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval Others Did not obtain the size of the file.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcMtftp4GetFileSize (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN EFI_MTFTP4_CONFIG_DATA *Config,
|
|
IN UINT8 *Filename,
|
|
IN UINTN *BlockSize,
|
|
IN UINTN *WindowSize,
|
|
IN OUT UINT64 *BufferSize
|
|
)
|
|
{
|
|
EFI_MTFTP4_PROTOCOL *Mtftp4;
|
|
EFI_MTFTP4_OPTION ReqOpt[3];
|
|
EFI_MTFTP4_PACKET *Packet;
|
|
EFI_MTFTP4_OPTION *Option;
|
|
UINT32 PktLen;
|
|
UINT8 OptBuf[PXE_MTFTP_OPTBUF_MAXNUM_INDEX];
|
|
UINTN OptBufSize;
|
|
UINT32 OptCnt;
|
|
EFI_STATUS Status;
|
|
|
|
*BufferSize = 0;
|
|
Status = EFI_DEVICE_ERROR;
|
|
Mtftp4 = Private->Mtftp4;
|
|
Packet = NULL;
|
|
Option = NULL;
|
|
PktLen = 0;
|
|
OptBufSize = PXE_MTFTP_OPTBUF_MAXNUM_INDEX;
|
|
OptCnt = 1;
|
|
Config->InitialServerPort = PXEBC_BS_DOWNLOAD_PORT;
|
|
|
|
Status = Mtftp4->Configure (Mtftp4, Config);
|
|
if (EFI_ERROR (Status)) {
|
|
return Status;
|
|
}
|
|
|
|
//
|
|
// Build the required options for get info.
|
|
//
|
|
ReqOpt[0].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_TSIZE_INDEX];
|
|
PxeBcUintnToAscDec (0, OptBuf, OptBufSize);
|
|
ReqOpt[0].ValueStr = OptBuf;
|
|
|
|
if (BlockSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_BLKSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = (UINT8 *)(ReqOpt[OptCnt-1].ValueStr + AsciiStrLen ((CHAR8 *)ReqOpt[OptCnt-1].ValueStr) + 1);
|
|
OptBufSize -= (AsciiStrLen ((CHAR8 *)ReqOpt[OptCnt-1].ValueStr) + 1);
|
|
PxeBcUintnToAscDec (*BlockSize, ReqOpt[OptCnt].ValueStr, OptBufSize);
|
|
OptCnt++;
|
|
}
|
|
|
|
if (WindowSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_WINDOWSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = (UINT8 *)(ReqOpt[OptCnt-1].ValueStr + AsciiStrLen ((CHAR8 *)ReqOpt[OptCnt-1].ValueStr) + 1);
|
|
OptBufSize -= (AsciiStrLen ((CHAR8 *)ReqOpt[OptCnt-1].ValueStr) + 1);
|
|
PxeBcUintnToAscDec (*WindowSize, ReqOpt[OptCnt].ValueStr, OptBufSize);
|
|
OptCnt++;
|
|
}
|
|
|
|
Status = Mtftp4->GetInfo (
|
|
Mtftp4,
|
|
NULL,
|
|
Filename,
|
|
NULL,
|
|
(UINT8)OptCnt,
|
|
ReqOpt,
|
|
&PktLen,
|
|
&Packet
|
|
);
|
|
if (EFI_ERROR (Status)) {
|
|
if (Status == EFI_TFTP_ERROR) {
|
|
//
|
|
// Store the tftp error message into mode data and set the received flag.
|
|
//
|
|
Private->Mode.TftpErrorReceived = TRUE;
|
|
Private->Mode.TftpError.ErrorCode = (UINT8)Packet->Error.ErrorCode;
|
|
AsciiStrnCpyS (
|
|
Private->Mode.TftpError.ErrorString,
|
|
PXE_MTFTP_ERROR_STRING_LENGTH,
|
|
(CHAR8 *)Packet->Error.ErrorMessage,
|
|
PXE_MTFTP_ERROR_STRING_LENGTH - 1
|
|
);
|
|
Private->Mode.TftpError.ErrorString[PXE_MTFTP_ERROR_STRING_LENGTH - 1] = '\0';
|
|
}
|
|
|
|
goto ON_ERROR;
|
|
}
|
|
|
|
//
|
|
// Parse the options in the reply packet.
|
|
//
|
|
OptCnt = 0;
|
|
Status = Mtftp4->ParseOptions (
|
|
Mtftp4,
|
|
PktLen,
|
|
Packet,
|
|
(UINT32 *)&OptCnt,
|
|
&Option
|
|
);
|
|
if (EFI_ERROR (Status)) {
|
|
goto ON_ERROR;
|
|
}
|
|
|
|
//
|
|
// Parse out the value of "tsize" option.
|
|
//
|
|
Status = EFI_NOT_FOUND;
|
|
while (OptCnt != 0) {
|
|
if (AsciiStrnCmp ((CHAR8 *)Option[OptCnt - 1].OptionStr, "tsize", 5) == 0) {
|
|
*BufferSize = AsciiStrDecimalToUint64 ((CHAR8 *)(Option[OptCnt - 1].ValueStr));
|
|
Status = EFI_SUCCESS;
|
|
}
|
|
|
|
OptCnt--;
|
|
}
|
|
|
|
FreePool (Option);
|
|
|
|
ON_ERROR:
|
|
if (Packet != NULL) {
|
|
FreePool (Packet);
|
|
}
|
|
|
|
Mtftp4->Configure (Mtftp4, NULL);
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
This function is to read the data of a file using Tftp.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to EFI_MTFTP4_CONFIG_DATA.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] WindowSize Pointer to required window size.
|
|
@param[in] BufferPtr Pointer to buffer.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
@param[in] DontUseBuffer Indicates whether to use a receive buffer.
|
|
|
|
@retval EFI_SUCCESS Successfully read the data from the special file.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval Others Read data from file failed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcMtftp4ReadFile (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN EFI_MTFTP4_CONFIG_DATA *Config,
|
|
IN UINT8 *Filename,
|
|
IN UINTN *BlockSize,
|
|
IN UINTN *WindowSize,
|
|
IN UINT8 *BufferPtr,
|
|
IN OUT UINT64 *BufferSize,
|
|
IN BOOLEAN DontUseBuffer
|
|
)
|
|
{
|
|
EFI_MTFTP4_PROTOCOL *Mtftp4;
|
|
EFI_MTFTP4_TOKEN Token;
|
|
EFI_MTFTP4_OPTION ReqOpt[2];
|
|
UINT32 OptCnt;
|
|
UINT8 BlksizeBuf[10];
|
|
UINT8 WindowsizeBuf[10];
|
|
EFI_STATUS Status;
|
|
|
|
Status = EFI_DEVICE_ERROR;
|
|
Mtftp4 = Private->Mtftp4;
|
|
OptCnt = 0;
|
|
Config->InitialServerPort = PXEBC_BS_DOWNLOAD_PORT;
|
|
|
|
Status = Mtftp4->Configure (Mtftp4, Config);
|
|
if (EFI_ERROR (Status)) {
|
|
return Status;
|
|
}
|
|
|
|
if (BlockSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_BLKSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = BlksizeBuf;
|
|
PxeBcUintnToAscDec (*BlockSize, ReqOpt[OptCnt].ValueStr, sizeof (BlksizeBuf));
|
|
OptCnt++;
|
|
}
|
|
|
|
if (WindowSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_WINDOWSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = WindowsizeBuf;
|
|
PxeBcUintnToAscDec (*WindowSize, ReqOpt[OptCnt].ValueStr, sizeof (WindowsizeBuf));
|
|
OptCnt++;
|
|
}
|
|
|
|
Token.Event = NULL;
|
|
Token.OverrideData = NULL;
|
|
Token.Filename = Filename;
|
|
Token.ModeStr = NULL;
|
|
Token.OptionCount = OptCnt;
|
|
Token.OptionList = ReqOpt;
|
|
Token.Context = Private;
|
|
|
|
if (DontUseBuffer) {
|
|
Token.BufferSize = 0;
|
|
Token.Buffer = NULL;
|
|
} else {
|
|
Token.BufferSize = *BufferSize;
|
|
Token.Buffer = BufferPtr;
|
|
}
|
|
|
|
Token.CheckPacket = PxeBcMtftp4CheckPacket;
|
|
Token.TimeoutCallback = NULL;
|
|
Token.PacketNeeded = NULL;
|
|
|
|
Status = Mtftp4->ReadFile (Mtftp4, &Token);
|
|
//
|
|
// Get the real size of received buffer.
|
|
//
|
|
*BufferSize = Token.BufferSize;
|
|
|
|
Mtftp4->Configure (Mtftp4, NULL);
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
This function is to write the data of a file using Tftp.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to EFI_MTFTP4_CONFIG_DATA.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] Overwrite Indicates whether to use the overwrite attribute.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] BufferPtr Pointer to buffer.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
|
|
@retval EFI_SUCCESS Successfully write the data into the special file.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval other Write data into file failed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcMtftp4WriteFile (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN EFI_MTFTP4_CONFIG_DATA *Config,
|
|
IN UINT8 *Filename,
|
|
IN BOOLEAN Overwrite,
|
|
IN UINTN *BlockSize,
|
|
IN UINT8 *BufferPtr,
|
|
IN OUT UINT64 *BufferSize
|
|
)
|
|
{
|
|
EFI_MTFTP4_PROTOCOL *Mtftp4;
|
|
EFI_MTFTP4_TOKEN Token;
|
|
EFI_MTFTP4_OPTION ReqOpt[1];
|
|
UINT32 OptCnt;
|
|
UINT8 OptBuf[128];
|
|
EFI_STATUS Status;
|
|
|
|
Status = EFI_DEVICE_ERROR;
|
|
Mtftp4 = Private->Mtftp4;
|
|
OptCnt = 0;
|
|
Config->InitialServerPort = PXEBC_BS_DOWNLOAD_PORT;
|
|
|
|
Status = Mtftp4->Configure (Mtftp4, Config);
|
|
if (EFI_ERROR (Status)) {
|
|
return Status;
|
|
}
|
|
|
|
if (BlockSize != NULL) {
|
|
ReqOpt[0].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_BLKSIZE_INDEX];
|
|
ReqOpt[0].ValueStr = OptBuf;
|
|
PxeBcUintnToAscDec (*BlockSize, ReqOpt[0].ValueStr, PXE_MTFTP_OPTBUF_MAXNUM_INDEX);
|
|
OptCnt++;
|
|
}
|
|
|
|
Token.Event = NULL;
|
|
Token.OverrideData = NULL;
|
|
Token.Filename = Filename;
|
|
Token.ModeStr = NULL;
|
|
Token.OptionCount = OptCnt;
|
|
Token.OptionList = ReqOpt;
|
|
Token.BufferSize = *BufferSize;
|
|
Token.Buffer = BufferPtr;
|
|
Token.CheckPacket = PxeBcMtftp4CheckPacket;
|
|
Token.TimeoutCallback = NULL;
|
|
Token.PacketNeeded = NULL;
|
|
|
|
Status = Mtftp4->WriteFile (Mtftp4, &Token);
|
|
//
|
|
// Get the real size of transmitted buffer.
|
|
//
|
|
*BufferSize = Token.BufferSize;
|
|
|
|
Mtftp4->Configure (Mtftp4, NULL);
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
This function is to get data (file) from a directory using Tftp.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to EFI_MTFTP4_CONFIG_DATA.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] WindowSize Pointer to required window size.
|
|
@param[in] BufferPtr Pointer to buffer.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
@param[in] DontUseBuffer Indicates whether to use a receive buffer.
|
|
|
|
@retval EFI_SUCCESS Successfully obtained the data from the file included in the directory.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval Others Operation failed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcMtftp4ReadDirectory (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN EFI_MTFTP4_CONFIG_DATA *Config,
|
|
IN UINT8 *Filename,
|
|
IN UINTN *BlockSize,
|
|
IN UINTN *WindowSize,
|
|
IN UINT8 *BufferPtr,
|
|
IN OUT UINT64 *BufferSize,
|
|
IN BOOLEAN DontUseBuffer
|
|
)
|
|
{
|
|
EFI_MTFTP4_PROTOCOL *Mtftp4;
|
|
EFI_MTFTP4_TOKEN Token;
|
|
EFI_MTFTP4_OPTION ReqOpt[2];
|
|
UINT32 OptCnt;
|
|
UINT8 BlksizeBuf[10];
|
|
UINT8 WindowsizeBuf[10];
|
|
EFI_STATUS Status;
|
|
|
|
Status = EFI_DEVICE_ERROR;
|
|
Mtftp4 = Private->Mtftp4;
|
|
OptCnt = 0;
|
|
Config->InitialServerPort = PXEBC_BS_DOWNLOAD_PORT;
|
|
|
|
Status = Mtftp4->Configure (Mtftp4, Config);
|
|
if (EFI_ERROR (Status)) {
|
|
return Status;
|
|
}
|
|
|
|
if (BlockSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_BLKSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = BlksizeBuf;
|
|
PxeBcUintnToAscDec (*BlockSize, ReqOpt[OptCnt].ValueStr, sizeof (BlksizeBuf));
|
|
OptCnt++;
|
|
}
|
|
|
|
if (WindowSize != NULL) {
|
|
ReqOpt[OptCnt].OptionStr = (UINT8 *)mMtftpOptions[PXE_MTFTP_OPTION_WINDOWSIZE_INDEX];
|
|
ReqOpt[OptCnt].ValueStr = WindowsizeBuf;
|
|
PxeBcUintnToAscDec (*WindowSize, ReqOpt[OptCnt].ValueStr, sizeof (WindowsizeBuf));
|
|
OptCnt++;
|
|
}
|
|
|
|
Token.Event = NULL;
|
|
Token.OverrideData = NULL;
|
|
Token.Filename = Filename;
|
|
Token.ModeStr = NULL;
|
|
Token.OptionCount = OptCnt;
|
|
Token.OptionList = ReqOpt;
|
|
Token.Context = Private;
|
|
|
|
if (DontUseBuffer) {
|
|
Token.BufferSize = 0;
|
|
Token.Buffer = NULL;
|
|
} else {
|
|
Token.BufferSize = *BufferSize;
|
|
Token.Buffer = BufferPtr;
|
|
}
|
|
|
|
Token.CheckPacket = PxeBcMtftp4CheckPacket;
|
|
Token.TimeoutCallback = NULL;
|
|
Token.PacketNeeded = NULL;
|
|
|
|
Status = Mtftp4->ReadDirectory (Mtftp4, &Token);
|
|
//
|
|
// Get the real size of received buffer.
|
|
//
|
|
*BufferSize = Token.BufferSize;
|
|
|
|
Mtftp4->Configure (Mtftp4, NULL);
|
|
|
|
return Status;
|
|
}
|
|
|
|
/**
|
|
This function is wrapper to get the file size using TFTP.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to configure data.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] WindowSize Pointer to required window size.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
|
|
@retval EFI_SUCCESS Successfully obtained the size of file.
|
|
@retval EFI_NOT_FOUND Parse the tftp options failed.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval Others Did not obtain the size of the file.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcTftpGetFileSize (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN VOID *Config,
|
|
IN UINT8 *Filename,
|
|
IN UINTN *BlockSize,
|
|
IN UINTN *WindowSize,
|
|
IN OUT UINT64 *BufferSize
|
|
)
|
|
{
|
|
if (Private->PxeBc.Mode->UsingIpv6) {
|
|
return PxeBcMtftp6GetFileSize (
|
|
Private,
|
|
(EFI_MTFTP6_CONFIG_DATA *)Config,
|
|
Filename,
|
|
BlockSize,
|
|
WindowSize,
|
|
BufferSize
|
|
);
|
|
} else {
|
|
return PxeBcMtftp4GetFileSize (
|
|
Private,
|
|
(EFI_MTFTP4_CONFIG_DATA *)Config,
|
|
Filename,
|
|
BlockSize,
|
|
WindowSize,
|
|
BufferSize
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
This function is a wrapper to get file using TFTP.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to config data.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] WindowSize Pointer to required window size.
|
|
@param[in] BufferPtr Pointer to buffer.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
@param[in] DontUseBuffer Indicates whether to use a receive buffer.
|
|
|
|
@retval EFI_SUCCESS Successfully read the data from the special file.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval Others Read data from file failed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcTftpReadFile (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN VOID *Config,
|
|
IN UINT8 *Filename,
|
|
IN UINTN *BlockSize,
|
|
IN UINTN *WindowSize,
|
|
IN UINT8 *BufferPtr,
|
|
IN OUT UINT64 *BufferSize,
|
|
IN BOOLEAN DontUseBuffer
|
|
)
|
|
{
|
|
if (Private->PxeBc.Mode->UsingIpv6) {
|
|
return PxeBcMtftp6ReadFile (
|
|
Private,
|
|
(EFI_MTFTP6_CONFIG_DATA *)Config,
|
|
Filename,
|
|
BlockSize,
|
|
WindowSize,
|
|
BufferPtr,
|
|
BufferSize,
|
|
DontUseBuffer
|
|
);
|
|
} else {
|
|
return PxeBcMtftp4ReadFile (
|
|
Private,
|
|
(EFI_MTFTP4_CONFIG_DATA *)Config,
|
|
Filename,
|
|
BlockSize,
|
|
WindowSize,
|
|
BufferPtr,
|
|
BufferSize,
|
|
DontUseBuffer
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
This function is a wrapper to write file using TFTP.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to config data.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] Overwrite Indicate whether with overwrite attribute.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] BufferPtr Pointer to buffer.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
|
|
@retval EFI_SUCCESS Successfully wrote the data into a special file.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval other Write data into file failed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcTftpWriteFile (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN VOID *Config,
|
|
IN UINT8 *Filename,
|
|
IN BOOLEAN Overwrite,
|
|
IN UINTN *BlockSize,
|
|
IN UINT8 *BufferPtr,
|
|
IN OUT UINT64 *BufferSize
|
|
)
|
|
{
|
|
if (Private->PxeBc.Mode->UsingIpv6) {
|
|
return PxeBcMtftp6WriteFile (
|
|
Private,
|
|
(EFI_MTFTP6_CONFIG_DATA *)Config,
|
|
Filename,
|
|
Overwrite,
|
|
BlockSize,
|
|
BufferPtr,
|
|
BufferSize
|
|
);
|
|
} else {
|
|
return PxeBcMtftp4WriteFile (
|
|
Private,
|
|
(EFI_MTFTP4_CONFIG_DATA *)Config,
|
|
Filename,
|
|
Overwrite,
|
|
BlockSize,
|
|
BufferPtr,
|
|
BufferSize
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
This function is a wrapper to get the data (file) from a directory using TFTP.
|
|
|
|
@param[in] Private Pointer to PxeBc private data.
|
|
@param[in] Config Pointer to config data.
|
|
@param[in] Filename Pointer to boot file name.
|
|
@param[in] BlockSize Pointer to required block size.
|
|
@param[in] WindowSize Pointer to required window size.
|
|
@param[in] BufferPtr Pointer to buffer.
|
|
@param[in, out] BufferSize Pointer to buffer size.
|
|
@param[in] DontUseBuffer Indicatse whether to use a receive buffer.
|
|
|
|
@retval EFI_SUCCESS Successfully obtained the data from the file included in the directory.
|
|
@retval EFI_DEVICE_ERROR The network device encountered an error during this operation.
|
|
@retval Others Operation failed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
PxeBcTftpReadDirectory (
|
|
IN PXEBC_PRIVATE_DATA *Private,
|
|
IN VOID *Config,
|
|
IN UINT8 *Filename,
|
|
IN UINTN *BlockSize,
|
|
IN UINTN *WindowSize,
|
|
IN UINT8 *BufferPtr,
|
|
IN OUT UINT64 *BufferSize,
|
|
IN BOOLEAN DontUseBuffer
|
|
)
|
|
{
|
|
if (Private->PxeBc.Mode->UsingIpv6) {
|
|
return PxeBcMtftp6ReadDirectory (
|
|
Private,
|
|
(EFI_MTFTP6_CONFIG_DATA *)Config,
|
|
Filename,
|
|
BlockSize,
|
|
WindowSize,
|
|
BufferPtr,
|
|
BufferSize,
|
|
DontUseBuffer
|
|
);
|
|
} else {
|
|
return PxeBcMtftp4ReadDirectory (
|
|
Private,
|
|
(EFI_MTFTP4_CONFIG_DATA *)Config,
|
|
Filename,
|
|
BlockSize,
|
|
WindowSize,
|
|
BufferPtr,
|
|
BufferSize,
|
|
DontUseBuffer
|
|
);
|
|
}
|
|
}
|