OUI_Lookup

Code Status

Travis CI Build
Status CodeClimate Status

Copyright and Licensing

Copyright Notice

Copyright 2011, 2013 Todd A. Jacobs
All rights reserved.

Software License

The software is licensed under the GPLv3. The LICENSE is also included in the source tree.

README License

Creative Commons Attribution-NonCommercial-ShareAlike 3.0 United States License

Purpose

The IEEE hands out Organizationally Unique Identifiers to companies for use in such things as manufacturing NIC cards. The first three octets of a MAC address should be the manufacturer's prefix, so this gem may be useful in identifyng NIC cards or constructing valid MAC addresses.

Installation and Usage

The install instructons assume RVM with Ruby 1.9.2, but the code is also tested with Ruby 2.0.0. The dependencies aren't heavy, and it would probably take less time to backport the tests and syntax to 1.8.7 than it did to write this sentence, but life is like that sometimes. Don't file a bug about it; just make sure you are using the correct Ruby within RVM.

Installing the OUI_Lookup Gem

gem install oui_lookup

Running the CLI

oui_lookup <mac_address_or_prefix>

Using the Library

require 'oui_lookup'

Sample Output

No screenshots here, just samples of what you can expect from running this thing.

NOTE

The input format is pretty flexible. It will take both a three-octet prefix, as well as a full MAC address with six octets. It's also pretty agnostic about separators (or the lack thereof).

Looking up a valid prefix

$ oui_lookup 000000
Searching...

00-00-00   (hex)		XEROX CORPORATION
000000     (base 16)		XEROX CORPORATION

M/S 105-50C 800 PHILLIPS ROAD WEBSTER NY 14580 UNITED STATES

Looking up a MAC address with an unregistered prefix

$ oui_lookup FF:FF:FF:FF:FF:FF
Searching...

OUI not found: FF-FF-FF

Further Reading

  1. Ruby Version Manager (RVM)

  2. RubyGems

  3. IEEE OUIs