Class: Resolv

Inherits:

Object

• Object
• Resolv

show all

Defined in:

lib/resolv.rb

Overview

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

Defined Under Namespace

Classes: DNS, Hosts, IPv4, IPv6, ResolvError, ResolvTimeout

Constant Summary

DefaultResolver =

Default resolver to use for Resolv class methods.

self.new

AddressRegex =

Address Regexp to use for matching IP addresses.

/(?:#{IPv4::Regex})|(?:#{IPv6::Regex})/

Class Method Summary (collapse)

• + (Object) each_address(name, &block)

  Iterates over all IP addresses for name.

• + (Object) each_name(address, &proc)

  Iterates over all hostnames for address.

• + (Object) getaddress(name)

  Looks up the first IP address for name.

• + (Object) getaddresses(name)

  Looks up all IP address for name.

• + (Object) getname(address)

  Looks up the hostname of address.

• + (Object) getnames(address)

  Looks up all hostnames for address.

Instance Method Summary (collapse)

• - (Object) each_address(name)

  Iterates over all IP addresses for name.

• - (Object) each_name(address)

  Iterates over all hostnames for address.

• - (Object) getaddress(name)

  Looks up the first IP address for name.

• - (Object) getaddresses(name)

  Looks up all IP address for name.

• - (Object) getname(address)

  Looks up the hostname of address.

• - (Object) getnames(address)

  Looks up all hostnames for address.

• - (Resolv) initialize(resolvers = [Hosts.new, DNS.new]) constructor

  Creates a new Resolv using resolvers.

84
85
86

# File 'lib/resolv.rb', line 84

def initialize(resolvers=[Hosts.new, DNS.new])
  @resolvers = resolvers
end

56
57
58

# File 'lib/resolv.rb', line 56

def self.each_address(name, &block)
  DefaultResolver.each_address(name, &block)
end

77
78
79

# File 'lib/resolv.rb', line 77

def self.each_name(address, &proc)
  DefaultResolver.each_name(address, &proc)
end

42
43
44

# File 'lib/resolv.rb', line 42

def self.getaddress(name)
  DefaultResolver.getaddress(name)
end

49
50
51

# File 'lib/resolv.rb', line 49

def self.getaddresses(name)
  DefaultResolver.getaddresses(name)
end

63
64
65

# File 'lib/resolv.rb', line 63

def self.getname(address)
  DefaultResolver.getname(address)
end

70
71
72

# File 'lib/resolv.rb', line 70

def self.getnames(address)
  DefaultResolver.getnames(address)
end

108
109
110
111
112
113
114
115
116
117
118
119
120
121

# File 'lib/resolv.rb', line 108

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

143
144
145
146
147
148
149
150
151
152

# File 'lib/resolv.rb', line 143

def each_name(address)
  yielded = false
  @resolvers.each {|r|
    r.each_name(address) {|name|
      yield name.to_s
      yielded = true
    }
    return if yielded
  }
end

91
92
93
94

# File 'lib/resolv.rb', line 91

def getaddress(name)
  each_address(name) {|address| return address}
  raise ResolvError.new("no address for #{name}")
end

99
100
101
102
103

# File 'lib/resolv.rb', line 99

def getaddresses(name)
  ret = []
  each_address(name) {|address| ret << address}
  return ret
end

126
127
128
129

# File 'lib/resolv.rb', line 126

def getname(address)
  each_name(address) {|name| return name}
  raise ResolvError.new("no name for #{address}")
end

134
135
136
137
138

# File 'lib/resolv.rb', line 134

def getnames(address)
  ret = []
  each_name(address) {|name| ret << name}
  return ret
end