Module: NetAddr

Defined in:
lib/ipv4.rb,
lib/ipv6.rb,
lib/util.rb,
lib/eui48.rb,
lib/eui64.rb,
lib/mask32.rb,
lib/ipv4net.rb,
lib/ipv6net.rb,
lib/mask128.rb,
lib/netaddr.rb

Defined Under Namespace

Classes: EUI48, EUI64, IPv4, IPv4Net, IPv6, IPv6Net, Mask128, Mask32, Util, ValidationError

Constant Summary collapse

F32 =

32 bits worth of ‘1’

2**32-1
F128 =

128 bits worth of ‘1’

2**128-1

Class Method Summary collapse

Class Method Details

.ipv4_prefix_len(size) ⇒ Object

ipv4_prefix_len returns the prefix length needed to hold the number of IP addresses specified by “size”.



26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/netaddr.rb', line 26

def ipv4_prefix_len(size)
	prefix_len = 32
	32.downto(0) do |i|
		hostbits = 32 - prefix_len
		max = 1 << hostbits
		if (size <= max)
			break
		end
		prefix_len -= 1
	end
	return prefix_len
end

.parse_ip(ip) ⇒ Object

parse_ip parses a string into an IPv4 or IPv6



41
42
43
44
45
46
 
# File 'lib/netaddr.rb', line 41

def parse_ip(ip)
	if (ip.include?(":"))
		return IPv6.parse(ip)
	end
	return IPv4.parse(ip)
end

.parse_net(net) ⇒ Object

parse_net parses a string into an IPv4Net or IPv6Net



50
51
52
53
54
55
 
# File 'lib/netaddr.rb', line 50

def parse_net(net)
	if (net.include?(".")) # ipv4
		return IPv4Net.parse(net)
	end
	return IPv6Net.parse(net)
end

.sort_IPv4(list) ⇒ Object

sort_IPv4 sorts a list of IPv4 objects in ascending order. It will return a new list with any non IPv4 objects removed.



60
61
62
63
64
65
66
 
# File 'lib/netaddr.rb', line 60

def sort_IPv4(list)
	if ( !list.kind_of?(Array) )
		raise ArgumentError, "Expected an Array for 'list' but got a #{list.class}."
	end
	filtered = Util.filter_IPv4(list)
	return Util.quick_sort(filtered)
end

.sort_IPv4Net(list) ⇒ Object

sort_IPv4Net sorts a list of IPv4Net objects in ascending order. It will return a new list with any non IPv4Net objects removed.



82
83
84
85
86
87
88
 
# File 'lib/netaddr.rb', line 82

def sort_IPv4Net(list)
	if ( !list.kind_of?(Array) )
		raise ArgumentError, "Expected an Array for 'list' but got a #{list.class}."
	end
	filtered = Util.filter_IPv4Net(list)
	return Util.quick_sort(filtered)
end

.sort_IPv6(list) ⇒ Object

sort_IPv6 sorts a list of IPv6 objects in ascending order. It will return a new list with any non IPv6 objects removed.



71
72
73
74
75
76
77
 
# File 'lib/netaddr.rb', line 71

def sort_IPv6(list)
	if ( !list.kind_of?(Array) )
		raise ArgumentError, "Expected an Array for 'list' but got a #{list.class}."
	end
	filtered = Util.filter_IPv6(list)
	return Util.quick_sort(filtered)
end

.sort_IPv6Net(list) ⇒ Object

sort_IPv6Net sorts a list of IPv6Net objects in ascending order. It will return a new list with any non IPv6Net objects removed.



93
94
95
96
97
98
99
 
# File 'lib/netaddr.rb', line 93

def sort_IPv6Net(list)
	if ( !list.kind_of?(Array) )
		raise ArgumentError, "Expected an Array for 'list' but got a #{list.class}."
	end
	filtered = Util.filter_IPv6Net(list)
	return Util.quick_sort(filtered)
end

.summ_IPv4Net(list) ⇒ Object

summ_IPv4Net summarizes a list of IPv4Net objects as much as possible. It will return a new list with any non IPv4Net objects removed.



104
105
106
107
108
109
110
111
 
# File 'lib/netaddr.rb', line 104

def summ_IPv4Net(list)
	list = Util.filter_IPv4Net(list)
	if (list.length>1)
		list = Util.discard_subnets(list)
		return Util.summ_peers(list)
	end
	return [].concat(list)
end

.summ_IPv6Net(list) ⇒ Object

summ_IPv6Net summarizes a list of IPv6Net objects as much as possible. It will return a new list with any non IPv6Net objects removed.



116
117
118
119
120
121
122
123
 
# File 'lib/netaddr.rb', line 116

def summ_IPv6Net(list)
	list = Util.filter_IPv6Net(list)
	if (list.length>1)
		list = Util.discard_subnets(list)
		return Util.summ_peers(list)
	end
	return [].concat(list)
end