Resolv::Hosts

Resolv::Hosts is a hostname resolver that uses the system hosts file.

Constants

DefaultFileName

The default file name for host names

Class Methods

new(filename = DefaultFileName)

          # File tmp/rubies/ruby-4.0.0/lib/resolv.rb, line 195
def initialize(filename = DefaultFileName)
  @filename = filename
  @mutex = Thread::Mutex.new
  @initialized = nil
end

Creates a new Resolv::Hosts, using filename for its data source.

Instance Methods

each_address(name, &proc)

lib/resolv.rb View on GitHub

          # File tmp/rubies/ruby-4.0.0/lib/resolv.rb, line 242
def each_address(name, &proc)
  lazy_initialize
  @name2addr[name]&.each(&proc)
end

Iterates over all IP addresses for name retrieved from the hosts file.

each_name(address, &proc)

lib/resolv.rb View on GitHub

          # File tmp/rubies/ruby-4.0.0/lib/resolv.rb, line 267
def each_name(address, &proc)
  lazy_initialize
  @addr2name[address]&.each(&proc)
end

Iterates over all hostnames for address retrieved from the hosts file.

getaddress(name)

lib/resolv.rb View on GitHub

          # File tmp/rubies/ruby-4.0.0/lib/resolv.rb, line 225
def getaddress(name)
  each_address(name) {|address| return address}
  raise ResolvError.new("#{@filename} has no name: #{name}")
end

Gets the IP address of name from the hosts file.

getaddresses(name)

lib/resolv.rb View on GitHub

          # File tmp/rubies/ruby-4.0.0/lib/resolv.rb, line 233
def getaddresses(name)
  ret = []
  each_address(name) {|address| ret << address}
  return ret
end

Gets all IP addresses for name from the hosts file.

getname(address)

lib/resolv.rb View on GitHub

          # File tmp/rubies/ruby-4.0.0/lib/resolv.rb, line 250
def getname(address)
  each_name(address) {|name| return name}
  raise ResolvError.new("#{@filename} has no address: #{address}")
end

Gets the hostname of address from the hosts file.

getnames(address)

lib/resolv.rb View on GitHub

          # File tmp/rubies/ruby-4.0.0/lib/resolv.rb, line 258
def getnames(address)
  ret = []
  each_name(address) {|name| ret << name}
  return ret
end

Gets all hostnames for address from the hosts file.