.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.16. .TH ADNSHOST "1" "August 2020" "GNU adns 1.6.0" "User Commands" .SH NAME adnshost \- Asynchronous-capable DNS client utilities .SH DESCRIPTION usage: adnshost [global\-opts] [query\-opts] query\-domain .IP [[query\-opts] query\-domain ...] .IP adnshost [global\-opts] [query\-opts] \fB\-f\fR|\-\-pipe .SS "global binary options:" .TP +e \fB\-\-no\-env\fR Do not look at environment variables at all .TP \fB\-f\fR \fB\-\-pipe\fR Read queries on stdin instead of using args .TP \fB\-a\fR \fB\-\-asynch\fR Allow answers to be reordered .SS "answer/error output format and destination (see below):" .TP \fB\-Fs\fR \fB\-\-fmt\-simple\fR Answers to stdout, errors as messages to stderr (default) .TP \fB\-Fi\fR \fB\-\-fmt\-inline\fR Answers and errors both to stdout in parseable format .TP \fB\-Fa\fR \fB\-\-fmt\-asynch\fR Fully\-parseable output format (default for \fB\-\-asynch\fR) .SS "global verbosity level:" .TP \fB\-Vq\fR \fB\-\-quiet\fR Do not print anything to stderr .TP \fB\-Vn\fR \fB\-\-no\-quiet\fR Report unexpected kinds of problem only (default) .TP \fB\-Vd\fR \fB\-\-debug\fR Debugging mode .TP \fB\-\-no\-checkc\fR Do not do for\-developer consistency checks .TP \fB\-\-checkc\fR Do for\-developer consistency checks .TP \fB\-\-checkc\-freq\fR Do for\-developer consistency checks very often .SS "other global options:" .TP \fB\-\-config\fR <> Configuration to use instead of \fI\,/etc/resolv.conf\/\fP .TP \fB\-\-version\fR Print version number .TP \fB\-\-help\fR Print usage information .SS "per-query options:" .TP \fB\-t\fR / \fB\-\-type\fR Query type (see below) .TP \fB\-i\fR / \fB\-\-ptr\fR Do reverse query (address \-> name lookup) .TP \fB\-\-reverse\fR Lookup in in\-addr\-like `zone' (eg MAPS RBL) .SS "per-query binary options:" .TP \fB\-s\fR \fB\-\-search\fR Use the search list .TP \fB\-Qq\fR \fB\-\-qc\-query\fR Let query domains contain quote\-requiring chars .TP \fB\-Qa\fR \fB\-\-qc\-anshost\fR Let hostnames in answers contain ... .TP +Qc \fB\-\-no\-qc\-cname\fR Prevent CNAME target domains from containing ... .TP \fB\-u\fR \fB\-\-tcp\fR Force use of a virtual circuit .TP +Do \fB\-\-no\-show\-owner\fR Do not display owner name in output .TP +Dt \fB\-\-no\-show\-type\fR Do not display RR type in output .TP +Dc \fB\-\-no\-show\-cname\fR Do not display CNAME target in output .SS "per-query TTL mode (NB TTL is minimum across all info in reply):" .TP \fB\-Tt\fR \fB\-\-ttl\-ttl\fR Show the TTL as a TTL .TP \fB\-Ta\fR \fB\-\-ttl\-abs\fR Show the TTL as a time_t when the data might expire .TP \fB\-Tn\fR \fB\-\-no\-ttl\fR Do not show the TTL (default) .SS "per-query address family options (for `addr' etc.):" .TP \fB\-A4\fR \fB\-\-\-\-addr\-ipv4\-only\fR Only return IPv4 addresses .TP \fB\-A6\fR \fB\-\-\-\-addr\-ipv6\-only\fR Only return IPv6 addresses .TP \fB\-Aa\fR \fB\-\-\-\-addr\-all\fR Return all available addresses (default) .TP \fB\-Am\fR \fB\-\-\-\-addr\-ipv6\-mapped\fR Return IPv4 addresses as IPv6\-mapped .SS "per-query CNAME handling mode:" .TP \fB\-Cf\fR \fB\-\-cname\-reject\fR Call it an error if a CNAME is found .TP \fB\-Cl\fR \fB\-\-cname\-loose\fR Allow references to CNAMEs in other RRs .TP \fB\-Cs\fR \fB\-\-cname\-ok\fR CNAME ok for query domain, but not in RRs (default) .SS "asynchronous/pipe mode options:" .TP \fB\-\-asynch\-id\fR Set , default is decimal sequence starting 0 .TP \fB\-\-cancel\-id\fR Cancel the query with id (no error if not found) .SS "Escaping domains which might start with `-':" .TP \- Next argument is a domain, but more options may follow .PP Query domains should always be quoted according to master file format. .PP For binary options, \fB\-\-FOO\fR and \fB\-\-no\-FOO\fR are opposites, as are \fB\-X\fR and +X. In each case the default is the one not listed. Per query options stay set a particular way until they are reset, whether they appear on the command line or on stdin. All global options must preceed the first query domain. .PP With \fB\-f\fR, the input should be lines with either an option, possibly with a value argument (separated from the option by a space if it's a long option), or a domain (possibly preceded by a hyphen and a space to distinguish it from an option). .SS "Output format is master file format without class or TTL by default:" .IP [] [] [] .PP or if the domain refers to a CNAME and \fB\-\-show\-cname\fR is on .IP [] [] CNAME [] [] .PP When a query fails you get an error message to stderr (with \fB\-\-fmt\-simple\fR). Specify \fB\-\-fmt\-inline\fR for lines like this (broken here for readability): .IP ; failed \e .IP [] [] [] "" .PP If you use \fB\-\-fmt\-asynch\fR, which is the default for \fB\-\-asynch\fR, each answer (success or failure) is preceded by a line .IP \e .IP [] [] [] "" .PP where is the number of RRs that follow and will be `$' or the CNAME target; the CNAME indirection and error formats above are not used. .SS "Exit status:" .TP 0 all went well .TP 1\-6 at least one query failed with statustype: .TP 1 localfail ) .TP 2 remotefail ) temporary errors .TP 3 tempfail __)_________________ .TP 4 misconfig ) .TP 5 misquery ) permanent errors .TP 6 permfail ) .TP 10 system trouble .TP 11 usage problems .SS "Query types (see adns.h; default is addr):" .TP ns soa ptr mx rp srv addr \- enhanced versions .TP cname hinfo txt \- types with only one version .TP a aaaa ns\- soa\- ptr\- mx\- rp\- srv\- \- _raw versions .TP type \- `unknown' type, RFC3597 .PP Default is addr, or ptr for \fB\-i\fR/\-\-ptr queries .SH COPYRIGHT Copyright \(co 1997\-2000,2003,2006,2014\-2016,2020 Ian Jackson .br Copyright \(co 2014 Mark Wooding .br Copyright \(co 1999\-2000,2003,2006 Tony Finch .br Copyright \(co 1991 Massachusetts Institute of Technology .br This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.