class Resolv::DNS
Resolv::DNS — это DNS — заглушка резолвера.
Информация взята из следующих источников:
-
STD0013
-
RFC 1035
-
и т. д.
Константы
Общедоступные методы класса
# 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)
# 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, в противном случае возвращает его.
Общедоступные методы экземпляра
# File lib/resolv.rb, line 372
def close
@mutex.synchronize {
if @initialized
@initialized = false
end
}
end Закрывает резолвер DNS.
# 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.
# 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.
# 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.
# 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 # 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.
# 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.
# 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.
# 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.
# 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::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, например Resolv::DNS::Resource::IN::A.
# 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.
# 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.