MdePkg/Include/Protocol/Dns6.h File Reference


Data Structures

struct  EFI_DNS6_CONFIG_DATA
struct  EFI_DNS6_CACHE_ENTRY
struct  EFI_DNS6_MODE_DATA
struct  DNS6_HOST_TO_ADDR_DATA
struct  DNS6_ADDR_TO_HOST_DATA
struct  DNS6_RESOURCE_RECORD
struct  DNS6_GENERAL_LOOKUP_DATA
struct  EFI_DNS6_COMPLETION_TOKEN
struct  _EFI_DNS6_PROTOCOL

Defines

#define EFI_DNS6_SERVICE_BINDING_PROTOCOL_GUID
#define EFI_DNS6_PROTOCOL_GUID

Typedefs

typedef struct _EFI_DNS6_PROTOCOL EFI_DNS6_PROTOCOL
typedef EFI_STATUS(EFIAPI * EFI_DNS6_GET_MODE_DATA )(IN EFI_DNS6_PROTOCOL *This, OUT EFI_DNS6_MODE_DATA *DnsModeData)
typedef EFI_STATUS(EFIAPI * EFI_DNS6_CONFIGURE )(IN EFI_DNS6_PROTOCOL *This, IN EFI_DNS6_CONFIG_DATA *DnsConfigData)
typedef IN CHAR16HostName
typedef IN CHAR16 IN
EFI_DNS6_COMPLETION_TOKEN
Token
typedef IN EFI_IPv6_ADDRESS IpAddress
typedef IN CHAR8QName
typedef IN CHAR8 IN UINT16 QType
typedef IN CHAR8 IN UINT16 IN
UINT16 
QClass
typedef IN BOOLEAN DeleteFlag
typedef IN BOOLEAN IN BOOLEAN Override
typedef IN BOOLEAN IN BOOLEAN
IN EFI_DNS6_CACHE_ENTRY 
DnsCacheEntry

Functions

typedef EFI_STATUS (EFIAPI *EFI_DNS6_HOST_NAME_TO_IP)(IN EFI_DNS6_PROTOCOL *This

Variables

EFI_GUID gEfiDns6ServiceBindingProtocolGuid
EFI_GUID gEfiDns6ProtocolGuid

Detailed Description

This file defines the EFI DNSv6 (Domain Name Service version 6) Protocol. It is split into the following two main sections: DNSv6 Service Binding Protocol (DNSv6SB) DNSv6 Protocol (DNSv6)

Copyright (c) 2015, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at http://opensource.org/licenses/bsd-license.php

THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

Revision Reference:
This Protocol is introduced in UEFI Specification 2.5

Define Documentation

#define EFI_DNS6_PROTOCOL_GUID

Value:

{ \
    0xca37bc1f, 0xa327, 0x4ae9, {0x82, 0x8a, 0x8c, 0x40, 0xd8, 0x50, 0x6a, 0x17 } \
  }

#define EFI_DNS6_SERVICE_BINDING_PROTOCOL_GUID

Value:

{ \
    0x7f1647c8, 0xb76e, 0x44b2, {0xa5, 0x65, 0xf7, 0xf, 0xf1, 0x9c, 0xd1, 0x9e } \
  }


Typedef Documentation

typedef IN BOOLEAN DeleteFlag

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.

Parameters:
[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.
Return values:
EFI_SUCCESS The operation completed successfully.
EFI_INVALID_PARAMTER This is NULL. The StationIp address provided in DnsConfigData is 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.

Retrieve mode data of this DNS instance.

This function is used to retrieve DNS mode data for this DNS instance.

Parameters:
[in] This Pointer to EFI_DNS6_PROTOCOL instance.
[out] DnsModeData Pointer to the caller-allocated storage for the EFI_DNS6_MODE_DATA data.
Return values:
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.

typedef IN CHAR16* HostName

typedef IN BOOLEAN IN BOOLEAN Override

typedef IN CHAR8 IN UINT16 IN UINT16 QClass

typedef IN CHAR8* QName

typedef IN CHAR8 IN UINT16 QType


Function Documentation

typedef EFI_STATUS ( EFIAPI *  EFI_DNS6_CANCEL  ) 

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 IPv6 addresses for this host.

Parameters:
[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.
Return values:
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.
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.

Parameters:
[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.
Return values:
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.
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.

Parameters:
[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.
Return values:
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.
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.

Parameters:
[in] This Pointer to EFI_DNS6_PROTOCOL instance.
[in] DeleteFlag If FALSE, this function is to add one entry to the DNS Cahce. If TRUE, this function will delete matching DNS Cache entry.
[in] Override If TRUE, the maching 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.
Return values:
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.
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.

Parameters:
[in] This Pointer to EFI_DNS6_PROTOCOL instance.
Return values:
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.
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.

Parameters:
[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.
Return values:
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().


Variable Documentation


Generated on Wed Sep 23 16:24:22 2015 for MdePkg[ALL] by  doxygen 1.5.7.1