blob: 4ca25bd4945bc8aa62e4a90dd58d16802430d106 [file] [log] [blame]
Vishal Bhoj82c80712015-12-15 21:13:33 +05301/** @file
2 The header file of iSCSI DHCP6 related configuration routines.
3
4Copyright (c) 2004 - 2012, Intel Corporation. All rights reserved.<BR>
5This program and the accompanying materials
6are licensed and made available under the terms and conditions of the BSD License
7which accompanies this distribution. The full text of the license may be found at
8http://opensource.org/licenses/bsd-license.php
9
10THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11WITHOUT 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**/
49EFI_STATUS
50IScsiDhcp6ExtractRootPath (
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**/
73EFI_STATUS
74IScsiDoDhcp6 (
75 IN EFI_HANDLE Image,
76 IN EFI_HANDLE Controller,
77 IN OUT ISCSI_ATTEMPT_CONFIG_NVDATA *ConfigData
78 );
79
80#endif