From 416ef5e2bf59bb2e45066a1d5d91ac677c0f48e5 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Wed, 10 Dec 2014 03:05:47 +0000 Subject: Initial commit --- doc/s6-dnsname.html | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 doc/s6-dnsname.html (limited to 'doc/s6-dnsname.html') diff --git a/doc/s6-dnsname.html b/doc/s6-dnsname.html new file mode 100644 index 0000000..0c0c5b0 --- /dev/null +++ b/doc/s6-dnsname.html @@ -0,0 +1,72 @@ + + + + + s6-dns: the s6-dnsname program + + + + + + +

+s6-dns
+Software
+skarnet.org +

+ +

The s6-dnsname program

+ +

+ s6-dnsname finds the name associated to an IPv4 or IPv6 address. +

+ +

Interface

+ +

+     s6-dnsname [ -4 | -6 ] [ -r ] [ -t timeout ] ip
+

+ +

s6-dnsname converts the IP address ip to a name +ending in in-addr.arpa. or ip6.arpa. then makes a +PTR query for this name. +It waits for the result and prints the obtained names, one per line, +then exits 0.
If the domain exists but no relevant field has been found, it exits 1.
If the DNS answered but no answer is available, it prints a relevant +error message and exits 2.
By default, s6-dnsname looks for DNS cache addresses in the +/etc/resolv.conf file. If the DNSCACHEIP environment variable is set +and contains a list of IP (v4 or v6) addresses, separated by commas, +semicolons, spaces, tabs, newlines or carriage returns, then this list +is used instead.

+ +

Options

+ +

-4 : interpret ip as an IPv4 address.
-6 : interpret ip as an IPv6 address. +If neither of the -4 and -6 is given, or if both are +given, then ip will be interpreted as v4 or v6 depending on +its syntax.
-r : random. By default, the program does not sort the +result, but prints them in the order received from the DNS. With this +option, it performs a random permutation on the results before printing +them.
-t timeout : if the resolution takes more +than timeout milliseconds, then it exits 99 right away with an error +message. By default, timeout is 0, which means no timeout.

+ +

Notes

+ +

If the underlying skalibs has been compiled with IPv6 support disabled, +s6-dnsname will not be able to use IPv6 transport for its resolution, but it +will still accept and resolve IPv6 addresses.

+ + + -- cgit v1.2.3