mirror of https://github.com/acidanthera/audk.git
116 lines
3.9 KiB
C
116 lines
3.9 KiB
C
/** @file
|
|
Routines to process MTFTP4 options.
|
|
|
|
Copyright (c) 2006 - 2007, Intel Corporation<BR>
|
|
All rights reserved. This program and the accompanying materials
|
|
are licensed and made available under the terms and conditions of the BSD License
|
|
which accompanies this distribution. The full text of the license may be found at
|
|
http://opensource.org/licenses/bsd-license.php<BR>
|
|
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
**/
|
|
|
|
|
|
#ifndef __EFI_MTFTP4_OPTION_H__
|
|
#define __EFI_MTFTP4_OPTION_H__
|
|
|
|
|
|
|
|
typedef enum {
|
|
MTFTP4_SUPPORTED_OPTIONS = 4,
|
|
MTFTP4_OPCODE_LEN = 2,
|
|
MTFTP4_ERRCODE_LEN = 2,
|
|
MTFTP4_BLKNO_LEN = 2,
|
|
MTFTP4_DATA_HEAD_LEN = 4,
|
|
|
|
MTFTP4_BLKSIZE_EXIST = 0x01,
|
|
MTFTP4_TIMEOUT_EXIST = 0x02,
|
|
MTFTP4_TSIZE_EXIST = 0x04,
|
|
MTFTP4_MCAST_EXIST = 0x08
|
|
} MTFTP4_OPTION_CONST_VALUE;
|
|
|
|
typedef struct {
|
|
UINT16 BlkSize;
|
|
UINT8 Timeout;
|
|
UINT32 Tsize;
|
|
IP4_ADDR McastIp;
|
|
UINT16 McastPort;
|
|
BOOLEAN Master;
|
|
UINT32 Exist;
|
|
} MTFTP4_OPTION;
|
|
|
|
/**
|
|
Allocate and fill in a array of Mtftp options from the Packet.
|
|
|
|
It first calls Mtftp4FillOption to get the option number, then allocate
|
|
the array, at last, call Mtftp4FillOption again to save the options.
|
|
|
|
@param Packet The packet to parse
|
|
@param PacketLen The length of the packet
|
|
@param OptionCount The number of options in the packet
|
|
@param OptionList The point to get the option array.
|
|
|
|
@retval EFI_INVALID_PARAMETER The parametera are invalid or packet isn't a
|
|
well-formated OACK packet.
|
|
@retval EFI_SUCCESS The option array is build
|
|
@retval EFI_OUT_OF_RESOURCES Failed to allocate memory for the array
|
|
|
|
**/
|
|
EFI_STATUS
|
|
Mtftp4ExtractOptions (
|
|
IN EFI_MTFTP4_PACKET *Packet,
|
|
IN UINT32 PacketLen,
|
|
OUT UINT32 *OptionCount,
|
|
OUT EFI_MTFTP4_OPTION **OptionList OPTIONAL
|
|
);
|
|
|
|
/**
|
|
Parse the option in Options array to MTFTP4_OPTION which program
|
|
can access directly.
|
|
|
|
@param Options The option array, which contains addresses of each
|
|
option's name/value string.
|
|
@param Count The number of options in the Options
|
|
@param Request Whether this is a request or OACK. The format of
|
|
multicast is different according to this setting.
|
|
@param MtftpOption The MTFTP4_OPTION for easy access.
|
|
|
|
@retval EFI_INVALID_PARAMETER The option is mal-formated
|
|
@retval EFI_UNSUPPORTED Some option isn't supported
|
|
@retval EFI_SUCCESS The option are OK and has been parsed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
Mtftp4ParseOption (
|
|
IN EFI_MTFTP4_OPTION *Options,
|
|
IN UINT32 Count,
|
|
IN BOOLEAN Request,
|
|
OUT MTFTP4_OPTION *MtftpOption
|
|
);
|
|
|
|
/**
|
|
Parse the options in the OACK packet to MTFTP4_OPTION which program
|
|
can access directly.
|
|
|
|
@param Packet The OACK packet to parse
|
|
@param PacketLen The length of the packet
|
|
@param MtftpOption The MTFTP_OPTION for easy access.
|
|
|
|
@retval EFI_INVALID_PARAMETER The packet option is mal-formated
|
|
@retval EFI_UNSUPPORTED Some option isn't supported
|
|
@retval EFI_SUCCESS The option are OK and has been parsed.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
Mtftp4ParseOptionOack (
|
|
IN EFI_MTFTP4_PACKET *Packet,
|
|
IN UINT32 PacketLen,
|
|
OUT MTFTP4_OPTION *MtftpOption
|
|
);
|
|
|
|
extern CHAR8 *mMtftp4SupportedOptions[MTFTP4_SUPPORTED_OPTIONS];
|
|
|
|
#endif
|