Skip to content

Scans a mac address on the local network, reporting if it is connected. Very useful to track if your iPhone is connected to your Wifi network.

Notifications You must be signed in to change notification settings

bchabrier/mac-scan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build Status Coverage Status

mac-scan

Scans a mac address on the local network, reporting if it is connected. Very useful to track if your iPhone is connected to your Wifi network.

Installation

map-scanrequires arp-scan to be installed. On Debian systems you can install this with:

$ sudo apt-get install arp-scan

map-scan can be run with sh, or directly if execute permissions are set:

$ sh map-scan
Usage: mac-scan <mac_address>

$ chmod uog+x map-scan
$ map-scan
Usage: mac-scan <mac_address>

Usage

$ map-scan
Usage: mac-scan <mac_address>

mac-scan scans the local network for the specified mac address, reports any IP address associated to it as well as if the targeted device responded.

Examples

With a responding device:

$ map-scan 05:c9:31:c8:d9:a7
05:c9:31:c8:d9:a7 responded 192.168.0.46 Intel Corporate

With a non responding device:

$ map-scan 05:c9:31:c8:d9:a7
05:c9:31:c8:d9:a7 noresponse 192.168.0.46

With an unknown device:

$ map-scan 05:c9:31:c8:d9:a1
05:c9:31:c8:d9:a1 noresponse

Tests

Tests are run with bats(https://github.com/sstephenson/bats).

Test coverage uses kcov (http://simonkagstrom.github.io/kcov/index.html). Note that the bagde at the top of this file reports a wrong coverage (should be 100%).

About

Scans a mac address on the local network, reporting if it is connected. Very useful to track if your iPhone is connected to your Wifi network.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published