projects / mirror_edk2.git / blame
| Commit | Line | Data |
|---|---|---|
| a3bcde70 HT |
1 | /** @file\r |
| 2 | Mtftp6 internal data structure and definition declaration.\r | |
| 3 | \r | |
| f3427f12 | 4 | Copyright (c) 2009 - 2018, Intel Corporation. All rights reserved. <BR>\r |
| a3bcde70 HT |
5 | \r |
| 6 | This program and the accompanying materials\r | |
| 7 | are licensed and made available under the terms and conditions of the BSD License\r | |
| 8 | which accompanies this distribution. The full text of the license may be found at\r | |
| 9 | http://opensource.org/licenses/bsd-license.php.\r | |
| 10 | \r | |
| 11 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r | |
| 12 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r | |
| 13 | \r | |
| 14 | **/\r | |
| 15 | \r | |
| 16 | #ifndef __EFI_MTFTP6_IMPL_H__\r | |
| 17 | #define __EFI_MTFTP6_IMPL_H__\r | |
| 18 | \r | |
| 19 | #include <Uefi.h>\r | |
| 20 | \r | |
| 21 | #include <Protocol/Udp6.h>\r | |
| 22 | #include <Protocol/Mtftp6.h>\r | |
| 23 | #include <Protocol/ServiceBinding.h>\r | |
| 24 | #include <Protocol/DriverBinding.h>\r | |
| 25 | \r | |
| 26 | #include <Library/DebugLib.h>\r | |
| 27 | #include <Library/UefiDriverEntryPoint.h>\r | |
| 28 | #include <Library/UefiBootServicesTableLib.h>\r | |
| 29 | #include <Library/UefiLib.h>\r | |
| 30 | #include <Library/BaseLib.h>\r | |
| 31 | #include <Library/NetLib.h>\r | |
| 216f7970 | 32 | #include <Library/PrintLib.h>\r |
| a3bcde70 HT |
33 | \r |
| 34 | typedef struct _MTFTP6_SERVICE MTFTP6_SERVICE;\r | |
| 35 | typedef struct _MTFTP6_INSTANCE MTFTP6_INSTANCE;\r | |
| 36 | \r | |
| 37 | #include "Mtftp6Driver.h"\r | |
| 38 | #include "Mtftp6Option.h"\r | |
| 39 | #include "Mtftp6Support.h"\r | |
| 40 | \r | |
| 41 | #define MTFTP6_SERVICE_SIGNATURE SIGNATURE_32 ('M', 'F', '6', 'S')\r | |
| 42 | #define MTFTP6_INSTANCE_SIGNATURE SIGNATURE_32 ('M', 'F', '6', 'I')\r | |
| 43 | \r | |
| 44 | #define MTFTP6_DEFAULT_SERVER_CMD_PORT 69\r | |
| 45 | #define MTFTP6_DEFAULT_TIMEOUT 3\r | |
| 46 | #define MTFTP6_GET_MAPPING_TIMEOUT 3\r | |
| 47 | #define MTFTP6_DEFAULT_MAX_RETRY 5\r | |
| 48 | #define MTFTP6_DEFAULT_BLK_SIZE 512\r | |
| f3427f12 | 49 | #define MTFTP6_DEFAULT_WINDOWSIZE 1\r |
| a3bcde70 HT |
50 | #define MTFTP6_TICK_PER_SECOND 10000000U\r |
| 51 | \r | |
| 52 | #define MTFTP6_SERVICE_FROM_THIS(a) CR (a, MTFTP6_SERVICE, ServiceBinding, MTFTP6_SERVICE_SIGNATURE)\r | |
| 53 | #define MTFTP6_INSTANCE_FROM_THIS(a) CR (a, MTFTP6_INSTANCE, Mtftp6, MTFTP6_INSTANCE_SIGNATURE)\r | |
| 54 | \r | |
| 55 | extern EFI_MTFTP6_PROTOCOL gMtftp6ProtocolTemplate;\r | |
| 56 | \r | |
| 57 | typedef struct _MTFTP6_GETINFO_CONTEXT{\r | |
| 58 | EFI_MTFTP6_PACKET **Packet;\r | |
| 59 | UINT32 *PacketLen;\r | |
| 60 | EFI_STATUS Status;\r | |
| 61 | } MTFTP6_GETINFO_CONTEXT;\r | |
| 62 | \r | |
| 63 | //\r | |
| 64 | // Control block for MTFTP6 instance, it's per configuration data.\r | |
| 65 | //\r | |
| 66 | struct _MTFTP6_INSTANCE {\r | |
| 67 | UINT32 Signature;\r | |
| 68 | EFI_HANDLE Handle;\r | |
| 69 | LIST_ENTRY Link;\r | |
| 70 | EFI_MTFTP6_PROTOCOL Mtftp6;\r | |
| 71 | MTFTP6_SERVICE *Service;\r | |
| 72 | EFI_MTFTP6_CONFIG_DATA *Config;\r | |
| 73 | \r | |
| 74 | EFI_MTFTP6_TOKEN *Token;\r | |
| 75 | MTFTP6_EXT_OPTION_INFO ExtInfo;\r | |
| 76 | \r | |
| 77 | UINT16 BlkSize;\r | |
| 78 | UINT16 LastBlk;\r | |
| 79 | LIST_ENTRY BlkList;\r | |
| 80 | \r | |
| f3427f12 JW |
81 | UINT16 Operation;\r |
| 82 | \r | |
| 83 | UINT16 WindowSize;\r | |
| 84 | \r | |
| 85 | //\r | |
| 2f6693c2 | 86 | // Record the total received and saved block number.\r |
| f3427f12 JW |
87 | //\r |
| 88 | UINT64 TotalBlock;\r | |
| c41da217 | 89 | \r |
| 2f6693c2 JW |
90 | //\r |
| 91 | // Record the acked block number.\r | |
| 92 | //\r | |
| f3427f12 JW |
93 | UINT64 AckedBlock;\r |
| 94 | \r | |
| a3bcde70 HT |
95 | EFI_IPv6_ADDRESS ServerIp;\r |
| 96 | UINT16 ServerCmdPort;\r | |
| 97 | UINT16 ServerDataPort;\r | |
| 98 | UDP_IO *UdpIo;\r | |
| 99 | \r | |
| 100 | EFI_IPv6_ADDRESS McastIp;\r | |
| 101 | UINT16 McastPort;\r | |
| 102 | UDP_IO *McastUdpIo;\r | |
| 103 | \r | |
| 104 | NET_BUF *LastPacket;\r | |
| 105 | UINT32 CurRetry;\r | |
| 106 | UINT32 MaxRetry;\r | |
| 107 | UINT32 PacketToLive;\r | |
| 108 | UINT32 Timeout;\r | |
| 109 | \r | |
| 110 | EFI_TPL OldTpl;\r | |
| 111 | BOOLEAN IsTransmitted;\r | |
| 112 | BOOLEAN IsMaster;\r | |
| 75dce340 | 113 | BOOLEAN InDestroy;\r |
| a3bcde70 HT |
114 | };\r |
| 115 | \r | |
| 116 | //\r | |
| 117 | // Control block for MTFTP6 service, it's per Nic handle.\r | |
| 118 | //\r | |
| 119 | struct _MTFTP6_SERVICE {\r | |
| 120 | UINT32 Signature;\r | |
| 121 | EFI_SERVICE_BINDING_PROTOCOL ServiceBinding;\r | |
| 122 | EFI_HANDLE Controller;\r | |
| 123 | EFI_HANDLE Image;\r | |
| 124 | \r | |
| 125 | UINT16 ChildrenNum;\r | |
| 126 | LIST_ENTRY Children;\r | |
| 127 | //\r | |
| 128 | // It is used to be as internal calculagraph for all instances.\r | |
| 129 | //\r | |
| 130 | EFI_EVENT Timer;\r | |
| 131 | //\r | |
| 132 | // It is used to maintain the parent-child relationship between\r | |
| 133 | // mtftp driver and udp driver.\r | |
| 134 | //\r | |
| 135 | UDP_IO *DummyUdpIo;\r | |
| a3bcde70 HT |
136 | };\r |
| 137 | \r | |
| 216f7970 | 138 | typedef struct {\r |
| 139 | EFI_SERVICE_BINDING_PROTOCOL *ServiceBinding;\r | |
| 140 | UINTN NumberOfChildren;\r | |
| 141 | EFI_HANDLE *ChildHandleBuffer;\r | |
| 142 | } MTFTP6_DESTROY_CHILD_IN_HANDLE_BUF_CONTEXT;\r | |
| 143 | \r | |
| a3bcde70 HT |
144 | /**\r |
| 145 | Returns the current operating mode data for the MTFTP6 instance.\r | |
| 146 | \r | |
| 147 | The GetModeData() function returns the current operating mode and\r | |
| 148 | cached data packet for the MTFTP6 instance.\r | |
| 149 | \r | |
| 150 | @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL instance.\r | |
| 151 | @param[out] ModeData The buffer in which the EFI MTFTPv6 Protocol driver mode\r | |
| 152 | data is returned.\r | |
| 153 | \r | |
| 154 | @retval EFI_SUCCESS The configuration data was returned successfully.\r | |
| 155 | @retval EFI_OUT_OF_RESOURCES The required mode data could not be allocated.\r | |
| 156 | @retval EFI_INVALID_PARAMETER This is NULL, or ModeData is NULL.\r | |
| 157 | \r | |
| 158 | **/\r | |
| 159 | EFI_STATUS\r | |
| 160 | EFIAPI\r | |
| 161 | EfiMtftp6GetModeData (\r | |
| 162 | IN EFI_MTFTP6_PROTOCOL *This,\r | |
| 163 | OUT EFI_MTFTP6_MODE_DATA *ModeData\r | |
| 164 | );\r | |
| 165 | \r | |
| 166 | /**\r | |
| 167 | Initializes, changes, or resets the default operational setting for\r | |
| 168 | this EFI MTFTPv6 Protocol driver instance.\r | |
| 169 | \r | |
| 170 | The Configure() function is used to set and change the configuration\r | |
| 171 | data for this EFI MTFTPv6 Protocol driver instance. The configuration\r | |
| 172 | data can be reset to startup defaults by calling Configure() with\r | |
| 173 | MtftpConfigData set to NULL. Whenever the instance is reset, any\r | |
| 174 | pending operation is aborted. By changing the EFI MTFTPv6 Protocol\r | |
| 175 | driver instance configuration data, the client can connect to\r | |
| 176 | different MTFTPv6 servers. The configuration parameters in\r | |
| 177 | MtftpConfigData are used as the default parameters in later MTFTPv6\r | |
| 178 | operations and can be overridden in later operations.\r | |
| 179 | \r | |
| 180 | @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL instance.\r | |
| 181 | @param[in] MtftpConfigData Pointer to the configuration data structure.\r | |
| 182 | \r | |
| 183 | @retval EFI_SUCCESS The EFI MTFTPv6 Protocol instance was configured successfully.\r | |
| 184 | @retval EFI_INVALID_PARAMETER One or more following conditions are TRUE:\r | |
| 185 | - This is NULL.\r | |
| 186 | - MtftpConfigData.StationIp is neither zero nor one\r | |
| 187 | of the configured IP addresses in the underlying IPv6 driver.\r | |
| 188 | - MtftpCofigData.ServerIp is not a valid IPv6 unicast address.\r | |
| 189 | Note: It does not match the UEFI 2.3 Specification.\r | |
| 190 | @retval EFI_ACCESS_DENIED - The configuration could not be changed at this time because there\r | |
| 191 | is some MTFTP background operation in progress.\r | |
| 192 | - MtftpCofigData.LocalPort is already in use.\r | |
| 193 | Note: It does not match the UEFI 2.3 Specification.\r | |
| 194 | @retval EFI_NO_MAPPING The underlying IPv6 driver was responsible for choosing a source\r | |
| 195 | address for this instance, but no source address was available for use.\r | |
| 196 | @retval EFI_OUT_OF_RESOURCES The EFI MTFTPv6 Protocol driver instance data could not be\r | |
| 197 | allocated.\r | |
| 198 | Note: It is not defined in the UEFI 2.3 Specification.\r | |
| 199 | @retval EFI_DEVICE_ERROR An unexpected system or network error occurred. The EFI\r | |
| 200 | MTFTPv6 Protocol driver instance is not configured.\r | |
| 201 | Note: It is not defined in the UEFI 2.3 Specification.\r | |
| 202 | \r | |
| 203 | **/\r | |
| 204 | EFI_STATUS\r | |
| 205 | EFIAPI\r | |
| 206 | EfiMtftp6Configure (\r | |
| 207 | IN EFI_MTFTP6_PROTOCOL *This,\r | |
| 208 | IN EFI_MTFTP6_CONFIG_DATA *MtftpConfigData OPTIONAL\r | |
| 209 | );\r | |
| 210 | \r | |
| 211 | /**\r | |
| 212 | Get the information of the download from the server.\r | |
| 213 | \r | |
| 214 | The GetInfo() function assembles an MTFTPv6 request packet\r | |
| 215 | with options, sends it to the MTFTPv6 server, and may return\r | |
| 216 | an MTFTPv6 OACK, MTFTPv6 ERROR, or ICMP ERROR packet. Retries\r | |
| 217 | occur only if no response packets are received from the MTFTPv6\r | |
| 218 | server before the timeout expires.\r | |
| 219 | \r | |
| 220 | @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL instance.\r | |
| 221 | @param[in] OverrideData Data that is used to override the existing parameters. If NULL, the\r | |
| 222 | default parameters that were set in the EFI_MTFTP6_PROTOCOL.Configure()\r | |
| 223 | function are used.\r | |
| 4f077902 SZ |
224 | @param[in] Filename Pointer to null-terminated ASCII file name string.\r |
| 225 | @param[in] ModeStr Pointer to null-terminated ASCII mode string. If NULL, octet will be used\r | |
| a3bcde70 HT |
226 | @param[in] OptionCount Number of option/value string pairs in OptionList.\r |
| 227 | @param[in] OptionList Pointer to array of option/value string pairs. Ignored if\r | |
| 228 | OptionCount is zero.\r | |
| 229 | @param[out] PacketLength The number of bytes in the returned packet.\r | |
| 230 | @param[out] Packet The pointer to the received packet. This buffer must be freed by\r | |
| 231 | the caller.\r | |
| 232 | \r | |
| 233 | @retval EFI_SUCCESS An MTFTPv6 OACK packet was received and is in the Packet.\r | |
| 234 | Note: It does not match the UEFI 2.3 Specification.\r | |
| 235 | @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:\r | |
| 236 | - This is NULL.\r | |
| 237 | - Filename is NULL.\r | |
| 238 | - OptionCount is not zero and OptionList is NULL.\r | |
| 239 | - One or more options in OptionList have wrong format.\r | |
| 240 | - PacketLength is NULL.\r | |
| 241 | - OverrideData.ServerIp is not a valid unicast IPv6 address.\r | |
| 242 | @retval EFI_UNSUPPORTED One or more options in the OptionList are unsupported by\r | |
| 243 | this implementation.\r | |
| 244 | @retval EFI_NOT_STARTED The EFI MTFTPv6 Protocol driver has not been started.\r | |
| 245 | @retval EFI_NO_MAPPING The underlying IPv6 driver was responsible for choosing a source\r | |
| 246 | address for this instance, but no source address was available for use.\r | |
| 247 | @retval EFI_ACCESS_DENIED The previous operation has not completed yet.\r | |
| 248 | @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated.\r | |
| 249 | @retval EFI_TFTP_ERROR An MTFTPv6 ERROR packet was received and is in the Packet.\r | |
| 250 | @retval EFI_NETWORK_UNREACHABLE An ICMP network unreachable error packet was received, and the Packet is set to NULL.\r | |
| 251 | Note: It is not defined in the UEFI 2.3 Specification.\r | |
| 252 | @retval EFI_HOST_UNREACHABLE An ICMP host unreachable error packet was received, and the Packet is set to NULL.\r | |
| 253 | Note: It is not defined in the UEFI 2.3 Specification.\r | |
| 254 | @retval EFI_PROTOCOL_UNREACHABLE An ICMP protocol unreachable error packet was received, and the Packet is set to NULL.\r | |
| 255 | Note: It is not defined in the UEFI 2.3 Specification.\r | |
| 256 | @retval EFI_PORT_UNREACHABLE An ICMP port unreachable error packet was received, and the Packet is set to NULL.\r | |
| 257 | @retval EFI_ICMP_ERROR Some other ICMP ERROR packet was received, and the Packet is set to NULL.\r | |
| 258 | Note: It does not match the UEFI 2.3 Specification.\r | |
| 259 | @retval EFI_PROTOCOL_ERROR An unexpected MTFTPv6 packet was received and is in the Packet.\r | |
| 260 | @retval EFI_TIMEOUT No responses were received from the MTFTPv6 server.\r | |
| 261 | @retval EFI_DEVICE_ERROR An unexpected network error or system error occurred.\r | |
| 262 | \r | |
| 263 | **/\r | |
| 264 | EFI_STATUS\r | |
| 265 | EFIAPI\r | |
| 266 | EfiMtftp6GetInfo (\r | |
| 267 | IN EFI_MTFTP6_PROTOCOL *This,\r | |
| 268 | IN EFI_MTFTP6_OVERRIDE_DATA *OverrideData OPTIONAL,\r | |
| 269 | IN UINT8 *Filename,\r | |
| 270 | IN UINT8 *ModeStr OPTIONAL,\r | |
| 271 | IN UINT8 OptionCount,\r | |
| 272 | IN EFI_MTFTP6_OPTION *OptionList OPTIONAL,\r | |
| 273 | OUT UINT32 *PacketLength,\r | |
| 274 | OUT EFI_MTFTP6_PACKET **Packet OPTIONAL\r | |
| 275 | );\r | |
| 276 | \r | |
| 277 | /**\r | |
| 278 | Parse the options in an MTFTPv6 OACK packet.\r | |
| 279 | \r | |
| 280 | The ParseOptions() function parses the option fields in an MTFTPv6 OACK\r | |
| 281 | packet and returns the number of options that were found, and optionally,\r | |
| 282 | a list of pointers to the options in the packet. If one or more of the\r | |
| 283 | option fields are not valid, then EFI_PROTOCOL_ERROR is returned and\r | |
| 284 | *OptionCount and *OptionList stop at the last valid option.\r | |
| 285 | \r | |
| 286 | @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL instance.\r | |
| 287 | @param[in] PacketLen Length of the OACK packet to be parsed.\r | |
| 288 | @param[in] Packet Pointer to the OACK packet to be parsed.\r | |
| 289 | @param[out] OptionCount Pointer to the number of options in the following OptionList.\r | |
| 290 | @param[out] OptionList Pointer to EFI_MTFTP6_OPTION storage. Each pointer in the\r | |
| 291 | OptionList points to the corresponding MTFTP option buffer\r | |
| 292 | in the Packet. Call the EFI Boot Service FreePool() to\r | |
| 293 | release the OptionList if the options in this OptionList\r | |
| 294 | are not needed any more.\r | |
| 295 | \r | |
| 296 | @retval EFI_SUCCESS The OACK packet was valid and the OptionCount, and\r | |
| 297 | OptionList parameters have been updated.\r | |
| 298 | @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:\r | |
| 299 | - PacketLen is 0.\r | |
| 300 | - Packet is NULL or Packet is not a valid MTFTPv6 packet.\r | |
| 301 | - OptionCount is NULL.\r | |
| 302 | @retval EFI_NOT_FOUND No options were found in the OACK packet.\r | |
| 303 | @retval EFI_OUT_OF_RESOURCES Storage for the OptionList array can not be allocated.\r | |
| 304 | @retval EFI_PROTOCOL_ERROR One or more of the option fields is invalid.\r | |
| 305 | \r | |
| 306 | **/\r | |
| 307 | EFI_STATUS\r | |
| 308 | EFIAPI\r | |
| 309 | EfiMtftp6ParseOptions (\r | |
| 310 | IN EFI_MTFTP6_PROTOCOL *This,\r | |
| 311 | IN UINT32 PacketLen,\r | |
| 312 | IN EFI_MTFTP6_PACKET *Packet,\r | |
| 313 | OUT UINT32 *OptionCount,\r | |
| 314 | OUT EFI_MTFTP6_OPTION **OptionList OPTIONAL\r | |
| 315 | );\r | |
| 316 | \r | |
| 317 | /**\r | |
| 318 | Download a file from an MTFTPv6 server.\r | |
| 319 | \r | |
| 320 | The ReadFile() function is used to initialize and start an MTFTPv6 download\r | |
| 321 | process and optionally wait for completion. When the download operation\r | |
| 322 | completes, whether successfully or not, the Token.Status field is updated\r | |
| 323 | by the EFI MTFTPv6 Protocol driver, and then Token.Event is signaled if it\r | |
| 324 | is not NULL.\r | |
| 325 | Data can be downloaded from the MTFTPv6 server into either of the following\r | |
| 326 | locations:\r | |
| 327 | - A fixed buffer that is pointed to by Token.Buffer.\r | |
| 328 | - A download service function that is pointed to by Token.CheckPacket.\r | |
| 329 | If both Token.Buffer and Token.CheckPacket are used, then Token.CheckPacket\r | |
| 330 | will be called first. If the call is successful, the packet will be stored\r | |
| 331 | in Token.Buffer.\r | |
| 332 | \r | |
| 333 | @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL instance.\r | |
| 334 | @param[in] Token Pointer to the token structure to provide the parameters that are\r | |
| 335 | used in this operation.\r | |
| 336 | \r | |
| 337 | @retval EFI_SUCCESS The data file has been transferred successfully.\r | |
| 338 | @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated.\r | |
| 339 | @retval EFI_BUFFER_TOO_SMALL BufferSize is not zero but not large enough to hold the\r | |
| 340 | downloaded data in downloading process.\r | |
| 341 | Note: It does not match the UEFI 2.3 Specification.\r | |
| 342 | @retval EFI_ABORTED Current operation is aborted by user.\r | |
| 343 | @retval EFI_NETWORK_UNREACHABLE An ICMP network unreachable error packet was received.\r | |
| 344 | Note: It is not defined in the UEFI 2.3 Specification.\r | |
| 345 | @retval EFI_HOST_UNREACHABLE An ICMP host unreachable error packet was received.\r | |
| 346 | Note: It is not defined in the UEFI 2.3 Specification.\r | |
| 347 | @retval EFI_PROTOCOL_UNREACHABLE An ICMP protocol unreachable error packet was received.\r | |
| 348 | Note: It is not defined in the UEFI 2.3 Specification.\r | |
| 349 | @retval EFI_PORT_UNREACHABLE An ICMP port unreachable error packet was received.\r | |
| 350 | Note: It is not defined in the UEFI 2.3 Specification.\r | |
| 351 | @retval EFI_ICMP_ERROR An ICMP ERROR packet was received.\r | |
| 352 | @retval EFI_TIMEOUT No responses were received from the MTFTPv6 server.\r | |
| 353 | @retval EFI_TFTP_ERROR An MTFTPv6 ERROR packet was received.\r | |
| 354 | @retval EFI_DEVICE_ERROR An unexpected network error or system error occurred.\r | |
| 355 | \r | |
| 356 | **/\r | |
| 357 | EFI_STATUS\r | |
| 358 | EFIAPI\r | |
| 359 | EfiMtftp6ReadFile (\r | |
| 360 | IN EFI_MTFTP6_PROTOCOL *This,\r | |
| 361 | IN EFI_MTFTP6_TOKEN *Token\r | |
| 362 | );\r | |
| 363 | \r | |
| 364 | /**\r | |
| 365 | Send a file to an MTFTPv6 server.\r | |
| 366 | \r | |
| 367 | The WriteFile() function is used to initialize an uploading operation\r | |
| 368 | with the given option list, and optionally, wait for completion. If one\r | |
| 369 | or more of the options is not supported by the server, the unsupported\r | |
| 370 | options are ignored and a standard TFTP process starts instead. When\r | |
| 371 | the upload process completes, whether successfully or not, Token.Event\r | |
| 372 | is signaled, and the EFI MTFTPv6 Protocol driver updates Token.Status.\r | |
| 373 | The caller can supply the data to be uploaded in the following two modes:\r | |
| 374 | - Through the user-provided buffer.\r | |
| 375 | - Through a callback function.\r | |
| 376 | With the user-provided buffer, the Token.BufferSize field indicates\r | |
| 377 | the length of the buffer, and the driver will upload the data in the\r | |
| 378 | buffer. With an EFI_MTFTP6_PACKET_NEEDED callback function, the driver\r | |
| 379 | will call this callback function to get more data from the user to upload.\r | |
| 380 | \r | |
| 381 | @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL instance.\r | |
| 382 | @param[in] Token Pointer to the token structure to provide the parameters that are\r | |
| 383 | used in this operation.\r | |
| 384 | \r | |
| 385 | @retval EFI_SUCCESS The upload session has started.\r | |
| 386 | @retval EFI_UNSUPPORTED The operation is not supported by this implementation.\r | |
| 387 | @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:\r | |
| 388 | - This is NULL.\r | |
| 389 | - Token is NULL.\r | |
| 390 | - Token.Filename is NULL.\r | |
| 391 | - Token.OptionCount is not zero and Token.OptionList is NULL.\r | |
| 392 | - One or more options in Token.OptionList have wrong format.\r | |
| 393 | - Token.Buffer and Token.PacketNeeded are both NULL.\r | |
| 394 | - Token.OverrideData.ServerIp is not valid unicast IPv6 addresses.\r | |
| 395 | @retval EFI_UNSUPPORTED One or more options in the Token.OptionList are not\r | |
| 396 | supported by this implementation.\r | |
| 397 | @retval EFI_NOT_STARTED The EFI MTFTPv6 Protocol driver has not been started.\r | |
| 398 | @retval EFI_NO_MAPPING The underlying IPv6 driver was responsible for choosing a source\r | |
| 399 | address for this instance, but no source address was available for use.\r | |
| 400 | @retval EFI_ALREADY_STARTED This Token is already being used in another MTFTPv6 session.\r | |
| 401 | @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated.\r | |
| 402 | @retval EFI_ACCESS_DENIED The previous operation has not completed yet.\r | |
| 403 | @retval EFI_DEVICE_ERROR An unexpected network error or system error occurred.\r | |
| 404 | \r | |
| 405 | **/\r | |
| 406 | EFI_STATUS\r | |
| 407 | EFIAPI\r | |
| 408 | EfiMtftp6WriteFile (\r | |
| 409 | IN EFI_MTFTP6_PROTOCOL *This,\r | |
| 410 | IN EFI_MTFTP6_TOKEN *Token\r | |
| 411 | );\r | |
| 412 | \r | |
| 413 | /**\r | |
| 414 | Download a data file directory from an MTFTPv6 server.\r | |
| 415 | \r | |
| 416 | The ReadDirectory() function is used to return a list of files on the\r | |
| 417 | MTFTPv6 server that are logically (or operationally) related to\r | |
| 418 | Token.Filename. The directory request packet that is sent to the server\r | |
| 419 | is built with the option list that was provided by caller, if present.\r | |
| 420 | The file information that the server returns is put into either of\r | |
| 421 | the following locations:\r | |
| 422 | - A fixed buffer that is pointed to by Token.Buffer.\r | |
| 423 | - A download service function that is pointed to by Token.CheckPacket.\r | |
| 424 | If both Token.Buffer and Token.CheckPacket are used, then Token.CheckPacket\r | |
| 425 | will be called first. If the call is successful, the packet will be stored\r | |
| 426 | in Token.Buffer.\r | |
| 427 | \r | |
| 428 | @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL instance.\r | |
| 429 | @param[in] Token Pointer to the token structure to provide the parameters that are\r | |
| 430 | used in this operation.\r | |
| 431 | \r | |
| 432 | @retval EFI_SUCCESS The MTFTPv6 related file "directory" has been downloaded.\r | |
| 433 | @retval EFI_UNSUPPORTED The EFI MTFTPv6 Protocol driver does not support this function.\r | |
| 434 | @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:\r | |
| 435 | - This is NULL.\r | |
| 436 | - Token is NULL.\r | |
| 437 | - Token.Filename is NULL.\r | |
| 438 | - Token.OptionCount is not zero and Token.OptionList is NULL.\r | |
| 439 | - One or more options in Token.OptionList have wrong format.\r | |
| 440 | - Token.Buffer and Token.CheckPacket are both NULL.\r | |
| 441 | - Token.OverrideData.ServerIp is not valid unicast IPv6 addresses.\r | |
| 442 | @retval EFI_UNSUPPORTED One or more options in the Token.OptionList are not\r | |
| 443 | supported by this implementation.\r | |
| 444 | @retval EFI_NOT_STARTED The EFI MTFTPv6 Protocol driver has not been started.\r | |
| 445 | @retval EFI_NO_MAPPING The underlying IPv6 driver was responsible for choosing a source\r | |
| 446 | address for this instance, but no source address was available for use.\r | |
| 447 | @retval EFI_ALREADY_STARTED This Token is already being used in another MTFTPv6 session.\r | |
| 448 | @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated.\r | |
| 449 | @retval EFI_ACCESS_DENIED The previous operation has not completed yet.\r | |
| 450 | @retval EFI_DEVICE_ERROR An unexpected network error or system error occurred.\r | |
| 451 | \r | |
| 452 | **/\r | |
| 453 | EFI_STATUS\r | |
| 454 | EFIAPI\r | |
| 455 | EfiMtftp6ReadDirectory (\r | |
| 456 | IN EFI_MTFTP6_PROTOCOL *This,\r | |
| 457 | IN EFI_MTFTP6_TOKEN *Token\r | |
| 458 | );\r | |
| 459 | \r | |
| 460 | /**\r | |
| 461 | Polls for incoming data packets and processes outgoing data packets.\r | |
| 462 | \r | |
| 463 | The Poll() function can be used by network drivers and applications\r | |
| 464 | to increase the rate that data packets are moved between the\r | |
| 465 | communications device and the transmit and receive queues.In some\r | |
| 466 | systems, the periodic timer event in the managed network driver may\r | |
| 467 | not poll the underlying communications device fast enough to transmit\r | |
| 468 | and/or receive all data packets without missing incoming packets or\r | |
| 469 | dropping outgoing packets. Drivers and applications that are\r | |
| 470 | experiencing packet loss should try calling the Poll() function\r | |
| 471 | more often.\r | |
| 472 | \r | |
| 473 | @param[in] This The MTFTP6 protocol instance.\r | |
| 474 | \r | |
| 475 | \r | |
| 476 | @retval EFI_SUCCESS Incoming or outgoing data was processed.\r | |
| 477 | @retval EFI_NOT_STARTED This EFI MTFTPv6 Protocol instance has not been started.\r | |
| 478 | @retval EFI_INVALID_PARAMETER This is NULL.\r | |
| 479 | @retval EFI_DEVICE_ERROR An unexpected system or network error occurred.\r | |
| 480 | @retval EFI_TIMEOUT Data was dropped out of the transmit and/or receive queue.\r | |
| 481 | Consider increasing the polling rate.\r | |
| 482 | \r | |
| 483 | **/\r | |
| 484 | EFI_STATUS\r | |
| 485 | EFIAPI\r | |
| 486 | EfiMtftp6Poll (\r | |
| 487 | IN EFI_MTFTP6_PROTOCOL *This\r | |
| 488 | );\r | |
| 489 | \r | |
| 490 | #endif\r |