Sun Java System Web Proxy Server 4.0.5 Configuration File Reference

dns-config

Syntax

DNS fn=dns-config local-domain-levels=<n>

local-domain-levels specifies the number of levels of subdomains that the local network has. The default is 1.

Web Proxy Server optimizes DNS lookups by reducing the times of trying to resolve hosts that are apparently fully qualified domain names but which DNS would otherwise by default still try to resolve relative to the local domain.

For example, from the netscape.com domain, suppose you try to access the host www.xyzzy.com. At first, DNS will try to resolve:

    www.xyzzy.com.netscape.com

and only after that the real fully qualified domain name:

    www.xyzzy.com

If the local domain has subdomains, such as corp.netscape.com, DNS would try two additional lookups:

    www.xyzzy.com.corp.netscape.com    www.xyzzy.com.netscape.com

To avoid these extra DNS lookups, you can instructs to the proxy to treat host names that are apparently not local as remote. The proxy should instruct DNS immediately not to try to resolve the name relative to the current domain.

If the local network has no subdomains, you set the value to 0. Only if the host name has no domain part at all (no dots in the host name) will the name be resolved relative to the local domain. Otherwise, DNS should always resolve the name as an absolute, fully qualified domain name.

If the local network has one level of subdomains, you set the value to 1. Host names that include two or more dots will be treated as fully qualified domain names, and so on.

An example of one level of subdomains would be the netscape.com domain, with subdomains:

    corp.netscape.com    engr.netscape.com    mktg.netscape.com

Hosts without a dot, such as step would be resolved with respect to the current domain, such as engr.netscape.com. The dns-config function would try this name:

    step.engr.netscape.com

If you are on corp.netscape.com but the destination host step is on the engr subdomain, you could type just:

    step.engr

instead of having to specify the fully qualified domain name:

    step.engr.netscape.com