A set of helper subroutines to support parts of the Netdisco application.

There are no default exports, however the :all tag will export all subroutines.


check_mac( $device, $node, $port_macs? )

Given a Device database object and a MAC address, perform various sanity checks which need to be done before writing an ARP/Neighbor entry to the database storage.

Returns false, and might log a debug level message, if the checks fail.

Returns a true value (the MAC address in IEEE format) if these checks pass:

  • MAC address is well-formed (according to common formats)

  • MAC address is not all-zero, broadcast, CLIP, VRRP or HSRP

Optionally pass a cached set of Device port MAC addresses as the third argument, in which case an additional check is added:

  • MAC address does not belong to an interface on any known Device

is_nbtstatable( $ip )

Given an IP address, returns true if Netdisco on this host is permitted by the local configuration to nbtstat the node.

The configuration items nbtstat_no and nbtstat_only are checked against the given IP.

Returns false if the host is not permitted to nbtstat the target node.