findnodebymacaddress.adoc

FindNodeByMACAddress()

FindNodeByMACAddress(macaddress, currentNode) => Node

Look up [class-node] object by MAC address of one of the interfaces.

If trusted node validation is enforced, currentNode should point to execution context object (instance of [class-netobj], $node in most cases). If trusted nodes are disabled (default server configuration), currentNode can be omitted or set to null.

Table 1. Parameters

macaddress	String	MAC address.
currentNode	[class-netobj]	Lookup context or null if trusted nodes validation is disabled. Optional parameter.

Return

Instance of [class-node] object or null if not found or not accessible.

Example

node = FindNodeByMACAddress("AA:34:35:D8:12:45");
if (node != NULL) println(node.name); // Prints node name if node with given MAC address is found