NetworkPkg/DxeHttpLib: Migrate HTTP header manipulation APIs

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

/** @file\r
  Support functions declaration for UEFI HTTP boot driver.\r
\r
Copyright (c) 2015 - 2018, Intel Corporation. All rights reserved.<BR>\r
(C) Copyright 2020 Hewlett-Packard Development Company, L.P.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\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
  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
  This function checks the HTTP(S) URI scheme.\r
\r
  @param[in]    Uri              The pointer to the URI string.\r
\r
  @retval EFI_SUCCESS            The URI scheme is valid.\r
  @retval EFI_INVALID_PARAMETER  The URI scheme is not HTTP or HTTPS.\r
  @retval EFI_ACCESS_DENIED      HTTP is disabled and the URI is HTTP.\r
\r
**/\r
EFI_STATUS\r
HttpBootCheckUriScheme (\r
  IN      CHAR8                  *Uri\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[out]  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
/**\r
  This function returns the image type according to server replied HTTP message\r
  and also the image's URI info.\r
\r
  @param[in]    Uri              The pointer to the image's URI string.\r
  @param[in]    UriParser        URI Parse result returned by NetHttpParseUrl().\r
  @param[in]    HeaderCount      Number of HTTP header structures in Headers list.\r
  @param[in]    Headers          Array containing list of HTTP headers.\r
  @param[out]   ImageType        The image type of the downloaded file.\r
\r
  @retval EFI_SUCCESS            The image type is returned in ImageType.\r
  @retval EFI_INVALID_PARAMETER  ImageType, Uri or UriParser is NULL.\r
  @retval EFI_INVALID_PARAMETER  HeaderCount is not zero, and Headers is NULL.\r
  @retval EFI_NOT_FOUND          Failed to identify the image type.\r
  @retval Others                 Unexpected error happened.\r
\r
**/\r
EFI_STATUS\r
HttpBootCheckImageType (\r
  IN      CHAR8                  *Uri,\r
  IN      VOID                   *UriParser,\r
  IN      UINTN                  HeaderCount,\r
  IN      EFI_HTTP_HEADER        *Headers,\r
     OUT  HTTP_BOOT_IMAGE_TYPE   *ImageType\r
  );\r
\r
/**\r
  This function register the RAM disk info to the system.\r
\r
  @param[in]       Private         The pointer to the driver's private data.\r
  @param[in]       BufferSize      The size of Buffer in bytes.\r
  @param[in]       Buffer          The base address of the RAM disk.\r
  @param[in]       ImageType       The image type of the file in Buffer.\r
\r
  @retval EFI_SUCCESS              The RAM disk has been registered.\r
  @retval EFI_NOT_FOUND            No RAM disk protocol instances were found.\r
  @retval EFI_UNSUPPORTED          The ImageType is not supported.\r
  @retval Others                   Unexpected error happened.\r
\r
**/\r
EFI_STATUS\r
HttpBootRegisterRamDisk (\r
  IN  HTTP_BOOT_PRIVATE_DATA       *Private,\r
  IN  UINTN                        BufferSize,\r
  IN  VOID                         *Buffer,\r
  IN  HTTP_BOOT_IMAGE_TYPE         ImageType\r
  );\r
\r
/**\r
  Indicate if the HTTP status code indicates a redirection.\r
\r
  @param[in]  StatusCode      HTTP status code from server.\r
\r
  @return                     TRUE if it's redirection.\r
\r
**/\r
BOOLEAN\r
HttpBootIsHttpRedirectStatusCode (\r
  IN   EFI_HTTP_STATUS_CODE        StatusCode\r
  );\r
#endif\r