TianoCore EDK2 master
|
#include "DnsImpl.h"
Go to the source code of this file.
Variables | |
EFI_DNS4_PROTOCOL | mDns4Protocol |
EFI_DNS6_PROTOCOL | mDns6Protocol |
Implementation of EFI_DNS4_PROTOCOL and EFI_DNS6_PROTOCOL interfaces.
Copyright (c) 2015 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent
Definition in file DnsProtocol.c.
EFI_STATUS EFIAPI Dns4Cancel | ( | IN EFI_DNS4_PROTOCOL * | This, |
IN EFI_DNS4_COMPLETION_TOKEN * | Token | ||
) |
Abort an asynchronous DNS operation, including translation between IP and Host, and general look up behavior.
The Cancel() function is used to abort a pending resolution request. After calling this function, Token.Status will be set to EFI_ABORTED and then Token.Event will be signaled. If the token is not in one of the queues, which usually means that the asynchronous operation has completed, this function will not signal the token and EFI_NOT_FOUND is returned.
[in] | This | Pointer to EFI_DNS4_PROTOCOL instance. |
[in] | Token | Pointer to a token that has been issued by EFI_DNS4_PROTOCOL.HostNameToIp (), EFI_DNS4_PROTOCOL.IpToHostName() or EFI_DNS4_PROTOCOL.GeneralLookup(). If NULL, all pending tokens are aborted. |
EFI_SUCCESS | Incoming or outgoing data was processed. |
EFI_NOT_STARTED | This EFI DNS4 Protocol instance has not been started. |
EFI_INVALID_PARAMETER | This is NULL. |
EFI_NOT_FOUND | When Token is not NULL, and the asynchronous DNS operation was not found in the transmit queue. It was either completed or was not issued by HostNameToIp(), IpToHostName() or GeneralLookup(). |
Definition at line 849 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns4Configure | ( | IN EFI_DNS4_PROTOCOL * | This, |
IN EFI_DNS4_CONFIG_DATA * | DnsConfigData | ||
) |
Configure this DNS instance.
This function is used to configure DNS mode data for this DNS instance.
[in] | This | Pointer to EFI_DNS4_PROTOCOL instance. |
[in] | DnsConfigData | Point to the Configuration data. |
EFI_SUCCESS | The operation completed successfully. |
EFI_UNSUPPORTED | The designated protocol is not supported. |
EFI_INVALID_PARAMETER | This is NULL. The StationIp address provided in DnsConfigData is not a valid unicast. DnsServerList is NULL while DnsServerListCount is not ZERO. DnsServerListCount is ZERO while DnsServerList is not NULL |
EFI_OUT_OF_RESOURCES | The DNS instance data or required space could not be allocated. |
EFI_DEVICE_ERROR | An unexpected system or network error occurred. The EFI DNSv4 Protocol instance is not configured. |
EFI_ALREADY_STARTED | Second call to Configure() with DnsConfigData. To reconfigure the instance the caller must call Configure() with NULL first to return driver to unconfigured state. |
Definition at line 177 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns4GeneralLookUp | ( | IN EFI_DNS4_PROTOCOL * | This, |
IN CHAR8 * | QName, | ||
IN UINT16 | QType, | ||
IN UINT16 | QClass, | ||
IN EFI_DNS4_COMPLETION_TOKEN * | Token | ||
) |
Retrieve arbitrary information from the DNS server.
This GeneralLookup() function retrieves arbitrary information from the DNS. The caller supplies a QNAME, QTYPE, and QCLASS, and all of the matching RRs are returned. All RR content (e.g., TTL) was returned. The caller need parse the returned RR to get required information. The function is optional.
[in] | This | Pointer to EFI_DNS4_PROTOCOL instance. |
[in] | QName | Pointer to Query Name. |
[in] | QType | Query Type. |
[in] | QClass | Query Name. |
[in] | Token | Point to the completion token to retrieve arbitrary information. |
EFI_SUCCESS | The operation completed successfully. |
EFI_UNSUPPORTED | This function is not supported. Or the requested QType is not supported |
EFI_INVALID_PARAMETER | One or more of the following conditions is TRUE: This is NULL. Token is NULL. Token.Event is NULL. QName is NULL. |
EFI_NO_MAPPING | There's no source address is available for use. |
EFI_ALREADY_STARTED | This Token is being used in another DNS session. |
EFI_OUT_OF_RESOURCES | Failed to allocate needed resources. |
Definition at line 595 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns4GetModeData | ( | IN EFI_DNS4_PROTOCOL * | This, |
OUT EFI_DNS4_MODE_DATA * | DnsModeData | ||
) |
Retrieve mode data of this DNS instance.
This function is used to retrieve DNS mode data for this DNS instance.
[in] | This | Pointer to EFI_DNS4_PROTOCOL instance. |
[out] | DnsModeData | Point to the mode data. |
EFI_SUCCESS | The operation completed successfully. |
EFI_NOT_STARTED | When DnsConfigData is queried, no configuration data is available because this instance has not been configured. |
EFI_INVALID_PARAMETER | This is NULL or DnsModeData is NULL. |
EFI_OUT_OF_RESOURCES | Failed to allocate needed resources. |
Definition at line 50 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns4HostNameToIp | ( | IN EFI_DNS4_PROTOCOL * | This, |
IN CHAR16 * | HostName, | ||
IN EFI_DNS4_COMPLETION_TOKEN * | Token | ||
) |
Host name to host address translation.
The HostNameToIp () function is used to translate the host name to host IP address. A type A query is used to get the one or more IP addresses for this host.
[in] | This | Pointer to EFI_DNS4_PROTOCOL instance. |
[in] | HostName | Host name. |
[in] | Token | Point to the completion token to translate host name to host address. |
EFI_SUCCESS | The operation completed successfully. |
EFI_INVALID_PARAMETER | One or more of the following conditions is TRUE: This is NULL. Token is NULL. Token.Event is NULL. HostName is NULL. HostName string is unsupported format. |
EFI_NO_MAPPING | There's no source address is available for use. |
EFI_NOT_STARTED | This instance has not been started. |
Definition at line 333 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns4IpToHostName | ( | IN EFI_DNS4_PROTOCOL * | This, |
IN EFI_IPv4_ADDRESS | IpAddress, | ||
IN EFI_DNS4_COMPLETION_TOKEN * | Token | ||
) |
IPv4 address to host name translation also known as Reverse DNS lookup.
The IpToHostName() function is used to translate the host address to host name. A type PTR query is used to get the primary name of the host. Support of this function is optional.
[in] | This | Pointer to EFI_DNS4_PROTOCOL instance. |
[in] | IpAddress | Ip Address. |
[in] | Token | Point to the completion token to translate host address to host name. |
EFI_SUCCESS | The operation completed successfully. |
EFI_UNSUPPORTED | This function is not supported. |
EFI_INVALID_PARAMETER | One or more of the following conditions is TRUE: This is NULL. Token is NULL. Token.Event is NULL. IpAddress is not valid IP address . |
EFI_NO_MAPPING | There's no source address is available for use. |
EFI_ALREADY_STARTED | This Token is being used in another DNS session. |
EFI_OUT_OF_RESOURCES | Failed to allocate needed resources. |
Definition at line 557 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns4Poll | ( | IN EFI_DNS4_PROTOCOL * | This | ) |
Polls for incoming data packets and processes outgoing data packets.
The Poll() function can be used by network drivers and applications to increase the rate that data packets are moved between the communications device and the transmit and receive queues. In some systems, the periodic timer event in the managed network driver may not poll the underlying communications device fast enough to transmit and/or receive all data packets without missing incoming packets or dropping outgoing packets. Drivers and applications that are experiencing packet loss should try calling the Poll() function more often.
[in] | This | Pointer to EFI_DNS4_PROTOCOL instance. |
EFI_SUCCESS | Incoming or outgoing data was processed. |
EFI_NOT_STARTED | This EFI DNS Protocol instance has not been started. |
EFI_INVALID_PARAMETER | This is NULL. |
EFI_DEVICE_ERROR | An unexpected system or network error occurred. |
EFI_TIMEOUT | Data was dropped out of the transmit and/or receive queue. Consider increasing the polling rate. |
Definition at line 798 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns4UpdateDnsCache | ( | IN EFI_DNS4_PROTOCOL * | This, |
IN BOOLEAN | DeleteFlag, | ||
IN BOOLEAN | Override, | ||
IN EFI_DNS4_CACHE_ENTRY | DnsCacheEntry | ||
) |
This function is to update the DNS Cache.
The UpdateDnsCache() function is used to add/delete/modify DNS cache entry. DNS cache can be normally dynamically updated after the DNS resolve succeeds. This function provided capability to manually add/delete/modify the DNS cache.
[in] | This | Pointer to EFI_DNS4_PROTOCOL instance. |
[in] | DeleteFlag | If FALSE, this function is to add one entry to the DNS Cache. If TRUE, this function will delete matching DNS Cache entry. |
[in] | Override | If TRUE, the matching DNS cache entry will be overwritten with the supplied parameter. If FALSE, EFI_ACCESS_DENIED will be returned if the entry to be added is already existed. |
[in] | DnsCacheEntry | Pointer to DNS Cache entry. |
EFI_SUCCESS | The operation completed successfully. |
EFI_INVALID_PARAMETER | One or more of the following conditions is TRUE: This is NULL. DnsCacheEntry.HostName is NULL. DnsCacheEntry.IpAddress is NULL. DnsCacheEntry.Timeout is zero. |
EFI_ACCESS_DENIED | The DNS cache entry already exists and Override is not TRUE. |
Definition at line 747 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns6Cancel | ( | IN EFI_DNS6_PROTOCOL * | This, |
IN EFI_DNS6_COMPLETION_TOKEN * | Token | ||
) |
Abort an asynchronous DNS operation, including translation between IP and Host, and general look up behavior.
The Cancel() function is used to abort a pending resolution request. After calling this function, Token.Status will be set to EFI_ABORTED and then Token.Event will be signaled. If the token is not in one of the queues, which usually means that the asynchronous operation has completed, this function will not signal the token and EFI_NOT_FOUND is returned.
[in] | This | Pointer to EFI_DNS6_PROTOCOL instance. |
[in] | Token | Pointer to a token that has been issued by EFI_DNS6_PROTOCOL.HostNameToIp (), EFI_DNS6_PROTOCOL.IpToHostName() or EFI_DNS6_PROTOCOL.GeneralLookup(). If NULL, all pending tokens are aborted. |
EFI_SUCCESS | Incoming or outgoing data was processed. |
EFI_NOT_STARTED | This EFI DNS6 Protocol instance has not been started. |
EFI_INVALID_PARAMETER | This is NULL. |
EFI_NO_MAPPING | There's no source address is available for use. |
EFI_NOT_FOUND | When Token is not NULL, and the asynchronous DNS operation was not found in the transmit queue. It was either completed or was not issued by HostNameToIp(), IpToHostName() or GeneralLookup(). |
Definition at line 1702 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns6Configure | ( | IN EFI_DNS6_PROTOCOL * | This, |
IN EFI_DNS6_CONFIG_DATA * | DnsConfigData | ||
) |
Configure this DNS instance.
The Configure() function is used to set and change the configuration data for this EFI DNSv6 Protocol driver instance. Reset the DNS instance if DnsConfigData is NULL.
[in] | This | Pointer to EFI_DNS6_PROTOCOL instance. |
[in] | DnsConfigData | Pointer to the configuration data structure. All associated storage to be allocated and released by caller. |
EFI_SUCCESS | The operation completed successfully. |
EFI_INVALID_PARAMETER | This is NULL. The StationIp address provided in DnsConfigData is not zero and not a valid unicast. DnsServerList is NULL while DnsServerList Count is not ZERO. DnsServerList Count is ZERO while DnsServerList is not NULL. |
EFI_OUT_OF_RESOURCES | The DNS instance data or required space could not be allocated. |
EFI_DEVICE_ERROR | An unexpected system or network error occurred. The EFI DNSv6 Protocol instance is not configured. |
EFI_UNSUPPORTED | The designated protocol is not supported. |
EFI_ALREADY_STARTED | Second call to Configure() with DnsConfigData. To reconfigure the instance the caller must call Configure() with NULL first to return driver to unconfigured state. |
Definition at line 1028 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns6GeneralLookUp | ( | IN EFI_DNS6_PROTOCOL * | This, |
IN CHAR8 * | QName, | ||
IN UINT16 | QType, | ||
IN UINT16 | QClass, | ||
IN EFI_DNS6_COMPLETION_TOKEN * | Token | ||
) |
This function provides capability to retrieve arbitrary information from the DNS server.
This GeneralLookup() function retrieves arbitrary information from the DNS. The caller supplies a QNAME, QTYPE, and QCLASS, and all of the matching RRs are returned. All RR content (e.g., TTL) was returned. The caller need parse the returned RR to get required information. The function is optional. Implementation can choose to support it or not.
[in] | This | Pointer to EFI_DNS6_PROTOCOL instance. |
[in] | QName | Pointer to Query Name. |
[in] | QType | Query Type. |
[in] | QClass | Query Name. |
[in] | Token | Point to the completion token to retrieve arbitrary information. |
EFI_SUCCESS | The operation completed successfully. |
EFI_UNSUPPORTED | This function is not supported. Or the requested QType is not supported |
EFI_INVALID_PARAMETER | One or more of the following conditions is TRUE: This is NULL. Token is NULL. Token.Event is NULL. QName is NULL. |
EFI_NO_MAPPING | There's no source address is available for use. |
EFI_NOT_STARTED | This instance has not been started. |
EFI_OUT_OF_RESOURCES | Failed to allocate needed resources. |
Definition at line 1444 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns6GetModeData | ( | IN EFI_DNS6_PROTOCOL * | This, |
OUT EFI_DNS6_MODE_DATA * | DnsModeData | ||
) |
Retrieve mode data of this DNS instance.
This function is used to retrieve DNS mode data for this DNS instance.
[in] | This | Pointer to EFI_DNS6_PROTOCOL instance. |
[out] | DnsModeData | Pointer to the caller-allocated storage for the EFI_DNS6_MODE_DATA data. |
EFI_SUCCESS | The operation completed successfully. |
EFI_NOT_STARTED | When DnsConfigData is queried, no configuration data is available because this instance has not been configured. |
EFI_INVALID_PARAMETER | This is NULL or DnsModeData is NULL. |
EFI_OUT_OF_RESOURCE | Failed to allocate needed resources. |
Definition at line 903 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns6HostNameToIp | ( | IN EFI_DNS6_PROTOCOL * | This, |
IN CHAR16 * | HostName, | ||
IN EFI_DNS6_COMPLETION_TOKEN * | Token | ||
) |
Host name to host address translation.
The HostNameToIp () function is used to translate the host name to host IP address. A type AAAA query is used to get the one or more IPv6 addresses for this host.
[in] | This | Pointer to EFI_DNS6_PROTOCOL instance. |
[in] | HostName | Host name. |
[in] | Token | Point to the completion token to translate host name to host address. |
EFI_SUCCESS | The operation completed successfully. |
EFI_INVALID_PARAMETER | One or more of the following conditions is TRUE: This is NULL. Token is NULL. Token.Event is NULL. HostName is NULL or buffer contained unsupported characters. |
EFI_NO_MAPPING | There's no source address is available for use. |
EFI_ALREADY_STARTED | This Token is being used in another DNS session. |
EFI_NOT_STARTED | This instance has not been started. |
EFI_OUT_OF_RESOURCES | Failed to allocate needed resources. |
Definition at line 1179 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns6IpToHostName | ( | IN EFI_DNS6_PROTOCOL * | This, |
IN EFI_IPv6_ADDRESS | IpAddress, | ||
IN EFI_DNS6_COMPLETION_TOKEN * | Token | ||
) |
Host address to host name translation.
The IpToHostName () function is used to translate the host address to host name. A type PTR query is used to get the primary name of the host. Implementation can choose to support this function or not.
[in] | This | Pointer to EFI_DNS6_PROTOCOL instance. |
[in] | IpAddress | Ip Address. |
[in] | Token | Point to the completion token to translate host address to host name. |
EFI_SUCCESS | The operation completed successfully. |
EFI_UNSUPPORTED | This function is not supported. |
EFI_INVALID_PARAMETER | One or more of the following conditions is TRUE: This is NULL. Token is NULL. Token.Event is NULL. IpAddress is not valid IP address. |
EFI_NO_MAPPING | There's no source address is available for use. |
EFI_NOT_STARTED | This instance has not been started. |
EFI_OUT_OF_RESOURCES | Failed to allocate needed resources. |
Definition at line 1404 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns6Poll | ( | IN EFI_DNS6_PROTOCOL * | This | ) |
Polls for incoming data packets and processes outgoing data packets.
The Poll() function can be used by network drivers and applications to increase the rate that data packets are moved between the communications device and the transmit and receive queues.
In some systems, the periodic timer event in the managed network driver may not poll the underlying communications device fast enough to transmit and/or receive all data packets without missing incoming packets or dropping outgoing packets. Drivers and applications that are experiencing packet loss should try calling the Poll() function more often.
[in] | This | Pointer to EFI_DNS6_PROTOCOL instance. |
EFI_SUCCESS | Incoming or outgoing data was processed. |
EFI_NOT_STARTED | This EFI DNS Protocol instance has not been started. |
EFI_INVALID_PARAMETER | This is NULL. |
EFI_NO_MAPPING | There is no source address is available for use. |
EFI_DEVICE_ERROR | An unexpected system or network error occurred. |
EFI_TIMEOUT | Data was dropped out of the transmit and/or receive queue. Consider increasing the polling rate. |
Definition at line 1650 of file DnsProtocol.c.
EFI_STATUS EFIAPI Dns6UpdateDnsCache | ( | IN EFI_DNS6_PROTOCOL * | This, |
IN BOOLEAN | DeleteFlag, | ||
IN BOOLEAN | Override, | ||
IN EFI_DNS6_CACHE_ENTRY | DnsCacheEntry | ||
) |
This function is to update the DNS Cache.
The UpdateDnsCache() function is used to add/delete/modify DNS cache entry. DNS cache can be normally dynamically updated after the DNS resolve succeeds. This function provided capability to manually add/delete/modify the DNS cache.
[in] | This | Pointer to EFI_DNS6_PROTOCOL instance. |
[in] | DeleteFlag | If FALSE, this function is to add one entry to the DNS Cache. If TRUE, this function will delete matching DNS Cache entry. |
[in] | Override | If TRUE, the matching DNS cache entry will be overwritten with the supplied parameter. If FALSE, EFI_ACCESS_DENIED will be returned if the entry to be added is already existed. |
[in] | DnsCacheEntry | Pointer to DNS Cache entry. |
EFI_SUCCESS | The operation completed successfully. |
EFI_INVALID_PARAMETER | One or more of the following conditions is TRUE: This is NULL. DnsCacheEntry.HostName is NULL. DnsCacheEntry.IpAddress is NULL. DnsCacheEntry.Timeout is zero. |
EFI_ACCESS_DENIED | The DNS cache entry already exists and Override is not TRUE. |
EFI_OUT_OF_RESOURCE | Failed to allocate needed resources. |
Definition at line 1597 of file DnsProtocol.c.
EFI_DNS4_PROTOCOL mDns4Protocol |
Definition at line 11 of file DnsProtocol.c.
EFI_DNS6_PROTOCOL mDns6Protocol |
Definition at line 22 of file DnsProtocol.c.