Name

dnsqual — pass a name through the DNS name qualification rules

Synopsis

dnsqual {dn}

Description

dnsqual feeds dn through name qualification. It prints the resultant name, or (if search paths are configured) list of names, 1 per line. See djbdns-client(5) for how name qualification operates.

Normally dnsqual exits 0. If it encounters a temporary problem that prevents it from performing name qualification, it prints an error message and exits 111.

Note

dnsqual outputs names as they would then be passed to DNS lookup in assumed-fully-qualified form (e.g. as the fqdn input to dnsq(1)). This does not use a trailing dot as a marker. It is an error to pass the output names to something that will do name qualification again.

Note

Name qualification by itself does no renormalization of names that contain non-alphanumeric characters or octal escape sequences. That is done when a fqdn is converted to and from the on-the-wire DNS protocol form by DNS lookup.

History

dnsqual was an addition to Daniel J. Bernstein's djbdns toolset by Jonathan de Boyne Pollard.

Author

Original code and documentation by Jonathan de Boyne Pollard.