jdk.naming.dns (Java SE 26 & JDK 26)
Description: declaration: module: jdk.naming.dns
Keywords: jdk.naming.dns module

# Module jdk.naming.dns

module jdk.naming.dns
Provides the implementation of the DNS Java Naming provider.

## Environment Properties

The following JNDI environment properties may be used when creating the initial context.

- com.sun.jndi.dns.timeout.initial
- com.sun.jndi.dns.timeout.retries

These properties are used to alter the timeout-related defaults that the DNS provider uses when submitting queries. The DNS provider submits queries using the following exponential backoff algorithm. The provider submits a query to a DNS server and waits for a response to arrive within a timeout period (1 second by default). If it receives no response within the timeout period, it queries the next server, and so on. If the provider receives no response from any server, it doubles the timeout period and repeats the process of submitting the query to each server, up to a maximum number of retries (4 by default).

The `com.sun.jndi.dns.timeout.initial` property, if set, specifies the number of milliseconds to use as the initial timeout period (i.e., before any doubling). If this property has not been set, the default initial timeout is 1000 milliseconds.

The `com.sun.jndi.dns.timeout.retries` property, if set, specifies the number of times to retry each server using the exponential backoff algorithm described previously. If this property has not been set, the default number of retries is 4.

Module Graph:
Since:
  9

- ## Services

  Provides
  Type
  Description
  InitialContextFactory
  This interface represents a factory that creates an initial context.