1 module Puppet::Parser::Functions
3 newfunction(:validate_ipv4_address, :doc => <<-ENDHEREDOC
4 Validate that all values passed are valid IPv4 addresses.
5 Fail compilation if any value fails this check.
7 The following values will pass:
10 validate_ipv4_address($my_ip)
11 validate_ipv4_address("8.8.8.8", "172.16.0.1", $my_ip)
13 The following values will fail, causing compilation to abort:
15 $some_array = [ 1, true, false, "garbage string", "3ffe:505:2" ]
16 validate_ipv4_address($some_array)
21 function_deprecation([:validate_ipv4_address, 'This method is deprecated, please use the stdlib validate_legacy function, with Stdlib::Compat::Ipv4. There is further documentation for validate_legacy function in the README.'])
24 rescuable_exceptions = [ ArgumentError ]
26 if defined?(IPAddr::InvalidAddressError)
27 rescuable_exceptions << IPAddr::InvalidAddressError
30 unless args.length > 0 then
31 raise Puppet::ParseError, ("validate_ipv4_address(): wrong number of arguments (#{args.length}; must be > 0)")
35 unless arg.is_a?(String)
36 raise Puppet::ParseError, "#{arg.inspect} is not a string."
40 unless IPAddr.new(arg).ipv4?
41 raise Puppet::ParseError, "#{arg.inspect} is not a valid IPv4 address."
43 rescue *rescuable_exceptions
44 raise Puppet::ParseError, "#{arg.inspect} is not a valid IPv4 address."