oui-offline 1.2.5-java

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 286617edad02d732f5d3934f3b6f293fda5e421d
+  data.tar.gz: af07a576875323684c9025177179204327572565
+SHA512:
+  metadata.gz: 655a7b5b61d3eb2c16c4cf7b23d812c94a2464f3f936925a94e9e5843a6cb4aee69fb83dbca156e4771ab4840b179ec147ae2dc8c335943a6b7d9862c1cbc329
+  data.tar.gz: 3d0dd3c43705d172ebfc19376910d3f187bd01645a63d0d9e4e033d35057f858f388d808f9d5944b06035f15723bd9dc92785362740dfa268554de1258932240

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+gemspec
+gem 'rake'
+if RUBY_PLATFORM == 'java'
+  gem 'jdbc-sqlite3'
+else
+  gem 'sqlite3', '~> 1'
+end

data/README.md

@@ -0,0 +1,113 @@
+[![Build Status](https://travis-ci.org/steakknife/oui.svg)](https://travis-ci.org/steakknife/oui)
+# OUI (Organizationally Unique Identifiers)
+
+The 24-bit prefix of MAC / EUI-\* addresses.
+
+This is a Ruby library and CLI tool `oui`
+
+## Usage
+
+```ruby
+> OUI.find 'AA-BB-CC'
+=> nil
+> OUI.find '00:0c:85'
+=> {
+              :id => 3205,
+    :organization => "CISCO SYSTEMS, INC.",
+        :address1 => "170 W. TASMAN DRIVE",
+        :address2 => "M/S SJA-2",
+        :address3 => "SAN JOSE CA 95134-1706",
+         :country => "UNITED STATES"
+}
+```
+
+## CLI usage
+
+```text
+  Usage: oui lookup [options...] oui+     # get corp name, oui in 24-bit oui in hex format
+
+             -j JSON verbose output
+             -r Ruby verbose output
+             -y YAML verbose output
+
+         oui update                       # update oui internal db from ieee.org
+```
+
+## Installation
+### Gem (insecure installation)
+
+```shell
+[sudo] gem install oui-offline
+```
+### Gem (secure installation)
+
+```shell
+[sudo] gem cert --add <(curl -L https://gist.github.com/steakknife/5333881/raw/gem-public_cert.pem) # add my cert (do once)
+[sudo] gem install -P MediumSecurity oui-offline
+```
+
+See also: [waxseal](https://github.com/steakknife/waxseal)
+
+### Bundler Installation
+
+```ruby
+gem 'oui-offline'
+```
+
+### Manual Installation
+
+    cd ${TMP_DIR-/tmp}
+    git clone https://github.com/steakknife/oui
+    cd oui
+    gem build *.gemspec
+    gem install *.gem
+  
+
+## Lookup an OUI from CLI
+
+`oui lookup ABCDEF`
+
+## Data source
+
+Database sourced from the public IEEE list, but it can be rebuilt anytime by running `oui update` or `OUI.update_db`
+The few duplicates that are of multiple entities per OUI instead choose the first registration.
+
+## Unregistered OUIs
+
+Place custom/unregistered OUIs in `data/oui-manual.json` and re-run `oui update` or `OUI.update_db`.  Feel free to submit a PR to update these permanently.
+
+## Return format
+
+`OUI.find('00-00-00')` returns a hash like this:
+
+```ruby
+{:id            => 0,
+ :organization  => "XEROX CORPORATION",
+ :address1      => "M/S 105-50C",
+ :address2      => "800 PHILLIPS ROAD",
+ :address3      => "WEBSTER NY 14580",
+ :country       => "UNITED STATES"}
+
+
+The `id` column is a stable, reversible conversion of the OUI as follows: the hexadecimal value of the OUI) to unsigned integer in network order (id).
+
+- Use `OUI.oui_to_i('aa-bb-cc')` to obtain an `id` from an OUI
+- Use `OUI.to_s(12345)` to do the inverse, obtain an OUI from an `id`
+
+## Supported Ruby Engines
+
+- JRuby
+- Ruby 1.9.3+ (until February 2015), 2.*
+
+## Tested Ruby Engines
+
+- JRuby 1.7.*
+- Ruby (MRI) 2.2.*
+
+## Thanks
+
+[Your name here]
+
+## License
+
+MIT

data/bin/oui

@@ -0,0 +1,61 @@
+#!/usr/bin/env ruby
+root = File.dirname(File.expand_path('..', __FILE__))
+lib_dir = File.join(root, 'lib')
+$:.unshift lib_dir unless $:.include? lib_dir
+require 'oui'
+autoload :JSON, 'json'
+autoload :YAML, 'yaml'
+
+
+case ARGV.shift
+when 'lookup'
+  def output(r)
+    if @yaml_output
+      YAML.dump r
+    elsif @json_output
+      JSON.dump r
+    elsif @ruby_output
+      r
+    else
+      r[:organization]
+    end
+  end
+
+  success = nil
+  # TODO: OptParse || thor
+  @json_output = ARGV.delete '-j'
+  @ruby_output = ARGV.delete '-r'
+  @yaml_output = ARGV.delete '-y'
+  formats = [@ruby_output, @json_output, @yaml_output].count { |x| x };
+  fail 'Only one format flag is allowed' if formats > 1
+  ARGV.map do |mac|
+    r = OUI.find(mac)
+    success &= !!r
+    r ||= {}
+    puts(output(r))
+  end
+  exit 1 unless success
+
+when 'update'
+  if ARGV.delete '-l'
+    OUI.update_db(local = true)
+  else
+    OUI.update_db
+  end
+
+else
+  $stderr.puts <<-EOS
+  Usage: oui lookup [options...] oui+     # get corp name, oui in 24-bit oui in hex format
+  
+             -j JSON verbose output
+             -r Ruby verbose output
+             -y YAML verbose output
+
+         oui update [options...]          # update oui internal db from ieee.org
+
+             -l dont connect to network, instead use data/oui.txt
+
+EOS
+  exit 1
+end 
+

data/data/oui-manual.json

@@ -0,0 +1,7 @@
+[
+{"id": "00:D3:10", "organization": "Dell, Inc., for Dell Compellent Storage products"},
+{"id": "0A:BB:CF", "organization": "Apple, Inc., Bluetooth PAN"},
+{"id": "6A:5B:35", "organization": "Apple, Inc., Bridge and bond devices (virtual)"},
+{"id": "CA:6F:1D", "organization": "Apple, Inc., iPhone USB"},
+{"id": "D2:00:1A", "organization": "Apple, Inc., Thunderbolt"}
+]