[mirror_edk2.git] / MdeModulePkg / Universal / Network / Mtftp4Dxe / Mtftp4Impl.c

/** @file\r
\r
Copyright (c) 2006 - 2007, Intel Corporation\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution.  The full text of the license may be found at\r
http://opensource.org/licenses/bsd-license.php\r
\r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
Module Name:\r
\r
  Mtftp4Impl.c\r
\r
Abstract:\r
\r
  Interface routine for Mtftp4\r
\r
\r
**/\r
\r
#include "Mtftp4Impl.h"\r
\r
EFI_STATUS\r
EFIAPI\r
EfiMtftp4ReadFile (\r
  IN EFI_MTFTP4_PROTOCOL    *This,\r
  IN EFI_MTFTP4_TOKEN       *Token\r
  );\r
\r
\r
/**\r
  Get the current operation parameter for the MTFTP session\r
\r
  @param  This                   The MTFTP protocol instance\r
  @param  ModeData               The MTFTP mode data\r
\r
  @retval EFI_INVALID_PARAMETER  This or ModeData is NULL\r
  @retval EFI_SUCCESS            The operation parameter is saved in ModeData\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
EfiMtftp4GetModeData (\r
  IN EFI_MTFTP4_PROTOCOL    *This,\r
  OUT EFI_MTFTP4_MODE_DATA  *ModeData\r
  )\r
{\r
  MTFTP4_PROTOCOL  *Instance;\r
  EFI_TPL          OldTpl;\r
\r
  if ((This == NULL) || (ModeData == NULL)) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  OldTpl = gBS->RaiseTPL (TPL_CALLBACK);\r
\r
  Instance                         = MTFTP4_PROTOCOL_FROM_THIS (This);\r
  CopyMem(&ModeData->ConfigData, &Instance->Config, sizeof (Instance->Config));\r
  ModeData->SupportedOptionCount   = MTFTP4_SUPPORTED_OPTIONS;\r
  ModeData->SupportedOptoins       = (UINT8 **) mMtftp4SupportedOptions;\r
  ModeData->UnsupportedOptionCount = 0;\r
  ModeData->UnsupportedOptoins     = NULL;\r
\r
  gBS->RestoreTPL (OldTpl);\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Clean up the MTFTP session to get ready for new operation.\r
\r
  @param  Instance               The MTFTP session to clean up\r
  @param  Result                 The result to return to the caller who initiated\r
                                 the operation.\r
\r
  @return None\r
\r
**/\r
VOID\r
Mtftp4CleanOperation (\r
  IN MTFTP4_PROTOCOL        *Instance,\r
  IN EFI_STATUS             Result\r
  )\r
{\r
  LIST_ENTRY                *Entry;\r
  LIST_ENTRY                *Next;\r
  MTFTP4_BLOCK_RANGE        *Block;\r
  EFI_MTFTP4_TOKEN          *Token;\r
\r
  //\r
  // Free various resources.\r
  //\r
  Token = Instance->Token;\r
\r
  if (Token != NULL) {\r
    Token->Status = Result;\r
\r
    if (Token->Event != NULL) {\r
      gBS->SignalEvent (Token->Event);\r
    }\r
\r
    Instance->Token = NULL;\r
  }\r
\r
  ASSERT (Instance->UnicastPort != NULL);\r
  UdpIoCleanPort (Instance->UnicastPort);\r
\r
  if (Instance->LastPacket != NULL) {\r
    NetbufFree (Instance->LastPacket);\r
    Instance->LastPacket = NULL;\r
  }\r
\r
  if (Instance->McastUdpPort != NULL) {\r
    UdpIoFreePort (Instance->McastUdpPort);\r
    Instance->McastUdpPort = NULL;\r
  }\r
\r
  NET_LIST_FOR_EACH_SAFE (Entry, Next, &Instance->Blocks) {\r
    Block = NET_LIST_USER_STRUCT (Entry, MTFTP4_BLOCK_RANGE, Link);\r
    RemoveEntryList (Entry);\r
    gBS->FreePool (Block);\r
  }\r
\r
  ZeroMem (&Instance->RequestOption, sizeof (MTFTP4_OPTION));\r
\r
  Instance->Operation     = 0;\r
\r
  Instance->BlkSize       = MTFTP4_DEFAULT_BLKSIZE;\r
  Instance->LastBlock     = 0;\r
  Instance->ServerIp      = 0;\r
  Instance->ListeningPort = 0;\r
  Instance->ConnectedPort = 0;\r
  Instance->Gateway       = 0;\r
  Instance->PacketToLive  = 0;\r
  Instance->MaxRetry      = 0;\r
  Instance->CurRetry      = 0;\r
  Instance->Timeout       = 0;\r
  Instance->McastIp       = 0;\r
  Instance->McastPort     = 0;\r
  Instance->Master        = TRUE;\r
}\r
\r
\r
/**\r
  Configure the MTFTP session for new operation or reset the current\r
  operation if ConfigData is NULL.\r
\r
  @param  This                   The MTFTP session to configure\r
  @param  ConfigData             The configure parameters\r
\r
  @retval EFI_INVALID_PARAMETER  Some of the parameter is invalid.\r
  @retval EFI_ACCESS_DENIED      There is pending operation\r
  @retval EFI_SUCCESS            The instance is configured for operation.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
EfiMtftp4Configure (\r
  IN EFI_MTFTP4_PROTOCOL    *This,\r
  IN EFI_MTFTP4_CONFIG_DATA *ConfigData\r
  )\r
{\r
  MTFTP4_PROTOCOL           *Instance;\r
  EFI_TPL                   OldTpl;\r
  IP4_ADDR                  Ip;\r
  IP4_ADDR                  Netmask;\r
  IP4_ADDR                  Gateway;\r
  IP4_ADDR                  ServerIp;\r
\r
  if (This == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  Instance = MTFTP4_PROTOCOL_FROM_THIS (This);\r
\r
  if (ConfigData == NULL) {\r
    //\r
    // Reset the operation if ConfigData is NULL\r
    //\r
    OldTpl = gBS->RaiseTPL (TPL_CALLBACK);\r
\r
    Mtftp4CleanOperation (Instance, EFI_ABORTED);\r
    ZeroMem (&Instance->Config, sizeof (EFI_MTFTP4_CONFIG_DATA));\r
    Instance->State = MTFTP4_STATE_UNCONFIGED;\r
\r
    gBS->RestoreTPL (OldTpl);\r
\r
  } else {\r
    //\r
    // Configure the parameters for new operation.\r
    //\r
    CopyMem (&Ip, &ConfigData->StationIp, sizeof (IP4_ADDR));\r
    CopyMem (&Netmask, &ConfigData->SubnetMask, sizeof (IP4_ADDR));\r
    CopyMem (&Gateway, &ConfigData->GatewayIp, sizeof (IP4_ADDR));\r
    CopyMem (&ServerIp, &ConfigData->ServerIp, sizeof (IP4_ADDR));\r
\r
    Ip       = NTOHL (Ip);\r
    Netmask  = NTOHL (Netmask);\r
    Gateway  = NTOHL (Gateway);\r
    ServerIp = NTOHL (ServerIp);\r
\r
    if (!Ip4IsUnicast (ServerIp, 0)) {\r
      return EFI_INVALID_PARAMETER;\r
    }\r
\r
    if (!ConfigData->UseDefaultSetting &&\r
       ((!IP4_IS_VALID_NETMASK (Netmask) || !Ip4IsUnicast (Ip, Netmask)))) {\r
\r
      return EFI_INVALID_PARAMETER;\r
    }\r
\r
    if ((Gateway != 0) &&\r
       (!IP4_NET_EQUAL (Gateway, Ip, Netmask) || !Ip4IsUnicast (Gateway, Netmask))) {\r
\r
      return EFI_INVALID_PARAMETER;\r
    }\r
\r
    OldTpl = gBS->RaiseTPL (TPL_CALLBACK);\r
\r
    if ((Instance->State == MTFTP4_STATE_CONFIGED) && (Instance->Operation != 0)) {\r
      gBS->RestoreTPL (OldTpl);\r
      return EFI_ACCESS_DENIED;\r
    }\r
\r
    CopyMem(&Instance->Config, ConfigData, sizeof (*ConfigData));;\r
    Instance->State = MTFTP4_STATE_CONFIGED;\r
\r
    gBS->RestoreTPL (OldTpl);\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Check packet for GetInfo. GetInfo is implemented with EfiMtftp4ReadFile.\r
  It use Mtftp4GetInfoCheckPacket to inspect the first packet from server,\r
  then abort the session.\r
\r
  @param  This                   The MTFTP4 protocol instance\r
  @param  Token                  The user's token\r
  @param  PacketLen              The length of the packet\r
  @param  Packet                 The received packet.\r
\r
  @retval EFI_ABORTED            Abort the ReadFile operation and return.\r
\r
**/\r
EFI_STATUS\r
Mtftp4GetInfoCheckPacket (\r
  IN EFI_MTFTP4_PROTOCOL    *This,\r
  IN EFI_MTFTP4_TOKEN       *Token,\r
  IN UINT16                 PacketLen,\r
  IN EFI_MTFTP4_PACKET      *Packet\r
  )\r
{\r
  MTFTP4_PROTOCOL           *Instance;\r
  MTFTP4_GETINFO_STATE      *State;\r
  EFI_STATUS                Status;\r
  UINT16                    OpCode;\r
\r
  Instance = MTFTP4_PROTOCOL_FROM_THIS (This);\r
  State    = &Instance->GetInfoState;\r
  OpCode   = NTOHS (Packet->OpCode);\r
\r
  //\r
  // Set the GetInfo's return status according to the OpCode.\r
  //\r
  switch (OpCode) {\r
  case EFI_MTFTP4_OPCODE_ERROR:\r
    State->Status = EFI_TFTP_ERROR;\r
    break;\r
\r
  case EFI_MTFTP4_OPCODE_OACK:\r
    State->Status = EFI_SUCCESS;\r
    break;\r
\r
  default:\r
    State->Status = EFI_PROTOCOL_ERROR;\r
  }\r
\r
  //\r
  // Allocate buffer then copy the packet over. Use gBS->AllocatePool\r
  // in case AllocatePool will implements something tricky.\r
  //\r
  Status = gBS->AllocatePool (EfiBootServicesData, PacketLen, (VOID **) State->Packet);\r
\r
  if (EFI_ERROR (Status)) {\r
    State->Status = EFI_OUT_OF_RESOURCES;\r
    return EFI_ABORTED;\r
  }\r
\r
  *(State->PacketLen) = PacketLen;\r
  CopyMem (*(State->Packet), Packet, PacketLen);\r
\r
  return EFI_ABORTED;\r
}\r
\r
\r
/**\r
  Get the information of the download from the server. It is implemented\r
  with EfiMtftp4ReadFile: build a token, then pass it to EfiMtftp4ReadFile.\r
  In its check packet callback abort the opertions.\r
\r
  @param  This                   The MTFTP protocol instance\r
  @param  OverrideData           The MTFTP override data\r
  @param  Filename               The file to get information\r
  @param  ModeStr                The mode to use\r
  @param  OptionCount            The number of options to append\r
  @param  OptionList             The options to append\r
  @param  PacketLength           The variable to receive the packet length\r
  @param  Packet                 The variable to receive the packet.\r
\r
  @retval EFI_INVALID_PARAMETER  The parameter is invaid\r
  @retval EFI_SUCCESS            The information is got\r
  @retval Others                 Failed to get the information.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
EfiMtftp4GetInfo (\r
  IN EFI_MTFTP4_PROTOCOL      *This,\r
  IN EFI_MTFTP4_OVERRIDE_DATA *OverrideData,        OPTIONAL\r
  IN UINT8                    *Filename,\r
  IN UINT8                    *ModeStr,             OPTIONAL\r
  IN UINT8                    OptionCount,\r
  IN EFI_MTFTP4_OPTION        *OptionList,\r
  OUT UINT32                  *PacketLength,\r
  OUT EFI_MTFTP4_PACKET       **Packet OPTIONAL\r
  )\r
{\r
  EFI_MTFTP4_TOKEN          Token;\r
  MTFTP4_PROTOCOL           *Instance;\r
  MTFTP4_GETINFO_STATE      *State;\r
  EFI_STATUS                Status;\r
\r
  if ((This == NULL) || (Filename == NULL) || (PacketLength == NULL) ||\r
      (OptionCount && (OptionList == NULL))) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  if (Packet != NULL) {\r
    *Packet = NULL;\r
  }\r
\r
  *PacketLength         = 0;\r
  Instance              = MTFTP4_PROTOCOL_FROM_THIS (This);\r
  State                 = &Instance->GetInfoState;\r
  State->Packet          = Packet;\r
  State->PacketLen       = PacketLength;\r
  State->Status          = EFI_SUCCESS;\r
\r
  //\r
  // Fill in the Token to issue an synchronous ReadFile operation\r
  //\r
  Token.Status          = EFI_SUCCESS;\r
  Token.Event           = NULL;\r
  Token.OverrideData    = OverrideData;\r
  Token.Filename        = Filename;\r
  Token.ModeStr         = ModeStr;\r
  Token.OptionCount     = OptionCount;\r
  Token.OptionList      = OptionList;\r
  Token.BufferSize      = 0;\r
  Token.Buffer          = NULL;\r
  Token.CheckPacket     = Mtftp4GetInfoCheckPacket;\r
  Token.TimeoutCallback = NULL;\r
  Token.PacketNeeded    = NULL;\r
\r
  Status                = EfiMtftp4ReadFile (This, &Token);\r
\r
  if (EFI_ABORTED == Status) {\r
    return State->Status;\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Parse the packet into an array of options. The OptionList is allocated\r
  by this function, and caller should free it when used.\r
\r
  @param  This                   The MTFTP protocol instance\r
  @param  PacketLen              The length of the packet\r
  @param  Packet                 The packet to parse\r
  @param  OptionCount            The size of the OptionList array allocated.\r
  @param  OptionList             The allocated option array to save the option\r
                                 addresses.\r
\r
  @retval EFI_INVALID_PARAMETER  The parameters are invalid.\r
  @retval EFI_NOT_FOUND          There is no valid option in the packet\r
  @retval EFI_SUCCESS            The packet is parsed.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
EfiMtftp4ParseOptions (\r
  IN EFI_MTFTP4_PROTOCOL    *This,\r
  IN UINT32                 PacketLen,\r
  IN EFI_MTFTP4_PACKET      *Packet,\r
  IN OUT UINT32             *OptionCount,\r
  OUT EFI_MTFTP4_OPTION     **OptionList          OPTIONAL\r
  )\r
{\r
  EFI_STATUS                Status;\r
\r
  if ((This == NULL) || (PacketLen < MTFTP4_OPCODE_LEN) ||\r
      (Packet == NULL) || (OptionCount == NULL)) {\r
\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  Status = Mtftp4ExtractOptions (Packet, PacketLen, OptionCount, OptionList);\r
\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  if (*OptionCount == 0) {\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Check whether the override data is valid. It will first\r
  validate whether the server is a valid unicast. If a gateway\r
  is provided in the Override, it also check that it is a\r
  unicast on the connected network.\r
\r
  @param  Instance               The MTFTP instance\r
  @param  Override               The override data to validate.\r
\r
  @return TRUE if the override data is valid, otherwise FALSE.\r
\r
**/\r
BOOLEAN\r
Mtftp4OverrideValid (\r
  IN MTFTP4_PROTOCOL          *Instance,\r
  IN EFI_MTFTP4_OVERRIDE_DATA *Override\r
  )\r
{\r
  EFI_MTFTP4_CONFIG_DATA    *Config;\r
  IP4_ADDR                  Ip;\r
  IP4_ADDR                  Netmask;\r
  IP4_ADDR                  Gateway;\r
\r
  CopyMem (&Ip, &Override->ServerIp, sizeof (IP4_ADDR));\r
  if (!Ip4IsUnicast (NTOHL (Ip), 0)) {\r
    return FALSE;\r
  }\r
\r
  Config = &Instance->Config;\r
\r
  CopyMem (&Gateway, &Override->GatewayIp, sizeof (IP4_ADDR));\r
  Gateway = NTOHL (Gateway);\r
\r
  if (!Config->UseDefaultSetting && (Gateway != 0)) {\r
    CopyMem (&Netmask, &Config->SubnetMask, sizeof (IP4_ADDR));\r
    CopyMem (&Ip, &Config->StationIp, sizeof (IP4_ADDR));\r
\r
    Netmask = NTOHL (Netmask);\r
    Ip      = NTOHL (Ip);\r
\r
    if (!Ip4IsUnicast (Gateway, Netmask) || !IP4_NET_EQUAL (Gateway, Ip, Netmask)) {\r
      return FALSE;\r
    }\r
  }\r
\r
  return TRUE;\r
}\r
\r
\r
/**\r
  Poll the UDP to get the IP4 default address, which may be retrieved\r
  by DHCP. The default time out value is 5 seconds. If IP has retrieved\r
  the default address, the UDP is reconfigured.\r
\r
  @param  Instance               The Mtftp instance\r
  @param  UdpPort                The UDP port to poll\r
  @param  UdpCfgData             The UDP configure data to reconfigure the UDP\r
                                 port.\r
\r
  @return TRUE if the default address is retrieved and UDP is reconfigured.\r
  @return Otherwise FALSE.\r
\r
**/\r
BOOLEAN\r
Mtftp4GetMapping (\r
  IN MTFTP4_PROTOCOL        *Instance,\r
  IN UDP_IO_PORT            *UdpPort,\r
  IN EFI_UDP4_CONFIG_DATA   *UdpCfgData\r
  )\r
{\r
  MTFTP4_SERVICE            *Service;\r
  EFI_IP4_MODE_DATA         Ip4Mode;\r
  EFI_UDP4_PROTOCOL         *Udp;\r
  EFI_STATUS                Status;\r
\r
  ASSERT (Instance->Config.UseDefaultSetting);\r
\r
  Service = Instance->Service;\r
  Udp     = UdpPort->Udp;\r
\r
  Status = gBS->SetTimer (\r
                  Service->TimerToGetMap,\r
                  TimerRelative,\r
                  MTFTP4_TIME_TO_GETMAP * TICKS_PER_SECOND\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    return FALSE;\r
  }\r
\r
  while (!EFI_ERROR (gBS->CheckEvent (Service->TimerToGetMap))) {\r
    Udp->Poll (Udp);\r
\r
    if (!EFI_ERROR (Udp->GetModeData (Udp, NULL, &Ip4Mode, NULL, NULL)) &&\r
        Ip4Mode.IsConfigured) {\r
\r
      Udp->Configure (Udp, NULL);\r
      return (BOOLEAN) (Udp->Configure (Udp, UdpCfgData) == EFI_SUCCESS);\r
    }\r
  }\r
\r
  return FALSE;\r
}\r
\r
\r
/**\r
  Configure the UDP port for unicast receiving.\r
\r
  @param  UdpIo                  The UDP port\r
  @param  Instance               The MTFTP session\r
\r
  @retval EFI_SUCCESS            The UDP port is successfully configured for the\r
                                 session to unicast receive.\r
\r
**/\r
EFI_STATUS\r
Mtftp4ConfigUnicastPort (\r
  IN UDP_IO_PORT            *UdpIo,\r
  IN MTFTP4_PROTOCOL        *Instance\r
  )\r
{\r
  EFI_MTFTP4_CONFIG_DATA    *Config;\r
  EFI_UDP4_CONFIG_DATA      UdpConfig;\r
  EFI_STATUS                Status;\r
  IP4_ADDR                  Ip;\r
\r
  Config = &Instance->Config;\r
\r
  UdpConfig.AcceptBroadcast    = FALSE;\r
  UdpConfig.AcceptPromiscuous  = FALSE;\r
  UdpConfig.AcceptAnyPort      = FALSE;\r
  UdpConfig.AllowDuplicatePort = FALSE;\r
  UdpConfig.TypeOfService      = 0;\r
  UdpConfig.TimeToLive         = 64;\r
  UdpConfig.DoNotFragment      = FALSE;\r
  UdpConfig.ReceiveTimeout     = 0;\r
  UdpConfig.TransmitTimeout    = 0;\r
  UdpConfig.UseDefaultAddress  = Config->UseDefaultSetting;\r
  UdpConfig.StationAddress     = Config->StationIp;\r
  UdpConfig.SubnetMask         = Config->SubnetMask;\r
  UdpConfig.StationPort        = 0;\r
  UdpConfig.RemotePort         = 0;\r
\r
  Ip = HTONL (Instance->ServerIp);\r
  CopyMem (&UdpConfig.RemoteAddress, &Ip, sizeof (EFI_IPv4_ADDRESS));\r
\r
  Status = UdpIo->Udp->Configure (UdpIo->Udp, &UdpConfig);\r
\r
  if ((Status == EFI_NO_MAPPING) && Mtftp4GetMapping (Instance, UdpIo, &UdpConfig)) {\r
    return EFI_SUCCESS;\r
  }\r
\r
  if (!Config->UseDefaultSetting && !EFI_IP4_EQUAL (&mZeroIp4Addr, &Config->GatewayIp)) {\r
    //\r
    // The station IP address is manually configured and the Gateway IP is not 0.\r
    // Add the default route for this UDP instance.\r
    //\r
    Status = UdpIo->Udp->Routes (UdpIo->Udp, FALSE, &mZeroIp4Addr, &mZeroIp4Addr, &Config->GatewayIp);\r
    if (EFI_ERROR (Status)) {\r
      UdpIo->Udp->Configure (UdpIo->Udp, NULL);\r
    }\r
  }\r
  return Status;\r
}\r
\r
\r
/**\r
  Start the MTFTP session to do the operation, such as read file,\r
  write file, and read directory.\r
\r
  @param  This                   The MTFTP session\r
  @param  Token                  The token than encapsues the user's request.\r
  @param  Operation              The operation to do\r
\r
  @retval EFI_INVALID_PARAMETER  Some of the parameters are invalid.\r
  @retval EFI_NOT_STARTED        The MTFTP session hasn't been configured.\r
  @retval EFI_ALREADY_STARTED    There is pending operation for the session.\r
  @retval EFI_SUCCESS            The operation is successfully started.\r
\r
**/\r
EFI_STATUS\r
Mtftp4Start (\r
  IN EFI_MTFTP4_PROTOCOL    *This,\r
  IN EFI_MTFTP4_TOKEN       *Token,\r
  IN UINT16                 Operation\r
  )\r
{\r
  MTFTP4_PROTOCOL           *Instance;\r
  EFI_MTFTP4_OVERRIDE_DATA  *Override;\r
  EFI_MTFTP4_CONFIG_DATA    *Config;\r
  EFI_TPL                   OldTpl;\r
  EFI_STATUS                Status;\r
\r
  //\r
  // Validate the parameters\r
  //\r
  if ((This == NULL) || (Token == NULL) || (Token->Filename == NULL) ||\r
      ((Token->OptionCount != 0) && (Token->OptionList == NULL))) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // User must provide at least one method to collect the data for download.\r
  //\r
  if (((Operation == EFI_MTFTP4_OPCODE_RRQ) || (Operation == EFI_MTFTP4_OPCODE_DIR)) &&\r
      ((Token->Buffer == NULL) && (Token->CheckPacket == NULL))) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // User must provide at least one method to provide the data for upload.\r
  //\r
  if ((Operation == EFI_MTFTP4_OPCODE_WRQ) &&\r
     ((Token->Buffer == NULL) && (Token->PacketNeeded == NULL))) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  Instance = MTFTP4_PROTOCOL_FROM_THIS (This);\r
\r
  Status = EFI_SUCCESS;\r
  OldTpl = gBS->RaiseTPL (TPL_CALLBACK);\r
\r
  if (Instance->State != MTFTP4_STATE_CONFIGED) {\r
    Status = EFI_NOT_STARTED;\r
  }\r
\r
  if (Instance->Operation != 0) {\r
    Status = EFI_ACCESS_DENIED;\r
  }\r
\r
  if (EFI_ERROR (Status)) {\r
    gBS->RestoreTPL (OldTpl);\r
    return Status;\r
  }\r
\r
  //\r
  // Set the Operation now to prevent the application start other\r
  // operations.\r
  //\r
  Instance->Operation = Operation;\r
  Override            = Token->OverrideData;\r
\r
  if ((Override != NULL) && !Mtftp4OverrideValid (Instance, Override)) {\r
    Status = EFI_INVALID_PARAMETER;\r
    goto ON_ERROR;\r
  }\r
\r
  if (Token->OptionCount != 0) {\r
    Status = Mtftp4ParseOption (\r
               Token->OptionList,\r
               Token->OptionCount,\r
               TRUE,\r
               &Instance->RequestOption\r
               );\r
\r
    if (EFI_ERROR (Status)) {\r
      goto ON_ERROR;\r
    }\r
  }\r
\r
  //\r
  // Set the operation parameters from the configuration or override data.\r
  //\r
  Config                  = &Instance->Config;\r
  Instance->Token         = Token;\r
  Instance->BlkSize       = MTFTP4_DEFAULT_BLKSIZE;\r
\r
  CopyMem (&Instance->ServerIp, &Config->ServerIp, sizeof (IP4_ADDR));\r
  Instance->ServerIp      = NTOHL (Instance->ServerIp);\r
\r
  Instance->ListeningPort = Config->InitialServerPort;\r
  Instance->ConnectedPort = 0;\r
\r
  CopyMem (&Instance->Gateway, &Config->GatewayIp, sizeof (IP4_ADDR));\r
  Instance->Gateway       = NTOHL (Instance->Gateway);\r
\r
  Instance->MaxRetry      = Config->TryCount;\r
  Instance->Timeout       = Config->TimeoutValue;\r
  Instance->Master        = TRUE;\r
\r
  if (Override != NULL) {\r
    CopyMem (&Instance->ServerIp, &Override->ServerIp, sizeof (IP4_ADDR));\r
    CopyMem (&Instance->Gateway, &Override->GatewayIp, sizeof (IP4_ADDR));\r
\r
    Instance->ServerIp      = NTOHL (Instance->ServerIp);\r
    Instance->Gateway       = NTOHL (Instance->Gateway);\r
\r
    Instance->ListeningPort = Override->ServerPort;\r
    Instance->MaxRetry      = Override->TryCount;\r
    Instance->Timeout       = Override->TimeoutValue;\r
  }\r
\r
  if (Instance->ListeningPort == 0) {\r
    Instance->ListeningPort = MTFTP4_DEFAULT_SERVER_PORT;\r
  }\r
\r
  if (Instance->MaxRetry == 0) {\r
    Instance->MaxRetry = MTFTP4_DEFAULT_RETRY;\r
  }\r
\r
  if (Instance->Timeout == 0) {\r
    Instance->Timeout = MTFTP4_DEFAULT_TIMEOUT;\r
  }\r
\r
  //\r
  // Config the unicast UDP child to send initial request\r
  //\r
  Status = Mtftp4ConfigUnicastPort (Instance->UnicastPort, Instance);\r
\r
  if (EFI_ERROR (Status)) {\r
    goto ON_ERROR;\r
  }\r
\r
  //\r
  // Set initial status.\r
  //\r
  Token->Status = EFI_NOT_READY;\r
\r
  //\r
  // Build and send an initial requests\r
  //\r
  if (Operation == EFI_MTFTP4_OPCODE_WRQ) {\r
    Status = Mtftp4WrqStart (Instance, Operation);\r
  } else {\r
    Status = Mtftp4RrqStart (Instance, Operation);\r
  }\r
\r
  gBS->RestoreTPL (OldTpl);\r
\r
  if (EFI_ERROR (Status)) {\r
    goto ON_ERROR;\r
  }\r
\r
  if (Token->Event != NULL) {\r
    return EFI_SUCCESS;\r
  }\r
\r
  //\r
  // Return immediately for asynchronous operation or poll the\r
  // instance for synchronous operation.\r
  //\r
  while (Token->Status == EFI_NOT_READY) {\r
    This->Poll (This);\r
  }\r
\r
  return Token->Status;\r
\r
ON_ERROR:\r
  Mtftp4CleanOperation (Instance, Status);\r
  gBS->RestoreTPL (OldTpl);\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Read a file from the server.\r
\r
  @param  This                   The Mtftp protocol instance.\r
  @param  Token                  The user's request wrap token.\r
\r
  @retval EFI_SUCCESS            The ReadFile has finished, the file has been\r
                                 downloaded if it is synchronous operation,\r
                                 otherwise it has been  initated.\r
  @retval Others                 Some error happened.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
EfiMtftp4ReadFile (\r
  IN EFI_MTFTP4_PROTOCOL    *This,\r
  IN EFI_MTFTP4_TOKEN       *Token\r
  )\r
{\r
  return Mtftp4Start (This, Token, EFI_MTFTP4_OPCODE_RRQ);\r
}\r
\r
\r
/**\r
  Upload a file to the server.\r
\r
  @param  This                   The MTFTP protocol session\r
  @param  Token                  The user's request wrap token.\r
\r
  @retval EFI_SUCCESS            The WriteFile has finished, the file has been\r
                                 uploaded if it is synchronous operation, otherwise\r
                                 it has been  initated.\r
  @retval Others                 Some error happened.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
EfiMtftp4WriteFile (\r
  IN EFI_MTFTP4_PROTOCOL    *This,\r
  IN EFI_MTFTP4_TOKEN       *Token\r
  )\r
{\r
  return Mtftp4Start (This, Token, EFI_MTFTP4_OPCODE_WRQ);\r
}\r
\r
\r
/**\r
  Read a directory from the server. The only difference\r
  between ReadFile and ReadDirectory is the opcode used.\r
\r
  @param  This                   The MTFTP protocol session\r
  @param  Token                  The user's request wrap token.\r
\r
  @retval EFI_SUCCESS            The ReadDirectory has finished, the directory has\r
                                 been  downloaded as a file if it is synchronous\r
                                 operation,  otherwise it has been initated.\r
  @retval Others                 Some error happened.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
EfiMtftp4ReadDirectory (\r
  IN EFI_MTFTP4_PROTOCOL        *This,\r
  IN EFI_MTFTP4_TOKEN           *Token\r
  )\r
{\r
  return Mtftp4Start (This, Token, EFI_MTFTP4_OPCODE_DIR);\r
}\r
\r
\r
/**\r
  Poll the network stack to accelerate the packet process.\r
\r
  @param  This                   The MTFTP protocol instance.\r
\r
  @retval EFI_INVALID_PARAMETER  This is NULL.\r
  @retval EFI_NOT_STARTED        The MTFTP session hasn't been configured.\r
  @retval EFI_DEVICE_ERROR       The MTFTP session has been destoried.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
EfiMtftp4Poll (\r
  IN EFI_MTFTP4_PROTOCOL    *This\r
  )\r
{\r
  MTFTP4_PROTOCOL           *Instance;\r
  EFI_UDP4_PROTOCOL         *Udp;\r
\r
  if (This == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  Instance = MTFTP4_PROTOCOL_FROM_THIS (This);\r
\r
  if (Instance->State == MTFTP4_STATE_UNCONFIGED) {\r
    return EFI_NOT_STARTED;\r
  } else if (Instance->State == MTFTP4_STATE_DESTORY) {\r
    return EFI_DEVICE_ERROR;\r
  }\r
\r
  Udp = Instance->UnicastPort->Udp;\r
  return Udp->Poll (Udp);\r
}\r
\r
EFI_MTFTP4_PROTOCOL gMtftp4ProtocolTemplate = {\r
  EfiMtftp4GetModeData,\r
  EfiMtftp4Configure,\r
  EfiMtftp4GetInfo,\r
  EfiMtftp4ParseOptions,\r
  EfiMtftp4ReadFile,\r
  EfiMtftp4WriteFile,\r
  EfiMtftp4ReadDirectory,\r
  EfiMtftp4Poll\r
};\r