Puppet Function: dnsquery::rlookup

Defined in:
vendor_modules/dnsquery/lib/puppet/functions/dnsquery/rlookup.rb
Function type:
Ruby 4.x API

Overview

dnsquery::rlookup(Stdlib::IP::Address::Nosubnet $address, Optional[Optional[Dnsquery::Config_info]] $config_info, Optional[Callable] &$block) ⇒ Array[Stdlib::Fqdn]

Retrieves results from DNS reverse lookup and returns it as an array.

Parameters:

  • address (Stdlib::IP::Address::Nosubnet) —

    the ip address to lookup

  • config_info (Optional[Optional[Dnsquery::Config_info]]) —

    used to override the config for Resolve::DNS.new

  • &block (Optional[Callable]) —

    an optional lambda to return a default value in case the lookup fails

Returns:

  • (Array[Stdlib::Fqdn]) —

    An array of hostnames matching the ip address



6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'vendor_modules/dnsquery/lib/puppet/functions/dnsquery/rlookup.rb', line 6

Puppet::Functions.create_function(:'dnsquery::rlookup') do
  # @param address the ip address to lookup
  # @param config_info used to override the config for Resolve::DNS.new
  # @param block an optional lambda to return a default value in case the lookup fails
  # @return An array of hostnames matching the ip address
  dispatch :dns_rlookup do
    param 'Stdlib::IP::Address::Nosubnet', :address
    optional_param 'Optional[Dnsquery::Config_info]', :config_info
    optional_block_param :block
    return_type 'Array[Stdlib::Fqdn]'
  end

  def dns_rlookup(address, config_info = nil)
    resolver = PuppetX::Voxpupuli::Dnsquery::Utils.resolver(config_info)
    addr = IPAddr.new(address)
    ret = resolver.getresources(
      addr.reverse, Resolv::DNS::Resource::IN::PTR
    ).map do |res|
      res.name.to_s
    end
    block_given? && ret.empty? ? yield : ret
  rescue Resolv::ResolvError
    block_given? ? yield : raise
  end
end