class Resolv

Resolv ist eine Thread-sichere DNS-Resolver-Bibliothek, die in Ruby geschrieben ist. Resolv kann mehrere DNS-Anfragen gleichzeitig bearbeiten, ohne den gesamten Ruby-Interpreter zu blockieren.

Siehe auch resolv-replace.rb, um den libc-Resolver durch Resolv zu ersetzen.

Resolv kann verschiedene DNS-Ressourcen direkt über das DNS-Modul nachschlagen.

Beispiele

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

Fehler

NIS wird nicht unterstützt.
/etc/nsswitch.conf wird nicht unterstützt.

Constants

AddressRegex: Address Regexp, die für den Abgleich von IP-Adressen verwendet wird.
DefaultResolver: Standard-Resolver, der für Resolv-Klassenmethoden verwendet wird.
VERSION: Die Versionszeichenfolge

Öffentliche Klassenmethoden

each_address (name, &block)

Source

# File lib/resolv.rb, line 57
def self.each_address(name, &block)
  DefaultResolver.each_address(name, &block)
end

Iteriert über alle IP-Adressen für name.

each_name (address, &proc)

Source

# File lib/resolv.rb, line 78
def self.each_name(address, &proc)
  DefaultResolver.each_name(address, &proc)
end

Iteriert über alle Hostnamen für address.

getaddress (name)

Source

# File lib/resolv.rb, line 43
def self.getaddress(name)
  DefaultResolver.getaddress(name)
end

Schlägt die erste IP-Adresse für name nach.

getaddresses (name)

Source

# File lib/resolv.rb, line 50
def self.getaddresses(name)
  DefaultResolver.getaddresses(name)
end

Schlägt alle IP-Adressen für name nach.

getname (address)

Source

# File lib/resolv.rb, line 64
def self.getname(address)
  DefaultResolver.getname(address)
end

Schlägt den Hostnamen von address nach.

getnames (address)

Source

# File lib/resolv.rb, line 71
def self.getnames(address)
  DefaultResolver.getnames(address)
end

Schlägt alle Hostnamen für address nach.

new (resolvers=(arg_not_set = true; nil), use_ipv6: (keyword_not_set = true; nil))

Source

# File lib/resolv.rb, line 89
def initialize(resolvers=(arg_not_set = true; nil), use_ipv6: (keyword_not_set = true; nil))
  if !keyword_not_set && !arg_not_set
    warn "Support for separate use_ipv6 keyword is deprecated, as it is ignored if an argument is provided. Do not provide a positional argument if using the use_ipv6 keyword argument.", uplevel: 1
  end

  @resolvers = case resolvers
  when Hash, nil
    [Hosts.new, DNS.new(DNS::Config.default_config_hash.merge(resolvers || {}))]
  else
    resolvers
  end
end

Erstellt eine neue Resolv-Instanz unter Verwendung von resolvers.

Wenn resolvers nicht angegeben, ein Hash oder nil ist, werden ein Hosts-Resolver und ein DNS-Resolver verwendet. Wenn resolvers ein Hash ist, wird der Hash als Konfiguration für den DNS-Resolver verwendet.

Öffentliche Instanzmethoden

each_address (name) { |name| ... }

Source

# File lib/resolv.rb, line 122
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

Iteriert über alle IP-Adressen für name.

each_name (address) { |name| ... }

Source

# File lib/resolv.rb, line 157
def each_name(address)
  yielded = false
  @resolvers.each {|r|
    r.each_name(address) {|name|
      yield name.to_s
      yielded = true
    }
    return if yielded
  }
end

Iteriert über alle Hostnamen für address.

getaddress (name)

Source

# File lib/resolv.rb, line 105
def getaddress(name)
  each_address(name) {|address| return address}
  raise ResolvError.new("no address for #{name}")
end

Schlägt die erste IP-Adresse für name nach.

getaddresses (name)

Source

# File lib/resolv.rb, line 113
def getaddresses(name)
  ret = []
  each_address(name) {|address| ret << address}
  return ret
end

Schlägt alle IP-Adressen für name nach.

getname (address)

Source

# File lib/resolv.rb, line 140
def getname(address)
  each_name(address) {|name| return name}
  raise ResolvError.new("no name for #{address}")
end

Schlägt den Hostnamen von address nach.

getnames (address)

Source

# File lib/resolv.rb, line 148
def getnames(address)
  ret = []
  each_name(address) {|name| ret << name}
  return ret
end

Schlägt alle Hostnamen für address nach.