Class: Resolv
Relationships & Source Files | |
Namespace Children | |
Modules:
| |
Classes:
| |
Exceptions:
| |
Inherits: | Object |
Defined in: | lib/resolv.rb |
Overview
Resolv
is a thread-aware DNS resolver library written in Ruby. Resolv
can handle multiple DNS requests concurrently without blocking the entire Ruby interpreter.
See also resolv-replace.rb to replace the libc resolver with Resolv
.
Resolv
can look up various DNS resources using the DNS module directly.
Examples:
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 { |r| r.address }
ress = dns.getresources "ruby-lang.org", Resolv::DNS::Resource::IN::MX
p ress.map { |r| [r.exchange.to_s, r.preference] }
end
Bugs
-
NIS is not supported.
-
/etc/nsswitch.conf is not supported.
Constant Summary
-
AddressRegex =
Address Regexp to use for matching IP addresses.
/(?:#{IPv4::Regex})|(?:#{IPv6::Regex})/
-
DefaultResolver =
Default resolver to use for
Resolv
class methods.self.new
Class Method Summary
-
.each_address(name, &block)
Iterates over all IP addresses for
name
. -
.each_name(address, &proc)
Iterates over all hostnames for
address
. -
.getaddress(name)
Looks up the first IP address for
name
. -
.getaddresses(name)
Looks up all IP address for
name
. -
.getname(address)
Looks up the hostname of
address
. -
.getnames(address)
Looks up all hostnames for
address
. -
.new(resolvers = [Hosts.new, DNS.new]) ⇒ Resolv
constructor
Creates a new
Resolv
usingresolvers
.
Instance Method Summary
-
#each_address(name)
Iterates over all IP addresses for
name
. -
#each_name(address)
Iterates over all hostnames for
address
. -
#getaddress(name)
Looks up the first IP address for
name
. -
#getaddresses(name)
Looks up all IP address for
name
. -
#getname(address)
Looks up the hostname of
address
. -
#getnames(address)
Looks up all hostnames for
address
.
Constructor Details
.new(resolvers = [Hosts.new, DNS.new]) ⇒ Resolv
Creates a new Resolv
using resolvers
.
Class Method Details
.each_address(name, &block)
Iterates over all IP addresses for name
.
# File 'lib/resolv.rb', line 58
def self.each_address(name, &block) DefaultResolver.each_address(name, &block) end
.each_name(address, &proc)
Iterates over all hostnames for address
.
# File 'lib/resolv.rb', line 79
def self.each_name(address, &proc) DefaultResolver.each_name(address, &proc) end
.getaddress(name)
Looks up the first IP address for name
.
# File 'lib/resolv.rb', line 44
def self.getaddress(name) DefaultResolver.getaddress(name) end
.getaddresses(name)
Looks up all IP address for name
.
# File 'lib/resolv.rb', line 51
def self.getaddresses(name) DefaultResolver.getaddresses(name) end
.getname(address)
Looks up the hostname of address
.
# File 'lib/resolv.rb', line 65
def self.getname(address) DefaultResolver.getname(address) end
.getnames(address)
Looks up all hostnames for address
.
# File 'lib/resolv.rb', line 72
def self.getnames(address) DefaultResolver.getnames(address) end
Instance Method Details
#each_address(name)
Iterates over all IP addresses for name
.
# File 'lib/resolv.rb', line 110
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
#each_name(address)
Iterates over all hostnames for address
.
# File 'lib/resolv.rb', line 145
def each_name(address) yielded = false @resolvers.each {|r| r.each_name(address) {|name| yield name.to_s yielded = true } return if yielded } end
#getaddress(name)
Looks up the first IP address for name
.
# File 'lib/resolv.rb', line 93
def getaddress(name) each_address(name) {|address| return address} raise ResolvError.new("no address for #{name}") end
#getaddresses(name)
Looks up all IP address for name
.
# File 'lib/resolv.rb', line 101
def getaddresses(name) ret = [] each_address(name) {|address| ret << address} return ret end
#getname(address)
Looks up the hostname of address
.
# File 'lib/resolv.rb', line 128
def getname(address) each_name(address) {|name| return name} raise ResolvError.new("no name for #{address}") end
#getnames(address)
Looks up all hostnames for address
.
# File 'lib/resolv.rb', line 136
def getnames(address) ret = [] each_name(address) {|name| ret << name} return ret end