NAME

App::Netdisco::Util::Node

DESCRIPTION

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.

Given 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:

Optionally pass a Device instance or IP to use in logging.

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

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.

Stores a new entry to the "node_ip" table with the given MAC, IP (v4 or v6) and DNS host name. Host details are provided in a Hash ref:

 {
    ip   => '192.0.2.1',
    node => '00:11:22:33:44:55',
    dns  => 'myhost.example.com',
 }

The "dns" entry is optional. The update will mark old entries for this IP as no longer "active".

Optionally a literal string can be passed in the second argument for the "time_last" timestamp, otherwise the current timestamp ("now()") is used.