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.

51 lines
1.9KB

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