Have ideas to improve npm?Join in the discussion! »

mac-lookup

1.0.1 • Public • Published

mac-lookup

NPM

Build Status

NPM version NPM downloads

A node module to fetch, parse, and lookup entries from the IEEE's OUI database. Adapted from node-ieee-oui-lookup.

Install

npm install mac-lookup

Usage

// Config is optional
var config = {
  sql: './oui.db',
  txt: './oui.txt',
  url: 'http://linuxnet.ca/ieee/oui.txt'
}
 
var mac = require('mac-lookup')(config);
 
// if defining a custom config, make sure to rebuild at least once to generate sqlite3 db
mac.rebuild();
 
// ...

To lookup a MAC prefix:

mac.lookup('00:00:00', function (err, name) {
  if (err) throw err;
  // name will be null if not found.
  console.log('00:00:00 -> ' + name);
});

You can also look up the full mac address with or without full dash, dot, or colon notation:

mac.lookup('0000.0000.0000',function (err, name) {
  if (err) throw err;
  // name will be null if not found.
  console.log('0000.0000.0000 -> ' + name);
});)

If you think the internal DB is outdated, you can rebuild it from the latest file with:

mac.rebuild(function (err) {
  if (err) throw err;
  console.log('rebuild completed');
});

Iterate thru the entire db

 
function done() { console.log('done'); }
 
mac.each(function (err, result) {
  console.log('oui',  result.oui);
  console.log('name', result.name);
}, done);
 

Additional Notes

our csv file for ouis are obtained from here

wget https://standards.ieee.org/develop/regauth/oui/oui.csv

Install

npm i mac-lookup

DownloadsWeekly Downloads

19

Version

1.0.1

License

BSD-2-Clause

Unpacked Size

2.54 MB

Total Files

7

Last publish

Collaborators

  • avatar