Vous ne pouvez pas sélectionner plus de 25 sujets
Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.
142 lignes
3.1 KiB
142 lignes
3.1 KiB
% Generated by roxygen2: do not edit by hand
|
|
% Please edit documentation in R/resolver.R
|
|
\name{gdns_query}
|
|
\alias{gdns_query}
|
|
\title{Arbitrary DNS queries}
|
|
\usage{
|
|
gdns_query(
|
|
gctx = NULL,
|
|
name,
|
|
rr_type = "txt",
|
|
rr_class = 1L,
|
|
include_reporting = FALSE
|
|
)
|
|
}
|
|
\arguments{
|
|
\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}}
|
|
}
|
|
\description{
|
|
Perform any valid resource record inquiry for a given name. See \code{Details}.
|
|
}
|
|
\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}:
|
|
\itemize{
|
|
\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}
|
|
}
|
|
}
|
|
\note{
|
|
Local hosts files are ignored when using this \code{getdns} API endpoint
|
|
}
|
|
\examples{
|
|
x <- gdns_resolver()
|
|
gdns_query(x, "example.com")
|
|
}
|
|
\references{
|
|
\url{https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml}
|
|
}
|
|
\seealso{
|
|
Other query functions:
|
|
\code{\link{gdns_context}()},
|
|
\code{\link{gdns_get_address}()}
|
|
}
|
|
\concept{query functions}
|
|
|