NetworkPkg/IScsiDxe/IScsiDhcp6.h

   1 /** @file
   2   The header file of iSCSI DHCP6 related configuration routines.
   3
   4 Copyright (c) 2004 - 2012, Intel Corporation. All rights reserved.<BR>
   5 This program and the accompanying materials
   6 are licensed and made available under the terms and conditions of the BSD License
   7 which accompanies this distribution.  The full text of the license may be found at
   8 http://opensource.org/licenses/bsd-license.php
   9
  10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12
  13 **/
  14
  15 #ifndef _ISCSI_DHCP6_H_
  16 #define _ISCSI_DHCP6_H_
  17
  18 #define DHCP6_OPT_REQUEST_OPTION 6
  19 #define DHCP6_OPT_VENDOR_INFO    17
  20 #define DHCP6_OPT_DNS_SERVERS    23
  21 ///
  22 /// Assigned by IANA, RFC 5970
  23 ///
  24 #define DHCP6_OPT_BOOT_FILE_URL  59
  25 #define DHCP6_OPT_BOOT_FILE_PARA 60
  26
  27 #define ISCSI_ROOT_PATH_ID                   "iscsi:"
  28 #define ISCSI_ROOT_PATH_FIELD_DELIMITER      ':'
  29 #define ISCSI_ROOT_PATH_ADDR_START_DELIMITER '['
  30 #define ISCSI_ROOT_PATH_ADDR_END_DELIMITER   ']'
  31
  32
  33 /**
  34   Extract the Root Path option and get the required target information from
  35   Boot File Uniform Resource Locator (URL) Option.
  36
  37   @param[in]       RootPath      The RootPath string.
  38   @param[in]       Length        Length of the RootPath option payload.
  39   @param[in, out]  ConfigData    The iSCSI session configuration data read from
  40                                  nonvolatile device.
  41
  42   @retval EFI_SUCCESS            All required information is extracted from the
  43                                  RootPath option.
  44   @retval EFI_NOT_FOUND          The RootPath is not an iSCSI RootPath.
  45   @retval EFI_OUT_OF_RESOURCES   Failed to allocate memory.
  46   @retval EFI_INVALID_PARAMETER  The RootPath is malformatted.
  47
  48 **/
  49 EFI_STATUS
  50 IScsiDhcp6ExtractRootPath (
  51   IN     CHAR8                        *RootPath,
  52   IN     UINT16                       Length,
  53   IN OUT ISCSI_ATTEMPT_CONFIG_NVDATA *ConfigData
  54   );
  55
  56 /**
  57   Parse the DHCP ACK to get the address configuration and DNS information.
  58
  59   @param[in]       Image         The handle of the driver image.
  60   @param[in]       Controller    The handle of the controller;
  61   @param[in, out]  ConfigData    The attempt configuration data.
  62
  63   @retval EFI_SUCCESS            The DNS information is got from the DHCP ACK.
  64   @retval EFI_NO_MAPPING         DHCP failed to acquire address and other
  65                                  information.
  66   @retval EFI_INVALID_PARAMETER  The DHCP ACK's DNS option is malformatted.
  67   @retval EFI_DEVICE_ERROR       Some unexpected error happened.
  68   @retval EFI_OUT_OF_RESOURCES   There is no sufficient resource to finish the
  69                                  operation.
  70   @retval EFI_NO_MEDIA           There was a media error.
  71
  72 **/
  73 EFI_STATUS
  74 IScsiDoDhcp6 (
  75   IN     EFI_HANDLE                  Image,
  76   IN     EFI_HANDLE                  Controller,
  77   IN OUT ISCSI_ATTEMPT_CONFIG_NVDATA *ConfigData
  78   );
  79
  80 #endif