8 use PVE
::Tools
qw(run_command lock_file);
14 use NetAddr
::IP
qw(:lower);
15 use POSIX
qw(ECONNREFUSED);
16 use Socket
qw(NI_NUMERICHOST NI_NUMERICSERV);
18 # host network related utility functions
20 our $PHYSICAL_NIC_RE = qr/(?:eth\d+|en[^:.]+|ib[^:.]+)/;
22 our $ipv4_reverse_mask = [
58 our $ipv4_mask_hash_localnet = {
68 '255.255.128.0' => 17,
69 '255.255.192.0' => 18,
70 '255.255.224.0' => 19,
71 '255.255.240.0' => 20,
72 '255.255.248.0' => 21,
73 '255.255.252.0' => 22,
74 '255.255.254.0' => 23,
75 '255.255.255.0' => 24,
76 '255.255.255.128' => 25,
77 '255.255.255.192' => 26,
78 '255.255.255.224' => 27,
79 '255.255.255.240' => 28,
80 '255.255.255.248' => 29,
81 '255.255.255.252' => 30,
82 '255.255.255.254' => 31,
83 '255.255.255.255' => 32,
86 sub setup_tc_rate_limit
{
87 my ($iface, $rate, $burst) = @_;
89 # these are allowed / expected to fail, e.g. when there is no previous rate limit to remove
90 eval { run_command
("/sbin/tc class del dev $iface parent 1: classid 1:1 >/dev/null 2>&1"); };
91 eval { run_command
("/sbin/tc filter del dev $iface parent ffff: protocol all pref 50 u32 >/dev/null 2>&1"); };
92 eval { run_command
("/sbin/tc qdisc del dev $iface ingress >/dev/null 2>&1"); };
93 eval { run_command
("/sbin/tc qdisc del dev $iface root >/dev/null 2>&1"); };
97 # tbf does not work for unknown reason
98 #$TC qdisc add dev $DEV root tbf rate $RATE latency 100ms burst $BURST
99 # so we use htb instead
100 run_command
("/sbin/tc qdisc add dev $iface root handle 1: htb default 1");
101 run_command
("/sbin/tc class add dev $iface parent 1: classid 1:1 " .
102 "htb rate ${rate}bps burst ${burst}b");
104 run_command
("/sbin/tc qdisc add dev $iface handle ffff: ingress");
105 run_command
("/sbin/tc filter add dev $iface parent ffff: " .
107 "police rate ${rate}bps burst ${burst}b mtu 64kb " .
112 my ($iface, $rate) = @_;
114 $rate = int($rate*1024*1024) if $rate;
115 my $burst = 1024*1024;
117 setup_tc_rate_limit
($iface, $rate, $burst);
120 sub read_bridge_mtu
{
123 my $mtu = PVE
::Tools
::file_read_firstline
("/sys/class/net/$bridge/mtu");
124 die "bridge '$bridge' does not exist\n" if !$mtu;
125 # avoid insecure dependency;
126 die "unable to parse mtu value" if $mtu !~ /^(\d+)$/;
132 my $parse_tap_device_name = sub {
133 my ($iface, $noerr) = @_;
137 if ($iface =~ m/^tap(\d+)i(\d+)$/) {
140 } elsif ($iface =~ m/^veth(\d+)i(\d+)$/) {
144 return undef if $noerr;
145 die "can't create firewall bridge for random interface name '$iface'\n";
148 return ($vmid, $devid);
151 my $compute_fwbr_names = sub {
152 my ($vmid, $devid) = @_;
154 my $fwbr = "fwbr${vmid}i${devid}";
155 # Note: the firewall use 'fwln+' to filter traffic to VMs
156 my $vethfw = "fwln${vmid}i${devid}";
157 my $vethfwpeer = "fwpr${vmid}p${devid}";
158 my $ovsintport = "fwln${vmid}o${devid}";
160 return ($fwbr, $vethfw, $vethfwpeer, $ovsintport);
163 sub iface_delete
($) {
165 run_command
(['/sbin/ip', 'link', 'delete', 'dev', $iface], noerr
=> 1)
166 == 0 or die "failed to delete interface '$iface'\n";
169 sub iface_create
($$@) {
170 my ($iface, $type, @args) = @_;
171 run_command
(['/sbin/ip', 'link', 'add', $iface, 'type', $type, @args], noerr
=> 1)
172 == 0 or die "failed to create interface '$iface'\n";
176 my ($iface, @opts) = @_;
177 run_command
(['/sbin/ip', 'link', 'set', $iface, @opts], noerr
=> 1)
178 == 0 or die "failed to set interface options for '$iface' (".join(' ', @opts).")\n";
181 # helper for nicer error messages:
182 sub iface_set_master
($$) {
183 my ($iface, $master) = @_;
184 if (defined($master)) {
185 eval { iface_set
($iface, 'master', $master) };
186 die "can't enslave '$iface' to '$master'\n" if $@;
188 eval { iface_set
($iface, 'nomaster') };
189 die "can't unenslave '$iface'\n" if $@;
193 my $cond_create_bridge = sub {
196 if (! -d
"/sys/class/net/$bridge") {
197 iface_create
($bridge, 'bridge');
198 disable_ipv6
($bridge);
204 return if !-d
'/proc/sys/net/ipv6'; # ipv6 might be completely disabled
205 my $file = "/proc/sys/net/ipv6/conf/$iface/disable_ipv6";
206 open(my $fh, '>', $file) or die "failed to open $file for writing: $!\n";
207 print {$fh} "1\n" or die "failed to disable link-local ipv6 for $iface\n";
211 my $bridge_disable_interface_learning = sub {
214 PVE
::ProcFSTools
::write_proc_entry
("/sys/class/net/$iface/brport/unicast_flood", "0");
215 PVE
::ProcFSTools
::write_proc_entry
("/sys/class/net/$iface/brport/learning", "0");
219 my $bridge_add_interface = sub {
220 my ($bridge, $iface, $tag, $trunks) = @_;
222 # drop link local address (it can't be used when on a bridge anyway)
223 disable_ipv6
($iface);
224 iface_set_master
($iface, $bridge);
226 my $vlan_aware = PVE
::Tools
::file_read_firstline
("/sys/class/net/$bridge/bridge/vlan_filtering");
230 eval { run_command
(['/sbin/bridge', 'vlan', 'del', 'dev', $iface, 'vid', '1-4094']) };
231 die "failed to remove default vlan tags of $iface - $@\n" if $@;
234 my @trunks_array = split /;/, $trunks;
235 foreach my $trunk (@trunks_array) {
236 eval { run_command
(['/sbin/bridge', 'vlan', 'add', 'dev', $iface, 'vid', $trunk]) };
237 die "unable to add vlan $trunk to interface $iface - $@\n" if $@;
240 eval { run_command
(['/sbin/bridge', 'vlan', 'add', 'dev', $iface, 'vid', '2-4094']) };
241 die "unable to add default vlan tags to interface $iface - $@\n" if $@;
245 eval { run_command
(['/sbin/bridge', 'vlan', 'add', 'dev', $iface, 'vid', $tag, 'pvid', 'untagged']) };
246 die "unable to add vlan $tag to interface $iface - $@\n" if $@;
250 my $ovs_bridge_add_port = sub {
251 my ($bridge, $iface, $tag, $internal, $trunks) = @_;
253 $trunks =~ s/;/,/g if $trunks;
255 my $cmd = ['/usr/bin/ovs-vsctl'];
257 push @$cmd, '--', 'add-port', $bridge, $iface;
258 push @$cmd, "tag=$tag" if $tag;
259 push @$cmd, "trunks=". join(',', $trunks) if $trunks;
260 push @$cmd, "vlan_mode=native-untagged" if $tag && $trunks;
264 push @$cmd, '--', 'set', 'Interface', $iface, 'type=internal';
267 eval { run_command
($cmd) };
268 die "can't add ovs port '$iface' - $@\n" if $@;
270 disable_ipv6
($iface);
273 my $activate_interface = sub {
276 eval { run_command
(['/sbin/ip', 'link', 'set', $iface, 'up']) };
277 die "can't activate interface '$iface' - $@\n" if $@;
281 my ($iface, $mac) = @_;
283 my $learning = PVE
::Tools
::file_read_firstline
("/sys/class/net/$iface/brport/learning");
286 my ($vmid, $devid) = &$parse_tap_device_name($iface, 1);
287 return if !defined($vmid);
289 PVE
::Tools
::run_command
(['/sbin/bridge', 'fdb', 'append', $mac, 'dev', $iface, 'master', 'static']);
291 my ($fwbr, $vethfw, $vethfwpeer, $ovsintport) = &$compute_fwbr_names($vmid, $devid);
293 if (-d
"/sys/class/net/$vethfwpeer") {
294 PVE
::Tools
::run_command
(['/sbin/bridge', 'fdb', 'append', $mac, 'dev', $vethfwpeer, 'master', 'static']);
300 my ($iface, $mac) = @_;
302 my $learning = PVE
::Tools
::file_read_firstline
("/sys/class/net/$iface/brport/learning");
305 my ($vmid, $devid) = &$parse_tap_device_name($iface, 1);
306 return if !defined($vmid);
308 PVE
::Tools
::run_command
(['/sbin/bridge', 'fdb', 'del', $mac, 'dev', $iface, 'master', 'static']);
310 my ($fwbr, $vethfw, $vethfwpeer, $ovsintport) = &$compute_fwbr_names($vmid, $devid);
312 if (-d
"/sys/class/net/$vethfwpeer") {
313 PVE
::Tools
::run_command
(['/sbin/bridge', 'fdb', 'del', $mac, 'dev', $vethfwpeer, 'master', 'static']);
318 my ($iface, $bridge) = @_;
320 die "unable to get bridge setting\n" if !$bridge;
322 my $bridgemtu = read_bridge_mtu
($bridge);
325 disable_ipv6
($iface);
326 PVE
::Tools
::run_command
(['/sbin/ip', 'link', 'set', $iface, 'up', 'promisc', 'on', 'mtu', $bridgemtu]);
328 die "interface activation failed\n" if $@;
332 my ($veth, $vethpeer, $bridge, $mac) = @_;
334 die "unable to get bridge setting\n" if !$bridge;
336 my $bridgemtu = read_bridge_mtu
($bridge);
339 if (! -d
"/sys/class/net/$veth") {
340 my $cmd = ['/sbin/ip', 'link', 'add'];
342 push @$cmd, 'name', $veth;
343 push @$cmd, 'mtu', $bridgemtu;
344 push @$cmd, 'type', 'veth';
346 push @$cmd, 'peer', 'name', $vethpeer, 'mtu', $bridgemtu;
348 push @$cmd, 'addr', $mac if $mac;
350 eval { run_command
($cmd) };
351 die "can't create interface $veth - $@\n" if $@;
356 disable_ipv6
($vethpeer);
357 &$activate_interface($veth);
358 &$activate_interface($vethpeer);
364 if (-d
"/sys/class/net/$veth") {
367 eval { tap_unplug
($veth) };
370 my $create_firewall_bridge_linux = sub {
371 my ($iface, $bridge, $tag, $trunks, $disablelearning) = @_;
373 my ($vmid, $devid) = &$parse_tap_device_name($iface);
374 my ($fwbr, $vethfw, $vethfwpeer) = &$compute_fwbr_names($vmid, $devid);
376 &$cond_create_bridge($fwbr);
377 &$activate_interface($fwbr);
379 copy_bridge_config
($bridge, $fwbr);
380 veth_create
($vethfw, $vethfwpeer, $bridge);
382 &$bridge_add_interface($bridge, $vethfwpeer, $tag, $trunks);
383 &$bridge_disable_interface_learning($vethfwpeer) if $disablelearning;
384 &$bridge_add_interface($fwbr, $vethfw);
386 &$bridge_add_interface($fwbr, $iface);
389 my $create_firewall_bridge_ovs = sub {
390 my ($iface, $bridge, $tag, $trunks, $disablelearning) = @_;
392 my ($vmid, $devid) = &$parse_tap_device_name($iface);
393 my ($fwbr, undef, undef, $ovsintport) = &$compute_fwbr_names($vmid, $devid);
395 my $bridgemtu = read_bridge_mtu
($bridge);
397 &$cond_create_bridge($fwbr);
398 &$activate_interface($fwbr);
400 &$bridge_add_interface($fwbr, $iface);
402 &$ovs_bridge_add_port($bridge, $ovsintport, $tag, 1, $trunks);
403 &$activate_interface($ovsintport);
405 # set the same mtu for ovs int port
406 PVE
::Tools
::run_command
(['/sbin/ip', 'link', 'set', $ovsintport, 'mtu', $bridgemtu]);
408 &$bridge_add_interface($fwbr, $ovsintport);
409 &$bridge_disable_interface_learning($ovsintport) if $disablelearning;
412 my $cleanup_firewall_bridge = sub {
415 my ($vmid, $devid) = &$parse_tap_device_name($iface, 1);
416 return if !defined($vmid);
417 my ($fwbr, $vethfw, $vethfwpeer, $ovsintport) = &$compute_fwbr_names($vmid, $devid);
419 # cleanup old port config from any openvswitch bridge
420 if (-d
"/sys/class/net/$ovsintport") {
421 run_command
("/usr/bin/ovs-vsctl del-port $ovsintport", outfunc
=> sub {}, errfunc
=> sub {});
424 # delete old vethfw interface
425 veth_delete
($vethfw);
427 # cleanup fwbr bridge
428 if (-d
"/sys/class/net/$fwbr") {
434 my ($iface, $bridge, $tag, $firewall, $trunks, $rate, $disablelearning) = @_;
436 #cleanup old port config from any openvswitch bridge
437 eval {run_command
("/usr/bin/ovs-vsctl del-port $iface", outfunc
=> sub {}, errfunc
=> sub {}) };
439 if (-d
"/sys/class/net/$bridge/bridge") {
440 &$cleanup_firewall_bridge($iface); # remove stale devices
442 my $vlan_aware = PVE
::Tools
::file_read_firstline
("/sys/class/net/$bridge/bridge/vlan_filtering");
445 die "vlan aware feature need to be enabled to use trunks" if $trunks;
446 my $newbridge = activate_bridge_vlan
($bridge, $tag);
447 copy_bridge_config
($bridge, $newbridge) if $bridge ne $newbridge;
448 $bridge = $newbridge;
453 &$create_firewall_bridge_linux($iface, $bridge, $tag, $trunks, $disablelearning);
455 &$bridge_add_interface($bridge, $iface, $tag, $trunks);
457 &$bridge_disable_interface_learning($iface) if $disablelearning;
460 &$cleanup_firewall_bridge($iface); # remove stale devices
463 &$create_firewall_bridge_ovs($iface, $bridge, $tag, $trunks, $disablelearning);
465 &$ovs_bridge_add_port($bridge, $iface, $tag, undef, $trunks);
469 tap_rate_limit
($iface, $rate);
475 my $path= "/sys/class/net/$iface/brport/bridge";
477 my $bridge = basename
(readlink($path));
478 #avoid insecure dependency;
479 ($bridge) = $bridge =~ /(\S+)/;
481 iface_set_master
($iface, undef);
484 &$cleanup_firewall_bridge($iface);
485 #cleanup old port config from any openvswitch bridge
486 eval {run_command
("/usr/bin/ovs-vsctl del-port $iface", outfunc
=> sub {}, errfunc
=> sub {}) };
489 sub copy_bridge_config
{
490 my ($br0, $br1) = @_;
492 return if $br0 eq $br1;
494 my $br_configs = [ 'ageing_time', 'stp_state', 'priority', 'forward_delay',
495 'hello_time', 'max_age', 'multicast_snooping', 'multicast_querier'];
497 foreach my $sysname (@$br_configs) {
499 my $v0 = PVE
::Tools
::file_read_firstline
("/sys/class/net/$br0/bridge/$sysname");
500 my $v1 = PVE
::Tools
::file_read_firstline
("/sys/class/net/$br1/bridge/$sysname");
502 PVE
::ProcFSTools
::write_proc_entry
("/sys/class/net/$br1/bridge/$sysname", $v0);
509 sub activate_bridge_vlan_slave
{
510 my ($bridgevlan, $iface, $tag) = @_;
511 my $ifacevlan = "${iface}.$tag";
513 # create vlan on $iface is not already exist
514 if (! -d
"/sys/class/net/$ifacevlan") {
516 my $cmd = ['/sbin/ip', 'link', 'add'];
517 push @$cmd, 'link', $iface;
518 push @$cmd, 'name', $ifacevlan;
519 push @$cmd, 'type', 'vlan', 'id', $tag;
522 die "can't add vlan tag $tag to interface $iface - $@\n" if $@;
524 # remove ipv6 link-local address before activation
525 disable_ipv6
($ifacevlan);
528 # be sure to have the $ifacevlan up
529 &$activate_interface($ifacevlan);
531 # test if $vlaniface is already enslaved in another bridge
532 my $path= "/sys/class/net/$ifacevlan/brport/bridge";
534 my $tbridge = basename
(readlink($path));
535 if ($tbridge ne $bridgevlan) {
536 die "interface $ifacevlan already exist in bridge $tbridge\n";
538 # Port already attached to bridge: do nothing.
543 # add $ifacevlan to the bridge
544 &$bridge_add_interface($bridgevlan, $ifacevlan);
547 sub activate_bridge_vlan
{
548 my ($bridge, $tag_param) = @_;
550 die "bridge '$bridge' is not active\n" if ! -d
"/sys/class/net/$bridge";
552 return $bridge if !defined($tag_param); # no vlan, simply return
554 my $tag = int($tag_param);
556 die "got strange vlan tag '$tag_param'\n" if $tag < 1 || $tag > 4094;
558 my $bridgevlan = "${bridge}v$tag";
561 my $dir = "/sys/class/net/$bridge/brif";
562 PVE
::Tools
::dir_glob_foreach
($dir, '(((eth|bond)\d+|en[^.]+)(\.\d+)?)', sub {
566 die "no physical interface on bridge '$bridge'\n" if scalar(@ifaces) == 0;
569 # add bridgevlan if it doesn't already exist
570 if (! -d
"/sys/class/net/$bridgevlan") {
571 iface_create
($bridgevlan, 'bridge');
574 # for each physical interface (eth or bridge) bind them to bridge vlan
575 foreach my $iface (@ifaces) {
576 activate_bridge_vlan_slave
($bridgevlan, $iface, $tag);
579 #fixme: set other bridge flags
581 # remove ipv6 link-local address before activation
582 disable_ipv6
($bridgevlan);
583 # be sure to have the bridge up
584 &$activate_interface($bridgevlan);
590 my ($host, $port, $timeout) = @_;
594 $timeout = 3 if !$timeout; # sane default
596 # Net::Ping defaults to the echo port
599 # Net::Ping's port_number() implies service_check(1)
605 $result = PVE
::Tools
::run_with_timeout
($timeout, sub {
606 $sock = IO
::Socket
::IP-
>new(PeerHost
=> $host, PeerPort
=> $port, Type
=> SOCK_STREAM
);
607 $result = $refused if $! == ECONNREFUSED
;
618 my ($cidr, $version) = @_;
620 return if $cidr !~ m!^(\S+?)/(\S+)$!;
621 my ($ip, $prefix) = ($1, $2);
623 my $ipobj = Net
::IP-
>new($ip, $version);
626 $version = $ipobj->version();
628 my $binmask = Net
::IP
::ip_get_mask
($prefix, $version);
631 my $masked_binip = $ipobj->binip() & $binmask;
632 my $masked_ip = Net
::IP
::ip_bintoip
($masked_binip, $version);
633 return Net
::IP-
>new("$masked_ip/$prefix");
637 my ($ip, $cidr, $version) = @_;
639 my $cidr_obj = IP_from_cidr
($cidr, $version);
640 return undef if !$cidr_obj;
642 my $ip_obj = Net
::IP-
>new($ip, $version);
643 return undef if !$ip_obj;
645 my $overlap = $cidr_obj->overlaps($ip_obj);
647 return if !defined($overlap);
649 return $overlap == $Net::IP
::IP_B_IN_A_OVERLAP
|| $overlap == $Net::IP
::IP_IDENTICAL
;
652 # get all currently configured addresses that have a global scope, i.e., are reachable from the
653 # outside of the host and thus are neither loopback nor link-local ones
654 # returns an array ref of: { addr => "IP", cidr => "IP/PREFIXLEN", family => "inet|inet6" }
655 sub get_reachable_networks
{
657 run_command
([qw(ip -j addr show up scope global)], outfunc
=> sub { $raw .= shift });
658 my $decoded = decode_json
($raw);
660 my $addrs = []; # filter/transform first so that we can sort correctly more easily below
661 for my $e ($decoded->@*) {
662 next if !$e->{addr_info
} || grep { $_ eq 'LOOPBACK' } $e->{flags
}->@*;
663 push $addrs->@*, grep { scalar(keys $_->%*) } $e->{addr_info
}->@*
666 for my $info (sort { $a->{family
} cmp $b->{family
} || $a->{local} cmp $b->{local} } $addrs->@*) {
668 addr
=> $info->{local},
669 cidr
=> "$info->{local}/$info->{prefixlen}",
670 family
=> $info->{family
},
677 # get one or all local IPs that are not loopback ones, able to pick up the following ones (in order)
678 # - the hostname primary resolves too, follows gai.conf (admin controlled) and will be prioritised
679 # - all configured in the interfaces configuration
680 # - all currently networks known to the kernel in the current (root) namespace
681 # returns a single address if no parameter is passed, and all found, grouped by type, if `all => 1`
686 my $nodename = PVE
::INotify
::nodename
();
687 my $resolved_host = eval { get_ip_from_hostname
($nodename) };
689 return $resolved_host if defined($resolved_host) && !$param{all
};
691 my $all = { v4
=> {}, v6
=> {} }; # hash to avoid duplicates and group by type
693 my $ifaces = PVE
::INotify
::read_file
('interfaces', 1)->{data
}->{ifaces
};
694 for my $if (values $ifaces->%*) {
695 next if $if->{type
} eq 'loopback' || (!defined($if->{address
}) && !defined($if->{address6
}));
696 my ($v4, $v6) = ($if->{address
}, $if->{address6
});
698 return ($v4 // $v6) if !$param{all
}; # prefer v4, admin can override $resolved_host via hosts/gai.conf
700 $all->{v4
}->{$v4} = 1 if defined($v4);
701 $all->{v6
}->{$v6} = 1 if defined($v6);
704 my $live = eval { get_reachable_networks
() } // [];
705 for my $info ($live->@*) {
706 my $addr = $info->{addr
};
708 return $addr if !$param{all
};
710 if ($info->{family
} eq 'inet') {
711 $all->{v4
}->{$addr} = 1;
713 $all->{v6
}->{$addr} = 1;
717 return undef if !$param{all
}; # getting here means no early return above triggered -> no IPs
719 my $res = []; # order gai.conf controlled first, then group v4 and v6, simply lexically sorted
720 if ($resolved_host) {
721 push $res->@*, $resolved_host;
722 delete $all->{v4
}->{$resolved_host};
723 delete $all->{v6
}->{$resolved_host};
725 push $res->@*, sort { $a cmp $b } keys $all->{v4
}->%*;
726 push $res->@*, sort { $a cmp $b } keys $all->{v6
}->%*;
731 sub get_local_ip_from_cidr
{
736 run_command
(['/sbin/ip', 'address', 'show', 'to', $cidr, 'up'], outfunc
=> sub {
737 if ($_[0] =~ m!^\s*inet(?:6)?\s+($PVE::Tools::IPRE)(?:/\d+|\s+peer\s+)!) {
738 $IPs->{$1} = $i++ if !exists($IPs->{$1});
742 return [ sort { $IPs->{$a} <=> $IPs->{$b} } keys %{$IPs} ];
747 my ($err, $host, $port) = Socket
::getnameinfo
($addr, NI_NUMERICHOST
| NI_NUMERICSERV
);
748 die "failed to get numerical host address: $err\n" if $err;
749 return ($host, $port) if wantarray;
753 sub get_ip_from_hostname
{
754 my ($hostname, $noerr) = @_;
756 my @res = eval { PVE
::Tools
::getaddrinfo_all
($hostname) };
758 die "hostname lookup '$hostname' failed - $@" if !$noerr;
763 my $ip = addr_to_ip
($ai->{addr
});
764 if ($ip !~ m/^127\.|^::1$/) {
765 return wantarray ?
($ip, $ai->{family
}) : $ip;
768 # NOTE: we only get here if no WAN/LAN IP was found, so this is now the error path!
769 die "address lookup for '$hostname' did not find any IP address\n" if !$noerr;
774 my ($code, @param) = @_;
775 my $res = lock_file
('/var/lock/pve-network.lck', 10, $code, @param);
780 # the canonical form of the given IP, i.e. dotted quad for IPv4 and RFC 5952 for IPv6
784 my $ip_obj = NetAddr
::IP-
>new($ip) or die "invalid IP string '$ip'\n";
786 return $ip_obj->canon();
789 # List of unique, canonical IPs in the provided list.
790 # Keeps the original order, filtering later duplicates.
797 for my $ip (@{$ips}) {
798 $ip = canonical_ip
($ip);
800 next if $seen->{$ip};