nsIDNSService

Methods

asyncResolve(aHostName, aFlags, aListener, aListenerTarget)

kicks off an asynchronous host lookup.

Parameters

aHostName	the hostname or IP-address-literal to resolve.
aFlags	a bitwise OR of the RESOLVE_ prefixed constants defined below.
aListener	the listener to be notified when the result is available.
aListenerTarget	optional parameter (may be null). if non-null, this parameter specifies the nsIEventTarget of the thread on which the listener's onLookupComplete should be called. however, if this parameter is null, then onLookupComplete will be called on an unspecified thread (possibly recursively).

Returns

An object that can be used to cancel the host lookup.

cancelAsyncResolve(aHostName, aFlags, aListener, aReason)

Attempts to cancel a previously requested async DNS lookup

Parameters

aHostName	the hostname or IP-address-literal to resolve.
aFlags	a bitwise OR of the RESOLVE_ prefixed constants defined below.
aListener	the original listener which was to be notified about the host lookup result - used to match request information to requestor.
aReason	nsresult reason for the cancellation

Returns

An object that can be used to cancel the host lookup.

resolve(aHostName, aFlags)

called to synchronously resolve a hostname. warning this method may
block the calling thread for a long period of time. it is extremely
unwise to call this function on the UI thread of an application.

Parameters

aHostName	the hostname or IP-address-literal to resolve.
aFlags	a bitwise OR of the RESOLVE_ prefixed constants defined below.

Returns

DNS record corresponding to the given hostname. @throws NS_ERROR_UNKNOWN_HOST if host could not be resolved.

getDNSCacheEntries(args)

The method takes a pointer to an nsTArray
and fills it with cache entry data
Called by the networking dashboard

Attributes

myHostName

@return the hostname of the operating system.

Constants

RESOLVE_BYPASS_CACHE

Listed below are the various flags that may be OR’d together to form
the aFlags parameter passed to asyncResolve() and resolve().

if set, this flag suppresses the internal DNS lookup cache.

RESOLVE_CANONICAL_NAME

if set, the canonical name of the specified host will be queried.

RESOLVE_PRIORITY_MEDIUM

if set, the query is given lower priority. Medium takes precedence
if both are used.

RESOLVE_PRIORITY_LOW

RESOLVE_SPECULATE

if set, indicates request is speculative. Speculative requests
return errors if prefetching is disabled by configuration.

RESOLVE_DISABLE_IPV6

If set, only IPv4 addresses will be returned from resolve/asyncResolve.

RESOLVE_OFFLINE

If set, only literals and cached entries will be returned from resolve/
asyncResolve.

RESOLVE_DISABLE_IPV4

If set, only IPv6 addresses will be returned from resolve/asyncResolve.