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

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

Overview

Ethernet MAC address, as a group of 6 bytes

Instance Attribute Summary collapse

Attributes inherited from Base

#packet

Instance Method Summary collapse

Methods inherited from Base

bind_header, #header_id, inherited, #ip_header, known_headers, #parse?, #protocol_name

Methods inherited from Types::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

#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) 


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(/:/)
  unless bytes.size == 6
    raise ArgumentError, 'not a MAC address'
  end
  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