Contents

Method

SendArpRequest

ModuleDiscovery
LibraryDiscovery
Action

Performs an ARP request to retrieve the physical address for the supplied IPv4 address.

ParametersIpAddress (string): The IPv4 address that the ARP request is intended to retrieve a physical address for.
Return values

IpAddress (string): The destination IP for the ARP request.

MacAddress (string): The physical address that corresponds to IpAddress.

Example

Returns a MacAddress and an IpAddress in a single row.

Discovery.SendArpRequest(IpAddress:"1.2.3.4");
Platforms
  • Windows
Notes

This method will only attempt to send ARP requests for IPv4 addresses. IPv6 addresses will be ignored, and a warning will be logged.

This method will request information over the wire. As such, it shouldn't be sent to a lot of machines. Staggering is also a recommended practice.

This method will never return anything other than SuccessNoContent or Success. If the ARP request is unsuccessful, the reason will be logged at warn level and SuccessNoContent will be returned.