Perform Secure-by-default or Woefully Insecure ‘DNS’ Queries
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

142 lines
3.1 KiB

% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/resolver.R
\title{Arbitrary DNS queries}
gctx = NULL,
rr_type = "txt",
rr_class = 1L,
include_reporting = FALSE
\item{gctx}{gdns resolver context created with \code{\link[=gdns_resolver]{gdns_resolver()}}. If \code{NULL} a
temporary context will be created but is not ideal since there is overhead
associated with context creation and garbage collection.}
\item{name}{an entity to query for}
\item{rr_type}{what resource record type do you want to queyr for? See \code{Details}.}
\item{include_reporting}{if \code{TRUE} include debugging information for queries
such as the length of time it takes for each query. Default: \code{FALSE}}
Perform any valid resource record inquiry for a given name. See \code{Details}.
This returns a fairly complex result object but that is the nature
of DNS queries. You're likely going to want what is in \verb{$replies_tree$answer}
but the rest of the structure contains lovely metadata about the query and
remote query environment. There will eventually be "as data frame"-ish helpers
for this object.
Valid values for \code{rr_type}:
\item \code{a}
\item \code{a6}
\item \code{aaaa}
\item \code{afsdb}
\item \code{any}
\item \code{apl}
\item \code{atma}
\item \code{avc}
\item \code{axfr}
\item \code{caa}
\item \code{cdnskey}
\item \code{cds}
\item \code{cert}
\item \code{cname}
\item \code{csync}
\item \code{dhcid}
\item \code{dlv}
\item \code{dname}
\item \code{dnskey}
\item \code{doa}
\item \code{ds}
\item \code{eid}
\item \code{eui48}
\item \code{eui64}
\item \code{gid}
\item \code{gpos}
\item \code{hinfo}
\item \code{hip}
\item \code{ipseckey}
\item \code{isdn}
\item \code{ixfr}
\item \code{key}
\item \code{kx}
\item \code{l32}
\item \code{l64}
\item \code{loc}
\item \code{lp}
\item \code{maila}
\item \code{mailb}
\item \code{mb}
\item \code{md}
\item \code{mf}
\item \code{mg}
\item \code{minfo}
\item \code{mr}
\item \code{mx}
\item \code{naptr}
\item \code{nid}
\item \code{nimloc}
\item \code{ninfo}
\item \code{ns}
\item \code{nsap}
\item \code{nsap_ptr}
\item \code{nsec}
\item \code{nsec3}
\item \code{nsec3param}
\item \code{null}
\item \code{nxt}
\item \code{openpgpkey}
\item \code{opt}
\item \code{ptr}
\item \code{px}
\item \code{rkey}
\item \code{rp}
\item \code{rrsig}
\item \code{rt}
\item \code{sig}
\item \code{sink}
\item \code{smimea}
\item \code{soa}
\item \code{spf}
\item \code{srv}
\item \code{sshfp}
\item \code{ta}
\item \code{talink}
\item \code{tkey}
\item \code{tlsa}
\item \code{tsig}
\item \code{txt}
\item \code{uid}
\item \code{uinfo}
\item \code{unspec}
\item \code{uri}
\item \code{wks}
\item \code{x25}
\item \code{zonemd}
Local hosts files are ignored when using this \code{getdns} API endpoint
x <- gdns_resolver()
gdns_query(x, "")
Other query functions:
\concept{query functions}