[mirror_edk2.git] / NetworkPkg / HttpBootDxe / HttpBootSupport.h

/** @file\r
  Support functions declaration for UEFI HTTP boot driver.\r
\r
Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>\r
This program and the accompanying materials are licensed and made available under \r
the terms and conditions of the BSD License that accompanies this distribution.  \r
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
**/\r
\r
#ifndef __EFI_HTTP_BOOT_SUPPORT_H__\r
#define __EFI_HTTP_BOOT_SUPPORT_H__\r
\r
/**\r
  Get the Nic handle using any child handle in the IPv4 stack.\r
\r
  @param[in]  ControllerHandle    Pointer to child handle over IPv4.\r
\r
  @return NicHandle               The pointer to the Nic handle.\r
  @return NULL                    Can't find the Nic handle.\r
\r
**/\r
EFI_HANDLE\r
HttpBootGetNicByIp4Children (\r
  IN EFI_HANDLE                 ControllerHandle\r
  );\r
\r
/**\r
  Get the Nic handle using any child handle in the IPv6 stack.\r
\r
  @param[in]  ControllerHandle    Pointer to child handle over IPv6.\r
\r
  @return NicHandle               The pointer to the Nic handle.\r
  @return NULL                    Can't find the Nic handle.\r
\r
**/\r
EFI_HANDLE\r
HttpBootGetNicByIp6Children (\r
  IN EFI_HANDLE                 ControllerHandle\r
  );\r
\r
/**\r
  This function is to convert UINTN to ASCII string with the required formatting.\r
\r
  @param[in]  Number         Numeric value to be converted.\r
  @param[in]  Buffer         The pointer to the buffer for ASCII string.\r
  @param[in]  Length         The length of the required format.\r
\r
**/\r
VOID\r
HttpBootUintnToAscDecWithFormat (\r
  IN UINTN                       Number,\r
  IN UINT8                       *Buffer,\r
  IN INTN                        Length\r
  );\r
\r
\r
/**\r
  This function is to display the IPv4 address.\r
\r
  @param[in]  Ip        The pointer to the IPv4 address.\r
\r
**/\r
VOID\r
HttpBootShowIp4Addr (\r
  IN EFI_IPv4_ADDRESS   *Ip\r
  );\r
\r
/**\r
  This function is to display the IPv6 address.\r
\r
  @param[in]  Ip        The pointer to the IPv6 address.\r
\r
**/\r
VOID\r
HttpBootShowIp6Addr (\r
  IN EFI_IPv6_ADDRESS   *Ip\r
  );\r
\r
/**\r
  This function is to display the HTTP error status.\r
\r
  @param[in]      StatusCode      The status code value in HTTP message.\r
\r
**/\r
VOID\r
HttpBootPrintErrorMessage (\r
  EFI_HTTP_STATUS_CODE            StatusCode\r
  );\r
\r
//\r
// A wrapper structure to hold the HTTP headers.\r
//\r
typedef struct {\r
  UINTN                       MaxHeaderCount;\r
  UINTN                       HeaderCount;\r
  EFI_HTTP_HEADER             *Headers;\r
} HTTP_IO_HEADER;\r
\r
/**\r
  Create a HTTP_IO_HEADER to hold the HTTP header items.\r
\r
  @param[in]  MaxHeaderCount         The maximun number of HTTP header in this holder.\r
\r
  @return    A pointer of the HTTP header holder or NULL if failed.\r
  \r
**/\r
HTTP_IO_HEADER *\r
HttpBootCreateHeader (\r
  IN  UINTN                MaxHeaderCount\r
  );\r
\r
/**\r
  Destroy the HTTP_IO_HEADER and release the resouces. \r
\r
  @param[in]  HttpIoHeader       Point to the HTTP header holder to be destroyed.\r
\r
**/\r
VOID\r
HttpBootFreeHeader (\r
  IN  HTTP_IO_HEADER       *HttpIoHeader\r
  );\r
\r
/**\r
  Set or update a HTTP header with the field name and corresponding value.\r
\r
  @param[in]  HttpIoHeader       Point to the HTTP header holder.\r
  @param[in]  FieldName          Null terminated string which describes a field name. \r
  @param[in]  FieldValue         Null terminated string which describes the corresponding field value.\r
\r
  @retval  EFI_SUCCESS           The HTTP header has been set or updated.\r
  @retval  EFI_INVALID_PARAMETER Any input parameter is invalid.\r
  @retval  EFI_OUT_OF_RESOURCES  Insufficient resource to complete the operation.\r
  @retval  Other                 Unexpected error happened.\r
  \r
**/\r
EFI_STATUS\r
HttpBootSetHeader (\r
  IN  HTTP_IO_HEADER       *HttpIoHeader,\r
  IN  CHAR8                *FieldName,\r
  IN  CHAR8                *FieldValue\r
  );\r
\r
//\r
// HTTP_IO configuration data for IPv4\r
//\r
typedef struct {\r
  EFI_HTTP_VERSION          HttpVersion;\r
  UINT32                    RequestTimeOut;  // In milliseconds.\r
  UINT32                    ResponseTimeOut; // In milliseconds.\r
  BOOLEAN                   UseDefaultAddress;\r
  EFI_IPv4_ADDRESS          LocalIp;\r
  EFI_IPv4_ADDRESS          SubnetMask;\r
  UINT16                    LocalPort;\r
} HTTP4_IO_CONFIG_DATA;\r
\r
//\r
// HTTP_IO configuration data for IPv6\r
//\r
typedef struct {\r
  EFI_HTTP_VERSION          HttpVersion;\r
  UINT32                    RequestTimeOut;  // In milliseconds.\r
  BOOLEAN                   UseDefaultAddress;\r
  EFI_IPv6_ADDRESS          LocalIp;\r
  UINT16                    LocalPort;\r
} HTTP6_IO_CONFIG_DATA;\r
\r
\r
//\r
// HTTP_IO configuration\r
//\r
typedef union {\r
  HTTP4_IO_CONFIG_DATA       Config4;\r
  HTTP6_IO_CONFIG_DATA       Config6;\r
} HTTP_IO_CONFIG_DATA;\r
\r
//\r
// HTTP_IO wrapper of the EFI HTTP service.\r
//\r
typedef struct {\r
  UINT8                     IpVersion;\r
  EFI_HANDLE                Image;\r
  EFI_HANDLE                Controller;\r
  EFI_HANDLE                Handle;\r
  \r
  EFI_HTTP_PROTOCOL         *Http;\r
\r
  EFI_HTTP_TOKEN            ReqToken;\r
  EFI_HTTP_MESSAGE          ReqMessage;\r
  EFI_HTTP_TOKEN            RspToken;\r
  EFI_HTTP_MESSAGE          RspMessage;\r
\r
  BOOLEAN                   IsTxDone;\r
  BOOLEAN                   IsRxDone;\r
} HTTP_IO;\r
\r
//\r
// A wrapper structure to hold the received HTTP response data.\r
//\r
typedef struct {\r
  EFI_HTTP_RESPONSE_DATA      Response;\r
  UINTN                       HeaderCount;\r
  EFI_HTTP_HEADER             *Headers;\r
  UINTN                       BodyLength;\r
  CHAR8                       *Body;\r
  EFI_STATUS                  Status;\r
} HTTP_IO_RESPONSE_DATA;\r
\r
/**\r
  Retrieve the host address using the EFI_DNS6_PROTOCOL.\r
\r
  @param[in]  Private             The pointer to the driver's private data.\r
  @param[in]  HostName            Pointer to buffer containing hostname.\r
  @param[out] IpAddress           On output, pointer to buffer containing IPv6 address.\r
\r
  @retval EFI_SUCCESS             Operation succeeded.\r
  @retval EFI_DEVICE_ERROR        An unexpected network error occurred.\r
  @retval Others                  Other errors as indicated.  \r
**/\r
EFI_STATUS\r
HttpBootDns (\r
  IN     HTTP_BOOT_PRIVATE_DATA   *Private,\r
  IN     CHAR16                   *HostName,\r
     OUT EFI_IPv6_ADDRESS         *IpAddress \r
  );\r
\r
/**\r
  Notify the callback function when an event is triggered.\r
\r
  @param[in]  Event           The triggered event.\r
  @param[in]  Context         The opaque parameter to the function.\r
\r
**/\r
VOID\r
EFIAPI\r
HttpBootCommonNotify (\r
  IN EFI_EVENT           Event,\r
  IN VOID                *Context\r
  );\r
\r
/**\r
  Create a HTTP_IO to access the HTTP service. It will create and configure\r
  a HTTP child handle.\r
\r
  @param[in]  Image          The handle of the driver image.\r
  @param[in]  Controller     The handle of the controller.\r
  @param[in]  IpVersion      IP_VERSION_4 or IP_VERSION_6.\r
  @param[in]  ConfigData     The HTTP_IO configuration data.\r
  @param[out] HttpIo         The HTTP_IO.\r
  \r
  @retval EFI_SUCCESS            The HTTP_IO is created and configured.\r
  @retval EFI_INVALID_PARAMETER  One or more parameters are invalid.\r
  @retval EFI_UNSUPPORTED        One or more of the control options are not\r
                                 supported in the implementation.\r
  @retval EFI_OUT_OF_RESOURCES   Failed to allocate memory.\r
  @retval Others                 Failed to create the HTTP_IO or configure it.\r
\r
**/\r
EFI_STATUS\r
HttpIoCreateIo (\r
  IN EFI_HANDLE             Image,\r
  IN EFI_HANDLE             Controller,\r
  IN UINT8                  IpVersion,\r
  IN HTTP_IO_CONFIG_DATA    *ConfigData,\r
  OUT HTTP_IO               *HttpIo\r
  );\r
\r
/**\r
  Destroy the HTTP_IO and release the resouces. \r
\r
  @param[in]  HttpIo          The HTTP_IO which wraps the HTTP service to be destroyed.\r
\r
**/\r
VOID\r
HttpIoDestroyIo (\r
  IN HTTP_IO                *HttpIo\r
  );\r
\r
/**\r
  Synchronously send a HTTP REQUEST message to the server.\r
  \r
  @param[in]   HttpIo           The HttpIo wrapping the HTTP service.\r
  @param[in]   Request          A pointer to storage such data as URL and HTTP method.\r
  @param[in]   HeaderCount      Number of HTTP header structures in Headers list. \r
  @param[in]   Headers          Array containing list of HTTP headers.\r
  @param[in]   BodyLength       Length in bytes of the HTTP body.\r
  @param[in]   Body             Body associated with the HTTP request. \r
  \r
  @retval EFI_SUCCESS            The HTTP request is trasmitted.\r
  @retval EFI_INVALID_PARAMETER  One or more parameters are invalid.\r
  @retval EFI_OUT_OF_RESOURCES   Failed to allocate memory.\r
  @retval EFI_DEVICE_ERROR       An unexpected network or system error occurred.\r
  @retval Others                 Other errors as indicated.\r
\r
**/\r
EFI_STATUS\r
HttpIoSendRequest (\r
  IN  HTTP_IO                *HttpIo,\r
  IN  EFI_HTTP_REQUEST_DATA  *Request,      OPTIONAL\r
  IN  UINTN                  HeaderCount,\r
  IN  EFI_HTTP_HEADER        *Headers,      OPTIONAL\r
  IN  UINTN                  BodyLength,\r
  IN  VOID                   *Body          OPTIONAL\r
  );\r
\r
/**\r
  Synchronously receive a HTTP RESPONSE message from the server.\r
  \r
  @param[in]   HttpIo           The HttpIo wrapping the HTTP service.\r
  @param[in]   RecvMsgHeader    TRUE to receive a new HTTP response (from message header).\r
                                FALSE to continue receive the previous response message.\r
  @param[out]  ResponseData     Point to a wrapper of the received response data.\r
  \r
  @retval EFI_SUCCESS            The HTTP response is received.\r
  @retval EFI_INVALID_PARAMETER  One or more parameters are invalid.\r
  @retval EFI_OUT_OF_RESOURCES   Failed to allocate memory.\r
  @retval EFI_DEVICE_ERROR       An unexpected network or system error occurred.\r
  @retval Others                 Other errors as indicated.\r
\r
**/\r
EFI_STATUS\r
HttpIoRecvResponse (\r
  IN      HTTP_IO                  *HttpIo,\r
  IN      BOOLEAN                  RecvMsgHeader,\r
     OUT  HTTP_IO_RESPONSE_DATA    *ResponseData\r
  );\r
\r
/**\r
  Get the URI address string from the input device path.\r
\r
  Caller need to free the buffer in the UriAddress pointer.\r
  \r
  @param[in]   FilePath         Pointer to the device path which contains a URI device path node.\r
  @param[in]   UriAddress       The URI address string extract from the device path.\r
  \r
  @retval EFI_SUCCESS            The URI string is returned.\r
  @retval EFI_OUT_OF_RESOURCES   Failed to allocate memory.\r
\r
**/\r
EFI_STATUS\r
HttpBootParseFilePath (\r
  IN     EFI_DEVICE_PATH_PROTOCOL     *FilePath,\r
     OUT CHAR8                        **UriAddress\r
  );\r
\r
#endif\r
Commit	Line	Data
d933e70a JW	1	/** @file\r
	2	Support functions declaration for UEFI HTTP boot driver.\r
	3	\r
072289f4	4	Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>\r
d933e70a JW	5	This program and the accompanying materials are licensed and made available under \r
	6	the terms and conditions of the BSD License that accompanies this distribution. \r
	7	The full text of the license may be found at\r
	8	http://opensource.org/licenses/bsd-license.php. \r
	9	\r
	10	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
	11	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	12	\r
	13	**/\r
	14	\r
	15	#ifndef __EFI_HTTP_BOOT_SUPPORT_H__\r
	16	#define __EFI_HTTP_BOOT_SUPPORT_H__\r
	17	\r
	18	/**\r
	19	Get the Nic handle using any child handle in the IPv4 stack.\r
	20	\r
	21	@param[in] ControllerHandle Pointer to child handle over IPv4.\r
	22	\r
	23	@return NicHandle The pointer to the Nic handle.\r
	24	@return NULL Can't find the Nic handle.\r
	25	\r
	26	**/\r
	27	EFI_HANDLE\r
	28	HttpBootGetNicByIp4Children (\r
	29	IN EFI_HANDLE ControllerHandle\r
	30	);\r
	31	\r
b659408b ZL	32	/**\r
	33	Get the Nic handle using any child handle in the IPv6 stack.\r
	34	\r
	35	@param[in] ControllerHandle Pointer to child handle over IPv6.\r
	36	\r
	37	@return NicHandle The pointer to the Nic handle.\r
	38	@return NULL Can't find the Nic handle.\r
	39	\r
	40	**/\r
	41	EFI_HANDLE\r
	42	HttpBootGetNicByIp6Children (\r
	43	IN EFI_HANDLE ControllerHandle\r
	44	);\r
	45	\r
d933e70a JW	46	/**\r
	47	This function is to convert UINTN to ASCII string with the required formatting.\r
	48	\r
	49	@param[in] Number Numeric value to be converted.\r
	50	@param[in] Buffer The pointer to the buffer for ASCII string.\r
	51	@param[in] Length The length of the required format.\r
	52	\r
	53	**/\r
	54	VOID\r
	55	HttpBootUintnToAscDecWithFormat (\r
	56	IN UINTN Number,\r
	57	IN UINT8 *Buffer,\r
	58	IN INTN Length\r
	59	);\r
	60	\r
	61	\r
	62	/**\r
	63	This function is to display the IPv4 address.\r
	64	\r
	65	@param[in] Ip The pointer to the IPv4 address.\r
	66	\r
	67	**/\r
	68	VOID\r
	69	HttpBootShowIp4Addr (\r
	70	IN EFI_IPv4_ADDRESS *Ip\r
	71	);\r
	72	\r
b659408b ZL	73	/**\r
	74	This function is to display the IPv6 address.\r
	75	\r
	76	@param[in] Ip The pointer to the IPv6 address.\r
	77	\r
	78	**/\r
	79	VOID\r
	80	HttpBootShowIp6Addr (\r
	81	IN EFI_IPv6_ADDRESS *Ip\r
	82	);\r
	83	\r
072289f4 ZL	84	/**\r
	85	This function is to display the HTTP error status.\r
	86	\r
	87	@param[in] StatusCode The status code value in HTTP message.\r
	88	\r
	89	**/\r
	90	VOID\r
	91	HttpBootPrintErrorMessage (\r
	92	EFI_HTTP_STATUS_CODE StatusCode\r
	93	);\r
	94	\r
d933e70a JW	95	//\r
	96	// A wrapper structure to hold the HTTP headers.\r
	97	//\r
	98	typedef struct {\r
	99	UINTN MaxHeaderCount;\r
	100	UINTN HeaderCount;\r
	101	EFI_HTTP_HEADER *Headers;\r
	102	} HTTP_IO_HEADER;\r
	103	\r
	104	/**\r
	105	Create a HTTP_IO_HEADER to hold the HTTP header items.\r
	106	\r
	107	@param[in] MaxHeaderCount The maximun number of HTTP header in this holder.\r
	108	\r
	109	@return A pointer of the HTTP header holder or NULL if failed.\r
	110	\r
	111	**/\r
	112	HTTP_IO_HEADER *\r
	113	HttpBootCreateHeader (\r
	114	IN UINTN MaxHeaderCount\r
	115	);\r
	116	\r
	117	/**\r
	118	Destroy the HTTP_IO_HEADER and release the resouces. \r
	119	\r
	120	@param[in] HttpIoHeader Point to the HTTP header holder to be destroyed.\r
	121	\r
	122	**/\r
	123	VOID\r
	124	HttpBootFreeHeader (\r
	125	IN HTTP_IO_HEADER *HttpIoHeader\r
	126	);\r
	127	\r
	128	/**\r
	129	Set or update a HTTP header with the field name and corresponding value.\r
	130	\r
	131	@param[in] HttpIoHeader Point to the HTTP header holder.\r
	132	@param[in] FieldName Null terminated string which describes a field name. \r
	133	@param[in] FieldValue Null terminated string which describes the corresponding field value.\r
	134	\r
	135	@retval EFI_SUCCESS The HTTP header has been set or updated.\r
	136	@retval EFI_INVALID_PARAMETER Any input parameter is invalid.\r
	137	@retval EFI_OUT_OF_RESOURCES Insufficient resource to complete the operation.\r
	138	@retval Other Unexpected error happened.\r
	139	\r
	140	**/\r
	141	EFI_STATUS\r
	142	HttpBootSetHeader (\r
	143	IN HTTP_IO_HEADER *HttpIoHeader,\r
	144	IN CHAR8 *FieldName,\r
	145	IN CHAR8 *FieldValue\r
	146	);\r
	147	\r
	148	//\r
	149	// HTTP_IO configuration data for IPv4\r
	150	//\r
	151	typedef struct {\r
	152	EFI_HTTP_VERSION HttpVersion;\r
	153	UINT32 RequestTimeOut; // In milliseconds.\r
	154	UINT32 ResponseTimeOut; // In milliseconds.\r
	155	BOOLEAN UseDefaultAddress;\r
	156	EFI_IPv4_ADDRESS LocalIp;\r
	157	EFI_IPv4_ADDRESS SubnetMask;\r
	158	UINT16 LocalPort;\r
159	} HTTP4_IO_CONFIG_DATA;\r
160	\r
b659408b ZL	161	//\r
	162	// HTTP_IO configuration data for IPv6\r
	163	//\r
	164	typedef struct {\r
	165	EFI_HTTP_VERSION HttpVersion;\r
	166	UINT32 RequestTimeOut; // In milliseconds.\r
	167	BOOLEAN UseDefaultAddress;\r
	168	EFI_IPv6_ADDRESS LocalIp;\r
	169	UINT16 LocalPort;\r
	170	} HTTP6_IO_CONFIG_DATA;\r
	171	\r
	172	\r
d933e70a JW	173	//\r
	174	// HTTP_IO configuration\r
	175	//\r
	176	typedef union {\r
	177	HTTP4_IO_CONFIG_DATA Config4;\r
b659408b	178	HTTP6_IO_CONFIG_DATA Config6;\r
d933e70a JW	179	} HTTP_IO_CONFIG_DATA;\r
	180	\r
	181	//\r
ef422fc5	182	// HTTP_IO wrapper of the EFI HTTP service.\r
d933e70a JW	183	//\r
	184	typedef struct {\r
	185	UINT8 IpVersion;\r
	186	EFI_HANDLE Image;\r
	187	EFI_HANDLE Controller;\r
	188	EFI_HANDLE Handle;\r
	189	\r
	190	EFI_HTTP_PROTOCOL *Http;\r
	191	\r
	192	EFI_HTTP_TOKEN ReqToken;\r
	193	EFI_HTTP_MESSAGE ReqMessage;\r
	194	EFI_HTTP_TOKEN RspToken;\r
	195	EFI_HTTP_MESSAGE RspMessage;\r
	196	\r
	197	BOOLEAN IsTxDone;\r
	198	BOOLEAN IsRxDone;\r
	199	} HTTP_IO;\r
	200	\r
	201	//\r
	202	// A wrapper structure to hold the received HTTP response data.\r
	203	//\r
	204	typedef struct {\r
	205	EFI_HTTP_RESPONSE_DATA Response;\r
	206	UINTN HeaderCount;\r
	207	EFI_HTTP_HEADER *Headers;\r
	208	UINTN BodyLength;\r
	209	CHAR8 *Body;\r
072289f4	210	EFI_STATUS Status;\r
ef422fc5	211	} HTTP_IO_RESPONSE_DATA;\r
d933e70a	212	\r
b659408b ZL	213	/**\r
	214	Retrieve the host address using the EFI_DNS6_PROTOCOL.\r
	215	\r
	216	@param[in] Private The pointer to the driver's private data.\r
	217	@param[in] HostName Pointer to buffer containing hostname.\r
	218	@param[out] IpAddress On output, pointer to buffer containing IPv6 address.\r
	219	\r
	220	@retval EFI_SUCCESS Operation succeeded.\r
	221	@retval EFI_DEVICE_ERROR An unexpected network error occurred.\r
	222	@retval Others Other errors as indicated. \r
	223	**/\r
	224	EFI_STATUS\r
	225	HttpBootDns (\r
	226	IN HTTP_BOOT_PRIVATE_DATA *Private,\r
	227	IN CHAR16 *HostName,\r
	228	OUT EFI_IPv6_ADDRESS *IpAddress \r
	229	);\r
	230	\r
	231	/**\r
	232	Notify the callback function when an event is triggered.\r
	233	\r
	234	@param[in] Event The triggered event.\r
	235	@param[in] Context The opaque parameter to the function.\r
	236	\r
	237	**/\r
	238	VOID\r
	239	EFIAPI\r
	240	HttpBootCommonNotify (\r
	241	IN EFI_EVENT Event,\r
	242	IN VOID *Context\r
	243	);\r
	244	\r
d933e70a JW	245	/**\r
	246	Create a HTTP_IO to access the HTTP service. It will create and configure\r
	247	a HTTP child handle.\r
	248	\r
	249	@param[in] Image The handle of the driver image.\r
	250	@param[in] Controller The handle of the controller.\r
	251	@param[in] IpVersion IP_VERSION_4 or IP_VERSION_6.\r
	252	@param[in] ConfigData The HTTP_IO configuration data.\r
	253	@param[out] HttpIo The HTTP_IO.\r
	254	\r
	255	@retval EFI_SUCCESS The HTTP_IO is created and configured.\r
	256	@retval EFI_INVALID_PARAMETER One or more parameters are invalid.\r
	257	@retval EFI_UNSUPPORTED One or more of the control options are not\r
	258	supported in the implementation.\r
	259	@retval EFI_OUT_OF_RESOURCES Failed to allocate memory.\r
	260	@retval Others Failed to create the HTTP_IO or configure it.\r
	261	\r
	262	**/\r
	263	EFI_STATUS\r
	264	HttpIoCreateIo (\r
	265	IN EFI_HANDLE Image,\r
	266	IN EFI_HANDLE Controller,\r
	267	IN UINT8 IpVersion,\r
	268	IN HTTP_IO_CONFIG_DATA *ConfigData,\r
	269	OUT HTTP_IO *HttpIo\r
	270	);\r
	271	\r
	272	/**\r
	273	Destroy the HTTP_IO and release the resouces. \r
	274	\r
	275	@param[in] HttpIo The HTTP_IO which wraps the HTTP service to be destroyed.\r
	276	\r
	277	**/\r
	278	VOID\r
	279	HttpIoDestroyIo (\r
	280	IN HTTP_IO *HttpIo\r
	281	);\r
	282	\r
	283	/**\r
	284	Synchronously send a HTTP REQUEST message to the server.\r
	285	\r
	286	@param[in] HttpIo The HttpIo wrapping the HTTP service.\r
	287	@param[in] Request A pointer to storage such data as URL and HTTP method.\r
	288	@param[in] HeaderCount Number of HTTP header structures in Headers list. \r
	289	@param[in] Headers Array containing list of HTTP headers.\r
	290	@param[in] BodyLength Length in bytes of the HTTP body.\r
	291	@param[in] Body Body associated with the HTTP request. \r
	292	\r
	293	@retval EFI_SUCCESS The HTTP request is trasmitted.\r
	294	@retval EFI_INVALID_PARAMETER One or more parameters are invalid.\r
	295	@retval EFI_OUT_OF_RESOURCES Failed to allocate memory.\r
	296	@retval EFI_DEVICE_ERROR An unexpected network or system error occurred.\r
	297	@retval Others Other errors as indicated.\r
	298	\r
	299	**/\r
	300	EFI_STATUS\r
	301	HttpIoSendRequest (\r
	302	IN HTTP_IO *HttpIo,\r
	303	IN EFI_HTTP_REQUEST_DATA *Request, OPTIONAL\r
	304	IN UINTN HeaderCount,\r
	305	IN EFI_HTTP_HEADER *Headers, OPTIONAL\r
	306	IN UINTN BodyLength,\r
	307	IN VOID *Body OPTIONAL\r
	308	);\r
309	\r
310	/**\r
311	Synchronously receive a HTTP RESPONSE message from the server.\r
312	\r
313	@param[in] HttpIo The HttpIo wrapping the HTTP service.\r
314	@param[in] RecvMsgHeader TRUE to receive a new HTTP response (from message header).\r
315	FALSE to continue receive the previous response message.\r
316	@param[out] ResponseData Point to a wrapper of the received response data.\r
317	\r
ef422fc5	318	@retval EFI_SUCCESS The HTTP response is received.\r
d933e70a JW	319	@retval EFI_INVALID_PARAMETER One or more parameters are invalid.\r
	320	@retval EFI_OUT_OF_RESOURCES Failed to allocate memory.\r
	321	@retval EFI_DEVICE_ERROR An unexpected network or system error occurred.\r
	322	@retval Others Other errors as indicated.\r
	323	\r
	324	**/\r
	325	EFI_STATUS\r
	326	HttpIoRecvResponse (\r
	327	IN HTTP_IO *HttpIo,\r
	328	IN BOOLEAN RecvMsgHeader,\r
ef422fc5	329	OUT HTTP_IO_RESPONSE_DATA *ResponseData\r
d933e70a JW	330	);\r
d933e70a JW	331	\r
fa848a40 FS	332	/**\r
	333	Get the URI address string from the input device path.\r
	334	\r
	335	Caller need to free the buffer in the UriAddress pointer.\r
	336	\r
	337	@param[in] FilePath Pointer to the device path which contains a URI device path node.\r
	338	@param[in] UriAddress The URI address string extract from the device path.\r
	339	\r
	340	@retval EFI_SUCCESS The URI string is returned.\r
	341	@retval EFI_OUT_OF_RESOURCES Failed to allocate memory.\r
	342	\r
	343	**/\r
	344	EFI_STATUS\r
	345	HttpBootParseFilePath (\r
	346	IN EFI_DEVICE_PATH_PROTOCOL *FilePath,\r
	347	OUT CHAR8 **UriAddress\r
	348	);\r
	349	\r
d933e70a	350	#endif\r