Class: Middleman::DnsResolver

Inherits:
Object
  • Object
show all
Defined in:
middleman-core/lib/middleman-core/dns_resolver.rb,
middleman-core/lib/middleman-core/dns_resolver/hosts_resolver.rb,
middleman-core/lib/middleman-core/dns_resolver/network_resolver.rb,
middleman-core/lib/middleman-core/dns_resolver/local_link_resolver.rb,
middleman-core/lib/middleman-core/dns_resolver/basic_network_resolver.rb

Overview

This resolves IP address to names and vice versa

Defined Under Namespace

Classes: BasicNetworkResolver, HostsResolver, LocalLinkResolver, NetworkResolver

Instance Method Summary collapse

Constructor Details

#initialize(options_hash = ::Middleman::EMPTY_HASH) ⇒ DnsResolver

Create resolver

First the local resolver is used. If environment variable HOSTSRC is given this file is used for local name lookup.

First the local resolver is queried. If this raises an error or returns nil or [] the network resolver is queried.

Parameters:

  • network_resolver (#getnames, #getaddresses) —

    The resolver which uses a network name server to resolve ip addresses and names.

  • local_resolver (#getnames, #getaddresses) —

    The resolver uses /etc/hosts on POSIX-systems and C:\Windows\System32\drivers\etc\hosts on Windows-operating systems to resolve ip addresses and names.


33
34
35
36
37
38
39
40
41
42
43
 
# File 'middleman-core/lib/middleman-core/dns_resolver.rb', line 33

def initialize(options_hash = ::Middleman::EMPTY_HASH)
  @resolvers = []
  @resolvers << options_hash.fetch(:hosts_resolver, HostsResolver.new)

  if RUBY_VERSION >= '2.1'
    require 'middleman-core/dns_resolver/local_link_resolver'
    @resolvers << options_hash.fetch(:local_link_resolver, LocalLinkResolver.new)
  end

  @resolvers << options_hash.fetch(:network_resolver, NetworkResolver.new)
end

Instance Method Details

#ips_for(name) ⇒ Object

Get ips for given name

First the local resolver is used. On POSIX-systems /etc/hosts is used. On Windows C:\Windows\System32\drivers\etc\hosts is used.

Parameters:

  • name (String) —

    The name which should be resolved.


66
67
68
69
70
71
72
73
74
 
# File 'middleman-core/lib/middleman-core/dns_resolver.rb', line 66

def ips_for(name)
  resolvers.each do |r|
    ips = r.getaddresses(name)

    return ips unless ips.nil? || ips.empty?
  end

  []
end

#names_for(ip) ⇒ Object

Get names for given ip

Parameters:

  • ip (String) —

    The ip which should be resolved.


49
50
51
52
53
54
55
56
57
 
# File 'middleman-core/lib/middleman-core/dns_resolver.rb', line 49

def names_for(ip)
  resolvers.each do |r|
    names = r.getnames(ip)

    return names unless names.nil? || names.empty?
  end

  []
end