Tools to work with the Google DNS over HTTPS API in R https://cinc.rud.is/web/packages/gdns/
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.

44 lines
1.7KB

  1. % Generated by roxygen2: do not edit by hand
  2. % Please edit documentation in R/zbulk-query.R
  3. \name{bulk_query}
  4. \alias{bulk_query}
  5. \title{Vectorized query, returning only answers in a data frame}
  6. \usage{
  7. bulk_query(entities, type = 1, edns_client_subnet = "0.0.0.0/0")
  8. }
  9. \arguments{
  10. \item{entities}{character vector of entities to query}
  11. \item{type}{RR type can be represented as a number in [1, 65535] or canonical
  12. string (A, aaaa, etc). More information on RR types can be
  13. found \href{http://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4}{here}.}
  14. \item{edns_client_subnet}{The edns0-client-subnet option. Format is an IP
  15. address with a subnet mask. Examples: \code{1.2.3.4/24},
  16. \code{2001:700:300::/48}.\cr
  17. If you are using DNS-over-HTTPS because of privacy concerns, and do
  18. not want any part of your IP address to be sent to authoritative
  19. nameservers for geographic location accuracy, use
  20. \code{edns_client_subnet=0.0.0.0/0}. Google Public DNS normally sends
  21. approximate network information (usually replacing the last part of
  22. your IPv4 address with zeroes). \code{0.0.0.0/0} is the default.}
  23. }
  24. \value{
  25. \code{data.frame} of only answers (use \code{query()} for detailed responses)
  26. }
  27. \description{
  28. Vectorized query, returning only answers in a data frame
  29. }
  30. \note{
  31. this is a fairly naive function. It expects \code{Answer} to be one of the
  32. return value list slots. The intent for it was to make it easier
  33. to do bulk forward queries. It will get smarter in future versions.
  34. }
  35. \examples{
  36. hosts <- c("rud.is", "r-project.org", "rstudio.com", "apple.com")
  37. gdns::bulk_query(hosts)
  38. }
  39. \references{
  40. \url{https://developers.google.com/speed/public-dns/docs/dns-over-https}
  41. }