2 This file provides a definition of the EFI IPv4 Configuration II
5 Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
6 This program and the accompanying materials
7 are licensed and made available under the terms and conditions of the BSD License
8 which accompanies this distribution. The full text of the license may be found at<BR>
9 http://opensource.org/licenses/bsd-license.php
11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
14 @par Revision Reference:
15 This Protocol is introduced in UEFI Specification 2.5
18 #ifndef __EFI_IP4CONFIG2_PROTOCOL_H__
19 #define __EFI_IP4CONFIG2_PROTOCOL_H__
21 #include <Protocol/Ip4.h>
23 #define EFI_IP4_CONFIG2_PROTOCOL_GUID \
25 0x5b446ed1, 0xe30b, 0x4faa, {0x87, 0x1a, 0x36, 0x54, 0xec, 0xa3, 0x60, 0x80 } \
28 typedef struct _EFI_IP4_CONFIG2_PROTOCOL EFI_IP4_CONFIG2_PROTOCOL
;
32 /// EFI_IP4_CONFIG2_DATA_TYPE
36 /// The interface information of the communication device this EFI
37 /// IPv4 Configuration II Protocol instance manages. This type of
38 /// data is read only. The corresponding Data is of type
39 /// EFI_IP4_CONFIG2_INTERFACE_INFO.
41 Ip4Config2DataTypeInterfaceInfo
,
43 /// The general configuration policy for the EFI IPv4 network stack
44 /// running on the communication device this EFI IPv4
45 /// Configuration II Protocol instance manages. The policy will
46 /// affect other configuration settings. The corresponding Data is of
47 /// type EFI_IP4_CONFIG2_POLICY.
49 Ip4Config2DataTypePolicy
,
51 /// The station addresses set manually for the EFI IPv4 network
52 /// stack. It is only configurable when the policy is
53 /// Ip4Config2PolicyStatic. The corresponding Data is of
54 /// type EFI_IP4_CONFIG2_MANUAL_ADDRESS.
56 Ip4Config2DataTypeManualAddress
,
58 /// The gateway addresses set manually for the EFI IPv4 network
59 /// stack running on the communication device this EFI IPv4
60 /// Configuration II Protocol manages. It is not configurable when
61 /// the policy is Ip4Config2PolicyDhcp. The gateway
62 /// addresses must be unicast IPv4 addresses. The corresponding
63 /// Data is a pointer to an array of EFI_IPv4_ADDRESS instances.
65 Ip4Config2DataTypeGateway
,
67 /// The DNS server list for the EFI IPv4 network stack running on
68 /// the communication device this EFI IPv4 Configuration II
69 /// Protocol manages. It is not configurable when the policy is
70 /// Ip4Config2PolicyDhcp. The DNS server addresses must be
71 /// unicast IPv4 addresses. The corresponding Data is a pointer to
72 /// an array of EFI_IPv4_ADDRESS instances.
74 Ip4Config2DataTypeDnsServer
,
75 Ip4Config2DataTypeMaximum
76 } EFI_IP4_CONFIG2_DATA_TYPE
;
79 /// EFI_IP4_CONFIG2_INTERFACE_INFO
83 /// The name of the interface. It is a NULL-terminated Unicode string.
87 /// The interface type of the network interface. See RFC 1700,
88 /// section "Number Hardware Type".
92 /// The size, in bytes, of the network interface's hardware address.
96 /// The hardware address for the network interface.
98 EFI_MAC_ADDRESS HwAddress
;
100 /// The station IPv4 address of this EFI IPv4 network stack.
102 EFI_IPv4_ADDRESS StationAddress
;
104 /// The subnet address mask that is associated with the station address.
106 EFI_IPv4_ADDRESS SubnetMask
;
108 /// Size of the following RouteTable, in bytes. May be zero.
110 UINT32 RouteTableSize
;
112 /// The route table of the IPv4 network stack runs on this interface.
113 /// Set to NULL if RouteTableSize is zero. Type EFI_IP4_ROUTE_TABLE is defined in
114 /// EFI_IP4_PROTOCOL.GetModeData().
116 EFI_IP4_ROUTE_TABLE
*RouteTable OPTIONAL
;
117 } EFI_IP4_CONFIG2_INTERFACE_INFO
;
120 /// EFI_IP4_CONFIG2_POLICY
124 /// Under this policy, the Ip4Config2DataTypeManualAddress,
125 /// Ip4Config2DataTypeGateway and Ip4Config2DataTypeDnsServer configuration
126 /// data are required to be set manually. The EFI IPv4 Protocol will get all
127 /// required configuration such as IPv4 address, subnet mask and
128 /// gateway settings from the EFI IPv4 Configuration II protocol.
130 Ip4Config2PolicyStatic
,
132 /// Under this policy, the Ip4Config2DataTypeManualAddress,
133 /// Ip4Config2DataTypeGateway and Ip4Config2DataTypeDnsServer configuration data are
134 /// not allowed to set via SetData(). All of these configurations are retrieved from DHCP
135 /// server or other auto-configuration mechanism.
137 Ip4Config2PolicyDhcp
,
139 } EFI_IP4_CONFIG2_POLICY
;
142 /// EFI_IP4_CONFIG2_MANUAL_ADDRESS
146 /// The IPv4 unicast address.
148 EFI_IPv4_ADDRESS Address
;
152 EFI_IPv4_ADDRESS SubnetMask
;
153 } EFI_IP4_CONFIG2_MANUAL_ADDRESS
;
156 Set the configuration for the EFI IPv4 network stack running on the communication device this EFI
157 IPv4 Configuration II Protocol instance manages.
159 This function is used to set the configuration data of type DataType for the EFI IPv4 network stack
160 running on the communication device this EFI IPv4 Configuration II Protocol instance manages.
161 The successfully configured data is valid after system reset or power-off.
162 The DataSize is used to calculate the count of structure instances in the Data for some
163 DataType that multiple structure instances are allowed.
164 This function is always non-blocking. When setting some typeof configuration data, an
165 asynchronous process is invoked to check the correctness of the data, such as doing address conflict
166 detection on the manually set local IPv4 address. EFI_NOT_READY is returned immediately to
167 indicate that such an asynchronous process is invoked and the process is not finished yet. The caller
168 willing to get the result of the asynchronous process is required to call RegisterDataNotify()
169 to register an event on the specified configuration data. Once the event is signaled, the caller can call
170 GetData()to get back the configuration data in order to know the result. For other types of
171 configuration data that do not require an asynchronous configuration process, the result of the
172 operation is immediately returned.
174 @param[in] This Pointer to the EFI_IP4_CONFIG2_PROTOCOL instance.
175 @param[in] DataType The type of data to set.
176 @param[in] DataSize Size of the buffer pointed to by Data in bytes.
177 @param[in] Data The data buffer to set. The type ofthe data buffer is associated
180 @retval EFI_SUCCESS The specified configuration data for the EFI IPv4 network stack is set
182 @retval EFI_INVALID_PARAMETER One or more of the following are TRUE:
185 One or more fields in Data do not match the requirement of the data type
186 indicated by DataType.
187 @retval EFI_WRITE_PROTECTED The specified configuration data is read-only or the specified configuration
188 data can not be set under the current policy.
189 @retval EFI_ACCESS_DENIED Another set operation on the specified configuration data is already in process.
190 @retval EFI_NOT_READY An asynchronous process is invoked to set the specified configuration data and
191 the process is not finished yet.
192 @retval EFI_BAD_BUFFER_SIZE The DataSize does not match the size of the type indicated by DataType.
193 @retval EFI_UNSUPPORTED This DataType is not supported.
194 @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated.
195 @retval EFI_DEVICE_ERROR An unexpected system error or network error occurred.
199 (EFIAPI
*EFI_IP4_CONFIG2_SET_DATA
) (
200 IN EFI_IP4_CONFIG2_PROTOCOL
*This
,
201 IN EFI_IP4_CONFIG2_DATA_TYPE DataType
,
207 Get the configuration data for the EFI IPv4 network stack running on the communication device this
208 EFI IPv4 Configuration II Protocol instance manages.
210 This function returns the configuration data of type DataType for the EFI IPv4 network stack
211 running on the communication device this EFI IPv4 Configuration II Protocol instance manages.
212 The caller is responsible for allocating the buffer usedto return the specified configuration data and
213 the required size will be returned to the caller if the size of the buffer is too small.
214 EFI_NOT_READY is returned if the specified configuration data is not ready due to an already in
215 progress asynchronous configuration process. The caller can call RegisterDataNotify() to
216 register an event on the specified configuration data. Once the asynchronous configuration process is
217 finished, the event will be signaled and a subsequent GetData() call will return the specified
220 @param[in] This Pointer to the EFI_IP4_CONFIG2_PROTOCOL instance.
221 @param[in] DataType The type of data to get.
222 @param[out] DataSize On input, in bytes, the size of Data. On output, in bytes, the size
223 of buffer required to store the specified configuration data.
224 @param[in] Data The data buffer in which the configuration data is returned. The
225 type of the data buffer is associated with the DataType. Ignored
228 @retval EFI_SUCCESS The specified configuration data is got successfully.
229 @retval EFI_INVALID_PARAMETER One or more of the followings are TRUE:
232 Data is NULL if *DataSizeis not zero.
233 @retval EFI_BUFFER_TOO_SMALL The size of Data is too small for the specified configuration data
234 and the required size is returned in DataSize.
235 @retval EFI_NOT_READY The specified configuration data is not ready due to an already in
236 progress asynchronous configuration process.
237 @retval EFI_NOT_FOUND The specified configuration data is not found.
241 (EFIAPI
*EFI_IP4_CONFIG2_GET_DATA
) (
242 IN EFI_IP4_CONFIG2_PROTOCOL
*This
,
243 IN EFI_IP4_CONFIG2_DATA_TYPE DataType
,
244 IN OUT UINTN
*DataSize
,
245 IN VOID
*Data OPTIONAL
249 Register an event that is to be signaled whenever a configuration process on the specified
250 configuration data is done.
252 This function registers an event that is to be signaled whenever a configuration process on the
253 specified configuration data is done. An event can be registered for different DataType
254 simultaneously and the caller is responsible for determining which type of configuration data causes
255 the signaling of the event in such case.
257 @param[in] This Pointer to the EFI_IP4_CONFIG2_PROTOCOL instance.
258 @param[in] DataType The type of data to unregister the event for.
259 @param[in] Event The event to register.
261 @retval EFI_SUCCESS The notification event for the specified configuration data is
263 @retval EFI_INVALID_PARAMETER This is NULL or Event is NULL.
264 @retval EFI_UNSUPPORTED The configuration data type specified by DataType is not supported.
265 @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated.
266 @retval EFI_ACCESS_DENIED The Event is already registered for the DataType.
270 (EFIAPI
*EFI_IP4_CONFIG2_REGISTER_NOTIFY
) (
271 IN EFI_IP4_CONFIG2_PROTOCOL
*This
,
272 IN EFI_IP4_CONFIG2_DATA_TYPE DataType
,
277 Remove a previously registered event for the specified configuration data.
279 This function removes a previously registeredevent for the specified configuration data.
281 @param[in] This Pointer to the EFI_IP4_CONFIG2_PROTOCOL instance.
282 @param[in] DataType The type of data to remove the previously registered event for.
283 @param[in] Event The event to unregister.
285 @retval EFI_SUCCESS The event registered for the specified configuration data is removed.
286 @retval EFI_INVALID_PARAMETER This is NULL or Event is NULL.
287 @retval EFI_NOT_FOUND The Eventhas not been registered for the specified DataType.
291 (EFIAPI
*EFI_IP4_CONFIG2_UNREGISTER_NOTIFY
) (
292 IN EFI_IP4_CONFIG2_PROTOCOL
*This
,
293 IN EFI_IP4_CONFIG2_DATA_TYPE DataType
,
298 /// The EFI_IP4_CONFIG2_PROTOCOL is designed to be the central repository for the common
299 /// configurations and the administrator configurable settings for the EFI IPv4 network stack.
300 /// An EFI IPv4 Configuration II Protocol instance will be installed on each communication device that
301 /// the EFI IPv4 network stack runs on.
303 struct _EFI_IP4_CONFIG2_PROTOCOL
{
304 EFI_IP4_CONFIG2_SET_DATA SetData
;
305 EFI_IP4_CONFIG2_GET_DATA GetData
;
306 EFI_IP4_CONFIG2_REGISTER_NOTIFY RegisterDataNotify
;
307 EFI_IP4_CONFIG2_UNREGISTER_NOTIFY UnregisterDataNotify
;
310 extern EFI_GUID gEfiIp4Config2ProtocolGuid
;