Code Monkey home page Code Monkey logo

arplookup's Introduction

ArpLookup

ArpLookup

Build Status NuGet version (ArpLookup)

This is a simple .Net Standard 2.0 library providing Lookup and LookupAsync methods to find the MAC address corresponding to an IP address on Windows and Linux.

Download

Usage

This library currently provides one single, simple to use function (once sync, once async; only truly async on Linux, see below):

using System.Net.NetworkInformation;
using ArpLookup;

// ...

PhysicalAddress mac = Arp.Lookup(IPAddress.Parse("1.2.3.4"));

PhysicalAddress mac = await Arp.LookupAsync(IPAddress.Parse("1.2.3.4"));

To detect if the current platform is supported, check as follows. Lookups on unsupported platforms throw PlatformNotSupportedExceptions.

var linuxOrWindows = Arp.IsSupported;

Further information

On Windows an API call to IpHlpApi.SendARP is used. Beware that this implementation is not truly async but just returns a finished task containing the result. Consider calling wrapped in Task.Run if the sync executing is not acceptable in your use case.

On Linux the /proc/net/arp file, which contains system's the arp cache, is read. If the IP address is found there the corresponding MAC address is returned directly. Otherwise, an ICMP ping is sent to the given IP address and the arp cache lookup is repeated afterwards. This implementation uses async file IO and the framework's async ping implementation. As a last resort, the output of the command "ip addr show" is parsed.

Per default, the library waits for ping responses for up to 750ms on Linux platforms. Technically, the responses are not required, as the arp protocol and the arp cache have nothing to do with the pings. Rather, the pings are an easy way to force the OS to figure out and provide the information we are looking for. I did not do extensive tests how long is reasonable to wait to be quite sure, the arp cache is updated. 750ms should be much more than needed in many cases - it is more of the safe option. Note that if you do recieve a ping response, the wait might be much shorter. The timeout gets relevant if the host is not available/no ping answer is received. If you want to request many addresses or are facing other time-limiting aspects, you may want to reconfigure this default:

Arp.LinuxPingTimeout = TimeSpan.FromMilliseconds(125);

Supported platforms

  • Windows (tested)
  • Linux
    • Debian (tested)
    • Ubuntu (tested)
    • Android
    • not WSL 1 (tested)
    • WSL 2

Note that the used method does not work in WSL 1 and might not work on every Linux distribution. Checking the Arp.IsSupported property accounts for this (though it does not check if you are actually allowed to access /proc/net/arp). In WSL 2 this library will work as on most "real" Linux distributions as this issue describes. While I did not test this library on Android/Xamarin I have read in different places that reading /proc/net/arp is possible (given the right permissions).

arplookup's People

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.