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.

143 lines
3.1KB

  1. % Generated by roxygen2: do not edit by hand
  2. % Please edit documentation in R/resolver.R
  3. \name{gdns_query}
  4. \alias{gdns_query}
  5. \title{Arbitrary DNS queries}
  6. \usage{
  7. gdns_query(
  8. gctx = NULL,
  9. name,
  10. rr_type = "txt",
  11. rr_class = 1L,
  12. include_reporting = FALSE
  13. )
  14. }
  15. \arguments{
  16. \item{gctx}{gdns resolver context created with \code{\link[=gdns_resolver]{gdns_resolver()}}. If \code{NULL} a
  17. temporary context will be created but is not ideal since there is overhead
  18. associated with context creation and garbage collection.}
  19. \item{name}{an entity to query for}
  20. \item{rr_type}{what resource record type do you want to queyr for? See \code{Details}.}
  21. \item{include_reporting}{if \code{TRUE} include debugging information for queries
  22. such as the length of time it takes for each query. Default: \code{FALSE}}
  23. }
  24. \description{
  25. Perform any valid resource record inquiry for a given name. See \code{Details}.
  26. }
  27. \details{
  28. This returns a fairly complex result object but that is the nature
  29. of DNS queries. You're likely going to want what is in \verb{$replies_tree$answer}
  30. but the rest of the structure contains lovely metadata about the query and
  31. remote query environment. There will eventually be "as data frame"-ish helpers
  32. for this object.
  33. Valid values for \code{rr_type}:
  34. \itemize{
  35. \item \code{a}
  36. \item \code{a6}
  37. \item \code{aaaa}
  38. \item \code{afsdb}
  39. \item \code{any}
  40. \item \code{apl}
  41. \item \code{atma}
  42. \item \code{avc}
  43. \item \code{axfr}
  44. \item \code{caa}
  45. \item \code{cdnskey}
  46. \item \code{cds}
  47. \item \code{cert}
  48. \item \code{cname}
  49. \item \code{csync}
  50. \item \code{dhcid}
  51. \item \code{dlv}
  52. \item \code{dname}
  53. \item \code{dnskey}
  54. \item \code{doa}
  55. \item \code{ds}
  56. \item \code{eid}
  57. \item \code{eui48}
  58. \item \code{eui64}
  59. \item \code{gid}
  60. \item \code{gpos}
  61. \item \code{hinfo}
  62. \item \code{hip}
  63. \item \code{ipseckey}
  64. \item \code{isdn}
  65. \item \code{ixfr}
  66. \item \code{key}
  67. \item \code{kx}
  68. \item \code{l32}
  69. \item \code{l64}
  70. \item \code{loc}
  71. \item \code{lp}
  72. \item \code{maila}
  73. \item \code{mailb}
  74. \item \code{mb}
  75. \item \code{md}
  76. \item \code{mf}
  77. \item \code{mg}
  78. \item \code{minfo}
  79. \item \code{mr}
  80. \item \code{mx}
  81. \item \code{naptr}
  82. \item \code{nid}
  83. \item \code{nimloc}
  84. \item \code{ninfo}
  85. \item \code{ns}
  86. \item \code{nsap}
  87. \item \code{nsap_ptr}
  88. \item \code{nsec}
  89. \item \code{nsec3}
  90. \item \code{nsec3param}
  91. \item \code{null}
  92. \item \code{nxt}
  93. \item \code{openpgpkey}
  94. \item \code{opt}
  95. \item \code{ptr}
  96. \item \code{px}
  97. \item \code{rkey}
  98. \item \code{rp}
  99. \item \code{rrsig}
  100. \item \code{rt}
  101. \item \code{sig}
  102. \item \code{sink}
  103. \item \code{smimea}
  104. \item \code{soa}
  105. \item \code{spf}
  106. \item \code{srv}
  107. \item \code{sshfp}
  108. \item \code{ta}
  109. \item \code{talink}
  110. \item \code{tkey}
  111. \item \code{tlsa}
  112. \item \code{tsig}
  113. \item \code{txt}
  114. \item \code{uid}
  115. \item \code{uinfo}
  116. \item \code{unspec}
  117. \item \code{uri}
  118. \item \code{wks}
  119. \item \code{x25}
  120. \item \code{zonemd}
  121. }
  122. }
  123. \note{
  124. Local hosts files are ignored when using this \code{getdns} API endpoint
  125. }
  126. \examples{
  127. x <- gdns_resolver()
  128. gdns_query(x, "example.com")
  129. }
  130. \references{
  131. \url{https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml}
  132. }
  133. \seealso{
  134. Other query functions:
  135. \code{\link{gdns_context}()},
  136. \code{\link{gdns_get_address}()}
  137. }
  138. \concept{query functions}