Class: PacketGen::Header::Eth::MacAddr

Inherits:
Types::Fields show all
Defined in:
lib/packetgen/header/eth.rb

Overview

Ethernet MAC address, as a group of 6 bytes

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Types::Fields

#[], #[]=, #bits_on, define_bit_fields_on, define_field, define_field_after, define_field_before, #fields, fields, inherited, #initialize, #inspect, #offset_of, #optional?, #optional_fields, #present?, #read, remove_bit_fields_on, remove_field, #sz, #to_h, #to_s, update_field

Constructor Details

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

Instance Attribute Details

#a0 ⇒ Integer

Returns first byte from MacAddr.

Returns:

  • (Integer) —

    first byte from MacAddr



38
 
# File 'lib/packetgen/header/eth.rb', line 38

define_field :a0, Types::Int8

#a1 ⇒ Integer

Returns second byte from MacAddr.

Returns:

  • (Integer) —

    second byte from MacAddr



41
 
# File 'lib/packetgen/header/eth.rb', line 41

define_field :a1, Types::Int8

#a2 ⇒ Integer

Returns third byte from MacAddr.

Returns:

  • (Integer) —

    third byte from MacAddr



44
 
# File 'lib/packetgen/header/eth.rb', line 44

define_field :a2, Types::Int8

#a3 ⇒ Integer

Returns fourth byte from MacAddr.

Returns:

  • (Integer) —

    fourth byte from MacAddr



47
 
# File 'lib/packetgen/header/eth.rb', line 47

define_field :a3, Types::Int8

#a4 ⇒ Integer

Returns fifth byte from MacAddr.

Returns:

  • (Integer) —

    fifth byte from MacAddr



50
 
# File 'lib/packetgen/header/eth.rb', line 50

define_field :a4, Types::Int8

#a5 ⇒ Integer

Returns sixth byte from MacAddr.

Returns:

  • (Integer) —

    sixth byte from MacAddr



53
 
# File 'lib/packetgen/header/eth.rb', line 53

define_field :a5, Types::Int8

Instance Method Details

#from_human(str) ⇒ self

Read a human-readable string to populate MacAddr

Parameters:

  • str (String)

Returns:

  • (self)

Raises:

  • (ArgumentError) 


58
59
60
61
62
63
64
65
66
67
68
69
70
71
 
# File 'lib/packetgen/header/eth.rb', line 58

def from_human(str)
  return self if str.nil?

  bytes = str.split(/:/)
  raise ArgumentError, 'not a MAC address' unless bytes.size == 6

  self[:a0].read(bytes[0].to_i(16))
  self[:a1].read(bytes[1].to_i(16))
  self[:a2].read(bytes[2].to_i(16))
  self[:a3].read(bytes[3].to_i(16))
  self[:a4].read(bytes[4].to_i(16))
  self[:a5].read(bytes[5].to_i(16))
  self
end

#to_human ⇒ String

MacAddr in human readable form (colon format)

Returns:

  • (String) 


75
76
77
 
# File 'lib/packetgen/header/eth.rb', line 75

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