Spec-Zone.ru › Ruby 3.4
  1. Resolv::
  2. DNS

class Resolv::DNS

Родительский класс:
Object

Resolv::DNS — это DNS — заглушка резолвера.

Информация взята из следующих источников:

  • STD0013

  • RFC 1035

  • ftp.isi.edu/in-notes/iana/assignments/dns-parameters

  • и т. д.

Константы

Port

Порт DNS Port по умолчанию

UDPSize

Размер UDP-пакета DNS по умолчанию

Общедоступные методы класса

new (config_info=nil) Показать исходный код
# File lib/resolv.rb, line 338
def initialize(config_info=nil)
  @mutex = Thread::Mutex.new
  @config = Config.new(config_info)
  @initialized = nil
end

Создает новый резолвер DNS.

В качестве config_info можно указать:

nil

Использует /etc/resolv.conf.

String

Путь к файлу в формате /etc/resolv.conf.

Hash

Должен содержать ключи :nameserver, :search и :ndots.

Параметр :nameserver_port можно использовать, чтобы указать номер порта адреса сервера имен. Параметр :raise_timeout_errors позволяет вызывать ошибки тайм-аута как исключения, вместо того чтобы обрабатывать их так же, как ответ NXDOMAIN.

Значением :nameserver должна быть строка с адресом или массив строк с адресами.

  • :nameserver => ‘8.8.8.8’

  • :nameserver => [‘8.8.8.8’, ‘8.8.4.4’]

Значением :nameserver_port должен быть массив пар, состоящих из адреса сервера имен и номера порта.

  • :nameserver_port => [[‘8.8.8.8’, 53], [‘8.8.4.4’, 53]]

Пример:

Resolv::DNS.new(:nameserver => ['210.251.121.21'],
                :search => ['ruby-lang.org'],
                :ndots => 1)
open (*args) { |dns| ... } Показать исходный код
# File lib/resolv.rb, line 301
def self.open(*args)
  dns = new(*args)
  return dns unless block_given?
  begin
    yield dns
  ensure
    dns.close
  end
end

Создает новый резолвер DNS. Описание аргументов см. в Resolv::DNS.new.

Если блок задан, передает ему созданный резолвер DNS, в противном случае возвращает его.

Общедоступные методы экземпляра

close () Показать исходный код
# File lib/resolv.rb, line 372
def close
  @mutex.synchronize {
    if @initialized
      @initialized = false
    end
  }
end

Закрывает резолвер DNS.

each_address (name) { |address| ... } Показать исходный код
# File lib/resolv.rb, line 410
def each_address(name)
  if use_ipv6?
    each_resource(name, Resource::IN::AAAA) {|resource| yield resource.address}
  end
  each_resource(name, Resource::IN::A) {|resource| yield resource.address}
end

Перебирает все IP-адреса для name, полученные от резолвера DNS.

name может быть объектом Resolv::DNS::Name или String. Полученные адреса будут объектами Resolv::IPv4 или Resolv::IPv6.

each_name (address) { |name| ... } Показать исходный код
# File lib/resolv.rb, line 464
def each_name(address)
  case address
  when Name
    ptr = address
  when IPv4, IPv6
    ptr = address.to_name
  when IPv4::Regex
    ptr = IPv4.create(address).to_name
  when IPv6::Regex
    ptr = IPv6.create(address).to_name
  else
    raise ResolvError.new("cannot interpret as address: #{address}")
  end
  each_resource(ptr, Resource::IN::PTR) {|resource| yield resource.name}
end

Перебирает все имена хостов для address, полученные от резолвера DNS.

address должен быть объектом Resolv::IPv4, Resolv::IPv6 или String. Полученные имена будут экземплярами Resolv::DNS::Name.

each_resource (name, typeclass, &proc) Показать исходный код
# File lib/resolv.rb, line 522
def each_resource(name, typeclass, &proc)
  fetch_resource(name, typeclass) {|reply, reply_name|
    extract_resources(reply, reply_name, typeclass, &proc)
  }
end

Перебирает все ресурсы DNS типа typeclass для name. Описание аргументов см. в getresource.

fetch_resource (name, typeclass) { |reply, reply_name| ... } Показать исходный код
# File lib/resolv.rb, line 528
def fetch_resource(name, typeclass)
  lazy_initialize
  truncated = {}
  requesters = {}
  udp_requester = begin
    make_udp_requester
  rescue Errno::EACCES
    # fall back to TCP
  end
  senders = {}

  begin
    @config.resolv(name) do |candidate, tout, nameserver, port|
      msg = Message.new
      msg.rd = 1
      msg.add_question(candidate, typeclass)

      requester = requesters.fetch([nameserver, port]) do
        if !truncated[candidate] && udp_requester
          udp_requester
        else
          requesters[[nameserver, port]] = make_tcp_requester(nameserver, port)
        end
      end

      unless sender = senders[[candidate, requester, nameserver, port]]
        sender = requester.sender(msg, candidate, nameserver, port)
        next if !sender
        senders[[candidate, requester, nameserver, port]] = sender
      end
      reply, reply_name = requester.request(sender, tout)
      case reply.rcode
      when RCode::NoError
        if reply.tc == 1 and not Requester::TCP === requester
          # Retry via TCP:
          truncated[candidate] = true
          redo
        else
          yield(reply, reply_name)
        end
        return
      when RCode::NXDomain
        raise Config::NXDomain.new(reply_name.to_s)
      else
        raise Config::OtherResolvError.new(reply_name.to_s)
      end
    end
  ensure
    udp_requester&.close
    requesters.each_value { |requester| requester&.close }
  end
end
getaddress (name) Показать исходный код
# File lib/resolv.rb, line 386
def getaddress(name)
  each_address(name) {|address| return address}
  raise ResolvError.new("DNS result has no information for #{name}")
end

Получает IP-адрес для name от резолвера DNS.

name может быть объектом Resolv::DNS::Name или String. Полученный адрес будет объектом Resolv::IPv4 или Resolv::IPv6.

getaddresses (name) Показать исходный код
# File lib/resolv.rb, line 397
def getaddresses(name)
  ret = []
  each_address(name) {|address| ret << address}
  return ret
end

Получает все IP-адреса для name от резолвера DNS.

name может быть объектом Resolv::DNS::Name или String. Полученные адреса будут объектами Resolv::IPv4 или Resolv::IPv6.

getname (address) Показать исходный код
# File lib/resolv.rb, line 440
def getname(address)
  each_name(address) {|name| return name}
  raise ResolvError.new("DNS result has no information for #{address}")
end

Получает имя хоста для address от резолвера DNS.

address должен быть объектом Resolv::IPv4, Resolv::IPv6 или String. Полученное имя будет объектом Resolv::DNS::Name.

getnames (address) Показать исходный код
# File lib/resolv.rb, line 451
def getnames(address)
  ret = []
  each_name(address) {|name| ret << name}
  return ret
end

Получает все имена хостов для address от резолвера DNS.

address должен быть объектом Resolv::IPv4, Resolv::IPv6 или String. Полученные имена будут экземплярами Resolv::DNS::Name.

getresource (name, typeclass) Показать исходный код
# File lib/resolv.rb, line 503
def getresource(name, typeclass)
  each_resource(name, typeclass) {|resource| return resource}
  raise ResolvError.new("DNS result has no information for #{name}")
end

Выполняет поиск ресурса DNS типа typeclass для name.

name должен быть объектом Resolv::DNS::Name или String.

typeclass должен быть одним из следующих значений:

  • Resolv::DNS::Resource::IN::A

  • Resolv::DNS::Resource::IN::AAAA

  • Resolv::DNS::Resource::IN::ANY

  • Resolv::DNS::Resource::IN::CNAME

  • Resolv::DNS::Resource::IN::HINFO

  • Resolv::DNS::Resource::IN::MINFO

  • Resolv::DNS::Resource::IN::MX

  • Resolv::DNS::Resource::IN::NS

  • Resolv::DNS::Resource::IN::PTR

  • Resolv::DNS::Resource::IN::SOA

  • Resolv::DNS::Resource::IN::TXT

  • Resolv::DNS::Resource::IN::WKS

Возвращаемый ресурс представлен экземпляром Resolv::DNS::Resource, например Resolv::DNS::Resource::IN::A.

getresources (name, typeclass) Показать исходный код
# File lib/resolv.rb, line 512
def getresources(name, typeclass)
  ret = []
  each_resource(name, typeclass) {|resource| ret << resource}
  return ret
end

Выполняет поиск всех ресурсов DNS типа typeclass для name. Описание аргументов см. в getresource.

timeouts= (values) Показать исходный код
# File lib/resolv.rb, line 355
def timeouts=(values)
  @config.timeouts = values
end

Задает тайм-ауты резолвера. Это может быть одно положительное число или массив положительных чисел, задающих тайм-ауты в секундах. Если указан массив, запрос DNS будет повторяться с ожиданием каждого следующего интервала из массива, пока не будет получен успешный ответ. Указание nil возвращает тайм-ауты по умолчанию:

5, second = 5 * 2 / nameserver_count, 2 * second, 4 * second

Пример:

dns.timeouts = 3

Ruby Core © 1993–2025 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API