mac_address_eui48 0.1.0

data/lib/mac_address_eui48.rb

@@ -0,0 +1,45 @@
+
+# Copyright (C) 2015  Mathieu Cunche <mathieu.cunche@innsa-lyon.fr>
+
+require "mac_address_eui48/version"
+require "mac_address_eui48/mac_address"
+require "mac_address_eui48/oui_resolver"
+
+
+module MacAddressEui48  
+  OUI_FILE="data/oui.txt"
+  
+  # MAC address format is hexadecimal characters separated by ':'
+  # ex: "AA:BB:CC:DD:EE:FF" or "11:22:33:44:55:66
+
+  def MacAddressEui48::is_valid_mac(mac_addr)
+    return (mac_addr =~ /^(\h\h:){5}\h\h$/)
+  end
+  
+  def MacAddressEui48::macaddr_to_int(a)
+    return a = a.delete(":").to_i(16)
+  end
+    
+  def MacAddressEui48::int_to_macaddr(i)
+    a = i.to_s(16)
+    a = a.rjust(12,'0')
+    a = a.insert(10,':').insert(8,':').insert(6,':').insert(4,':').insert(2,':')
+    return a.upcase 
+  end
+  
+  def  MacAddressEui48::oui_lookup(mac_addr)
+    oui = ""
+    mac_array=mac_addr.upcase.split(":")
+    prefix = mac_array[0] + "-" + mac_array[1] + "-" + mac_array[2]
+    oui_file = File.open(OUI_FILE)
+    oui_file.each_line do |line|
+      if (line =~ /.*#{prefix}.*(hex)/) then
+        
+        oui = line.split("\t")[2].chomp
+      end
+    end
+    return oui
+  end
+
+  
+end

data/lib/mac_address_eui48/mac_address.rb

@@ -0,0 +1,64 @@
+# Copyright (C) 2015  Mathieu Cunche <mathieu.cunche@innsa-lyon.fr>
+
+module MacAddressEui48  
+ 
+  
+  class MacAddress
+    include Comparable
+    attr_reader :mac_str
+    
+    def initialize(arg)
+      case arg
+      when MacAddress
+        @mac_str = arg.to_s
+      when Integer 
+        @mac_str = MacAddressEui48::int_to_macaddr(arg)
+      when String
+        if (MacAddressEui48::is_valid_mac(arg)) then 
+          @mac_str=arg
+        else
+          raise "Wrong format for string mac address #{arg}"
+        end
+      else
+        raise "Incompatible type for MacAddress Initialization: #{arg.class}"
+      end
+    end
+    
+    
+    def to_i
+      return MacAddressEui48::macaddr_to_int(@mac_str)
+    end
+    
+    def <=>(other)
+      MacAddressEui48::macaddr_to_int(self.mac_str) <=> MacAddressEui48::macaddr_to_int(other.mac_str)
+    end
+    
+    def to_s
+      @mac_str  
+    end
+  
+    def is_broadcast
+      self.mac_str ==  "FF:FF:FF:FF:FF:FF"
+    end
+   
+    def is_unicast
+      return !is_multicast
+    end
+    def is_multicast
+      
+    end
+    def is_glob_uniq
+      return !is_loc_admin
+    end
+    def is_loc_admin
+      
+    end
+    
+
+    def next
+      return MacAddress.new(MacAddressEui48::int_to_macaddr(((self.to_i) +1)%2**48))
+    end
+    alias_method :succ, :next
+    
+  end
+end

data/lib/mac_address_eui48/oui_resolver.rb

@@ -0,0 +1,52 @@
+# Copyright (C) 2015  Mathieu Cunche <mathieu.cunche@innsa-lyon.fr>
+
+module MacAddressEui48  
+  class OuiResolver
+    def initialize()
+      @hash=Hash.new(nil)
+      
+      oui_file = File.open(OUI_FILE)
+      oui_file.each_line do |line|
+        if (line =~ /\(hex\)/) then
+          prefix = line.split("\t")[0].split(" ")[0].gsub("-",":").chomp
+          oui = line.split("\t")[2].chomp
+          @hash[prefix]=oui
+        end
+        
+      end
+    end
+    def oui_lookup(mac_addr)
+      return @hash[mac_addr[0..7].upcase]
+    end
+    def reverse_lookup(vendor)
+      return @hash.select { |key, val| val == vendor }.keys 
+    end
+    def has_oui(mac)
+      return (oui_lookup(mac) != nil) 
+    end
+    
+    def random_mac
+      i = rand(2**48)
+      return MacAddressEui48::int_to_macaddr(i).upcase
+    end
+    def random_oui_mac 
+      vendor = @hash.values.uniq[rand(@hash.values.uniq.size)]
+      return random_mac_vendor(vendor)
+    end
+    
+    def random_mac_vendor(vendor)
+      ouis = reverse_lookup(vendor)
+      if (ouis.size <=0) then
+        raise "OUI not found #{vendor}"
+      end
+      oui = ouis[rand(ouis.size)]
+      i1 =  MacAddressEui48::macaddr_to_int( oui + ":00:00:00")
+      i2 = rand(2**24)       
+      i = i1 + i2
+      return MacAddressEui48::int_to_macaddr(i)
+    end
+    
+  end
+  
+  
+end

data/lib/mac_address_eui48/version.rb

@@ -0,0 +1,5 @@
+# Copyright (C) 2015  Mathieu Cunche <mathieu.cunche@innsa-lyon.fr>
+
+module MacAddressEui48
+  VERSION = "0.1.0"
+end

data/mac_address_eui48.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mac_address_eui48/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "mac_address_eui48"
+  spec.version       = MacAddressEui48::VERSION
+  spec.authors       = ["Mathieu Cunche"]
+  spec.email         = ["mathieu.cunche@insa-lyon.fr"]
+
+  spec.summary       = %q{An implementation of class for MAC address (i.e. IEEE EUI48 identifiers).}
+  # spec.description   = %q{TODO: Write a longer description or delete this line.}
+  spec.homepage      = "https://github.com/cunchem/mac_address_eui48"
+
+  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
+  # delete this section to allow pushing this gem to any host.
+  #if spec.respond_to?(:metadata)
+  #  spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
+  #else
+  #  raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  #end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(tests|spec|features)/}) }
+  spec.bindir        = "bin"
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification
+name: mac_address_eui48
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Mathieu Cunche
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: 
+email:
+- mathieu.cunche@insa-lyon.fr
+executables:
+- console
+- setup
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- data/oui.txt
+- lib/mac_address_eui48.rb
+- lib/mac_address_eui48/mac_address.rb
+- lib/mac_address_eui48/oui_resolver.rb
+- lib/mac_address_eui48/version.rb
+- mac_address_eui48.gemspec
+homepage: https://github.com/cunchem/mac_address_eui48
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: An implementation of class for MAC address (i.e. IEEE EUI48 identifiers).
+test_files: []