Vishal Bhoj | 82c8071 | 2015-12-15 21:13:33 +0530 | [diff] [blame^] | 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
|