cordova-arp-cache-fetch

Android ARP Cache

Get Android ARP Cache or Query ARP Cache against an IP Address or a MAC Address.

• Note: This plugin only retrieves the contents of the ARP cache file. The contents of the file are totally dependent on Android OS. More information: ARP Man Page.

Supported Platforms

• Android

Installation

cordova plugin add cordova-arp-cache-fetch

or

cordova plugin add https://github.com/arvindr21/cordova-android-arp-cache.git

Example

Example App: Cordova-NetworkPeers

Usage

This plugin defines a global ARP object. Although the object is in the global scope, it is not available until after the deviceready event.

Get Raw ARP Cache

• success : Success callback
• error : Error Callback

ARP.getRawCache(function(resp) {
    console.log(resp);
    // Output
    /*
        "IP address       HW type     Flags       HW address            Mask     Device
        192.168.1.26     0x1         0x2         e4:02:9b:5a:d1:ba     *        wlan0
        192.168.1.11     0x1         0x2         08:11:96:9c:64:d0     *        wlan0
        192.168.1.3      0x1         0x2         dc:1a:c5:66:fa:a9     *        wlan0
        192.168.1.4      0x1         0x2         60:f8:1d:c9:1a:58     *        wlan0
        192.168.1.21     0x1         0x2         30:ae:a4:0e:12:f8     *        wlan0
        192.168.1.15     0x1         0x2         30:ae:a4:03:2f:04     *        wlan0
        192.168.1.7      0x1         0x2         50:8f:4c:8e:a9:27     *        wlan0
        192.168.1.8      0x1         0x0         24:0a:c4:81:cf:a4     *        wlan0
        192.168.1.16     0x1         0x2         30:ae:a4:0a:c1:ac     *        wlan0
        192.168.1.9      0x1         0x2         30:ae:a4:3f:43:18     *        wlan0
        192.168.1.1      0x1         0x2         10:62:eb:7d:4a:df     *        wlan0
        192.168.1.17     0x1         0x2         2c:6e:85:b2:12:f9     *        wlan0
        192.168.1.10     0x1         0x2         24:0a:c4:13:39:8c     *        wlan0"
 
    */
}, function(err) {
    console.log(err);
});

Get Parsed ARP Cache

• success : Success callback
• error : Error Callback

ARP.getParsedCache(function(resp) {
    console.log(resp);
    // Output
    /*
        [{
            "ip": "192.168.1.26",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "e4:02:9b:5a:d1:ba",
            "mask": "*",
            "device": "wlan0"
        },
        {
            "ip": "192.168.1.11",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "30:ae:a4:3f:42:c0",
            "mask": "*",
            "device": "wlan0"
        },
        {
            "ip": "192.168.1.3",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "60:f8:1d:c9:1a:58",
            "mask": "*",
            "device": "wlan0"
        },
        {
            "ip": "192.168.1.4",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "50:8f:4c:8e:a9:27",
            "mask": "*",
            "device": "wlan0"
        },
        {
            "ip": "192.168.1.6",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "2c:6e:85:6b:30:32",
            "mask": "*",
            "device": "wlan0"
        },
        {
            "ip": "192.168.1.7",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "08:11:96:9c:64:d0",
            "mask": "*",
            "device": "wlan0"
        },
        {
            "ip": "192.168.1.8",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "24:0a:c4:81:cf:a4",
            "mask": "*",
            "device": "wlan0"
        },
        {
            "ip": "192.168.1.9",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "10:07:b6:37:dc:ef",
            "mask": "*",
            "device": "wlan0"
        },
        {
            "ip": "192.168.1.1",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "10:62:eb:7d:4a:df",
            "mask": "*",
            "device": "wlan0"
        },
        {
            "ip": "192.168.1.17",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "2c:6e:85:b2:12:f9",
            "mask": "*",
            "device": "wlan0"
        },
        {
            "ip": "192.168.1.10",
            "hwType": "0x1",
            "flags": "0x2",
            "mac": "30:ae:a4:0e:12:f8",
            "mask": "*",
            "device": "wlan0"
        }]
 
    */
}, function(err) {
    console.log(err);
});

Get Macaddress from IP address - Query ARP cache

• ip : IP address of the device
• success : Success callback
• error : Error Callback

ARP.getMacFromIp('192.168.1.1', function(resp) {
    console.log(resp);
    // Output -> {"ip":"192.168.1.1","mac":"10:62:eb:7d:4a:df"}
}, function(err) {
    console.log(err);
});

Get IP address from Macaddress - Query ARP cache

• mac : Macaddress of the device
• success : Success callback
• error : Error Callback

ARP.getIPFromMac('10:62:eb:7d:4a:df', function(resp) {
    console.log(resp);
    // Output -> {"ip":"192.168.1.1","mac":"10:62:eb:7d:4a:df"}
}, function(err) {
    console.log(err);
});

Refresh ARP cache

• success : Success callback
• error : Error Callback

Note: This method will take greater than 254 * 300 ms (76.20 seconds) to complete.

ARP.refreshCache(function(resp) {
    console.log(resp);
    // Output -> Report of the IP sweep
    /*
    {
        "reachable": [
        {
            "ip": "192.168.1.1"
        },
        {
            "ip": "192.168.1.5"
        },
        {
            "ip": "192.168.1.8"
        },
        {
            "ip": "192.168.1.10"
        }],
        "notReachable": [
        {
            "ip": "192.168.1.2"
        },
        {
            "ip": "192.168.1.3"
        },
        {
            "ip": "192.168.1.4"
        },
        {
            "ip": "192.168.1.6"
        },
        {
            "ip": "192.168.1.7"
        },
        .... SNIPP
        ....
        .... SNIPP
        {
            "ip": "192.168.1.253"
        },
        {
            "ip": "192.168.1.254"
        }]
    }
 
    */
}, function(err) {
    console.log(err);
});