Spec-Zone.ru › Ruby 2.7

class Resolv

Parent:
Object

Resolv — это библиотека резолвера DNS, учитывающая потоки, написанная на Ruby. Resolv может обрабатывать несколько запросов DNS одновременно, не блокируя весь интерпретатор Ruby.

См. также resolv-replace.rb для замены резолвера libc на Resolv.

Resolv может искать различные ресурсы DNS с помощью модуля DNS напрямую.

Примеры:

p Resolv.getaddress "www.ruby-lang.org"
p Resolv.getname "210.251.121.214"

Resolv::DNS.open do |dns|
  ress = dns.getresources "www.ruby-lang.org", Resolv::DNS::Resource::IN::A
  p ress.map(&:address)
  ress = dns.getresources "ruby-lang.org", Resolv::DNS::Resource::IN::MX
  p ress.map { |r| [r.exchange.to_s, r.preference] }
end

Ошибки

  • NIS не поддерживается.

  • /etc/nsswitch.conf не поддерживается.

Константы

AddressRegex

Адресный Regexp для соответствия IP-адресам.

DefaultResolver

Резолвер по умолчанию для использования методов класса Resolv.

Публичные методы класса

each_address(name, &block) Показать исходный код
# File lib/resolv.rb, line 57
def self.each_address(name, &block)
  DefaultResolver.each_address(name, &block)
end

Перебирает все IP-адреса для name.

each_name(address, &proc) Показать исходный код
# File lib/resolv.rb, line 78
def self.each_name(address, &proc)
  DefaultResolver.each_name(address, &proc)
end

Перебирает все имена хостов для address.

getaddress(name) Показать исходный код
# File lib/resolv.rb, line 43
def self.getaddress(name)
  DefaultResolver.getaddress(name)
end

Ищет первый IP-адрес для name.

getaddresses(name) Показать исходный код
# File lib/resolv.rb, line 50
def self.getaddresses(name)
  DefaultResolver.getaddresses(name)
end

Ищет все IP-адреса для name.

getname(address) Показать исходный код
# File lib/resolv.rb, line 64
def self.getname(address)
  DefaultResolver.getname(address)
end

Ищет имя хоста для address.

getnames(address) Показать исходный код
# File lib/resolv.rb, line 71
def self.getnames(address)
  DefaultResolver.getnames(address)
end

Ищет все имена хостов для address.

new(resolvers=[Hosts.new, DNS.new]) Показать исходный код
# File lib/resolv.rb, line 85
def initialize(resolvers=[Hosts.new, DNS.new])
  @resolvers = resolvers
end

Создаёт новый Resolv с использованием resolvers.

Публичные методы экземпляра

each_address(name) { |name| ... } Показать исходный код
# File lib/resolv.rb, line 109
def each_address(name)
  if AddressRegex =~ name
    yield name
    return
  end
  yielded = false
  @resolvers.each {|r|
    r.each_address(name) {|address|
      yield address.to_s
      yielded = true
    }
    return if yielded
  }
end

Перебирает все IP-адреса для name.

each_name(address) { |name| ... } Показать исходный код
# File lib/resolv.rb, line 144
def each_name(address)
  yielded = false
  @resolvers.each {|r|
    r.each_name(address) {|name|
      yield name.to_s
      yielded = true
    }
    return if yielded
  }
end

Перебирает все имена хостов для address.

getaddress(name) Показать исходный код
# File lib/resolv.rb, line 92
def getaddress(name)
  each_address(name) {|address| return address}
  raise ResolvError.new("no address for #{name}")
end

Ищет первый IP-адрес для name.

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

Ищет все IP-адреса для name.

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

Ищет имя хоста для address.

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

Ищет все имена хостов для address.

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

Spec-Zone.ru

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