DNSv4 Service Binding Protocol (DNSv4SB)\r
DNSv4 Protocol (DNSv4)\r
\r
- Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>\r
+ Copyright (c) 2015 - 2018, Intel Corporation. All rights reserved.<BR>\r
This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution. The full text of the license may be found at\r
///\r
typedef struct {\r
///\r
- /// Count of the DNS servers. When used with GetModeData(), \r
- /// this field is the count of originally configured servers when \r
- /// Configure() was called for this instance. When used with \r
- /// Configure() this is the count of caller-supplied servers. If the \r
- /// DnsServerListCount is zero, the DNS server configuration \r
+ /// Count of the DNS servers. When used with GetModeData(),\r
+ /// this field is the count of originally configured servers when\r
+ /// Configure() was called for this instance. When used with\r
+ /// Configure() this is the count of caller-supplied servers. If the\r
+ /// DnsServerListCount is zero, the DNS server configuration\r
/// will be retrieved from DHCP server automatically.\r
///\r
UINTN DnsServerListCount;\r
///\r
- /// Pointer to DNS server list containing DnsServerListCount entries or NULL \r
- /// if DnsServerListCountis 0. For Configure(), this will be NULL when there are \r
- /// no caller supplied server addresses, and, the DNS instance will retrieve \r
- /// DNS server from DHCP Server. The provided DNS server list is \r
- /// recommended to be filled up in the sequence of preference. When \r
- /// used with GetModeData(), the buffer containing the list will \r
- /// be allocated by the driver implementing this protocol and must be \r
- /// freed by the caller. When used with Configure(), the buffer \r
+ /// Pointer to DNS server list containing DnsServerListCount entries or NULL\r
+ /// if DnsServerListCountis 0. For Configure(), this will be NULL when there are\r
+ /// no caller supplied server addresses, and, the DNS instance will retrieve\r
+ /// DNS server from DHCP Server. The provided DNS server list is\r
+ /// recommended to be filled up in the sequence of preference. When\r
+ /// used with GetModeData(), the buffer containing the list will\r
+ /// be allocated by the driver implementing this protocol and must be\r
+ /// freed by the caller. When used with Configure(), the buffer\r
/// containing the list will be allocated and released by the caller.\r
///\r
EFI_IPv4_ADDRESS *DnsServerList;\r
///\r
BOOLEAN EnableDnsCache;\r
///\r
- /// Use the protocol number defined in "Links to UEFI-Related \r
- /// Documents"(http://uefi.org/uefi) under the heading "IANA \r
- /// Protocol Numbers". Only TCP or UDP are supported, and other \r
- /// protocol values are invalid. An implementation can choose to \r
+ /// Use the protocol number defined in "Links to UEFI-Related\r
+ /// Documents"(http://uefi.org/uefi) under the heading "IANA\r
+ /// Protocol Numbers". Only TCP or UDP are supported, and other\r
+ /// protocol values are invalid. An implementation can choose to\r
/// support only UDP, or both TCP and UDP.\r
///\r
UINT8 Protocol;\r
///\r
UINT32 DnsServerCount;\r
///\r
- /// Pointer to common list of addresses of all configured DNS server \r
- /// used by EFI_DNS4_PROTOCOL instances. List will include \r
- /// DNS servers configured by this or any other EFI_DNS4_PROTOCOL instance. \r
- /// The storage for this list is allocated by the driver publishing this \r
+ /// Pointer to common list of addresses of all configured DNS server\r
+ /// used by EFI_DNS4_PROTOCOL instances. List will include\r
+ /// DNS servers configured by this or any other EFI_DNS4_PROTOCOL instance.\r
+ /// The storage for this list is allocated by the driver publishing this\r
/// protocol, and must be freed by the caller.\r
///\r
EFI_IPv4_ADDRESS *DnsServerList;\r
///\r
UINT32 DnsCacheCount;\r
///\r
- /// Pointer to a buffer containing DnsCacheCount DNS Cache \r
- /// entry structures. The storage for this list is allocated by the driver \r
+ /// Pointer to a buffer containing DnsCacheCount DNS Cache\r
+ /// entry structures. The storage for this list is allocated by the driver\r
/// publishing this protocol and must be freed by caller.\r
///\r
EFI_DNS4_CACHE_ENTRY *DnsCacheList;\r
@retval EFI_SUCCESS The operation completed successfully.\r
@retval EFI_UNSUPPORTED The designated protocol is not supported.\r
@retval EFI_INVALID_PARAMETER This is NULL.\r
- The StationIp address provided in DnsConfigData is not a \r
+ The StationIp address provided in DnsConfigData is not a\r
valid unicast.\r
DnsServerList is NULL while DnsServerListCount\r
is not ZERO.\r
allocated.\r
@retval EFI_DEVICE_ERROR An unexpected system or network error occurred. The\r
EFI DNSv4 Protocol instance is not configured.\r
- @retval EFI_ALREADY_STARTED Second call to Configure() with DnsConfigData. To \r
- reconfigure the instance the caller must call Configure() \r
+ @retval EFI_ALREADY_STARTED Second call to Configure() with DnsConfigData. To\r
+ reconfigure the instance the caller must call Configure()\r
with NULL first to return driver to unconfigured state.\r
**/\r
typedef\r
/**\r
IPv4 address to host name translation also known as Reverse DNS lookup.\r
\r
- The IpToHostName() function is used to translate the host address to host name. A type PTR \r
+ The IpToHostName() function is used to translate the host address to host name. A type PTR\r
query is used to get the primary name of the host. Support of this function is optional.\r
\r
@param[in] This Pointer to EFI_DNS4_PROTOCOL instance.\r
);\r
\r
/**\r
- Retrieve arbitrary information from the DNS server. \r
+ Retrieve arbitrary information from the DNS server.\r
\r
This GeneralLookup() function retrieves arbitrary information from the DNS. The caller\r
supplies a QNAME, QTYPE, and QCLASS, and all of the matching RRs are returned. All\r
projects / mirror_edk2.git / blobdiff