arpreq 0.3.3

Usage

The arpreq module exposes a single function arpreq, that will resolve a given IPv4 address into a MAC address.

An IP address can only be resolved to a MAC address if it is on the same subnet as your machine.

Let’s assume your current machine has the address 192.168.1.10 and another machine with the address 192.168.1.1 is on the same subnet:

>>> import arpreq
>>> arpreq.arpreq('192.168.1.1')
'00:11:22:33:44:55'

If a IP address can not be resolved to an MAC address, None is returned.

>>> arpreq.arpreq('8.8.8.8') is None
True

IP addresses may be also be specified as int or rich IP address data type of the common ipaddr, ipaddress, or netaddr modules.

>>> arpreq.arpreq(0x7F000001)
'00:00:00:00:00:00'
>>> import netaddr
>>> arpreq.arpreq(netaddr.IPAddress('127.0.0.1'))
'00:00:00:00:00:00'
>>> import ipaddr # on Python 2
>>> arpreq.arpreq(ipaddr.IPv4Address('127.0.0.1'))
'00:00:00:00:00:00'
>>> import ipaddress
>>> arpreq.arpreq(ipaddress.IPv4Address(u'127.0.0.1'))
'00:00:00:00:00:00'

Supported Platforms

This extension has only been tested on Linux, it should however work on any platform that supports the SIOCGARP ioctl, which is virtually every BSD, Linux and Mac OS.

Changelog