Class: PacketGen::Types::OUI

Inherits:
Fields
  • Object
show all
Defined in:
lib/packetgen/types/oui.rb

Overview

OUI type, defined as a set of 3 bytes

oui = OUI.new
oui.from_human('00:01:02')
oui.to_human   # => "00:01:02"

Author:

  • Sylvain Daubert

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Fields

#[], #[]=, #body=, define_bit_fields_on, define_field, define_field_after, define_field_before, #fields, #force_binary, inherited, #initialize, #inspect, #read, #sz, #to_h, #to_s

Constructor Details

This class inherits a constructor from PacketGen::Types::Fields

Instance Attribute Details

#b0 ⇒ Integer

Returns right-most byte.

Returns:

  • (Integer) —

    right-most byte



24
 
# File 'lib/packetgen/types/oui.rb', line 24

define_field :b0, Types::Int8

#b1 ⇒ Integer

Returns center byte.

Returns:

  • (Integer) —

    center byte



21
 
# File 'lib/packetgen/types/oui.rb', line 21

define_field :b1, Types::Int8

#b2 ⇒ Integer

Returns left-most byte.

Returns:

  • (Integer) —

    left-most byte



18
 
# File 'lib/packetgen/types/oui.rb', line 18

define_field :b2, Types::Int8

Instance Method Details

#from_human(str) ⇒ OUI

Read a human-readable string to populate object

Parameters:

Returns:

  • (OUI) —

    self



29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/packetgen/types/oui.rb', line 29

def from_human(str)
  return self if str.nil?
  bytes = str.split(/:/)
  unless bytes.size == 3
    raise ArgumentError, 'not a OUI'
  end
  self[:b2].read(bytes[0].to_i(16))
  self[:b1].read(bytes[1].to_i(16))
  self[:b0].read(bytes[2].to_i(16))
  self
end

#to_human ⇒ String

Get OUI in human readable form (colon-separated bytes)

Returns:



43
44
45
 
# File 'lib/packetgen/types/oui.rb', line 43

def to_human
  fields.map { |m| "#{'%02x' % self[m]}" }.join(':')
end