Class: PacketGen::Header::Eth

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

Overview

An Ethernet header consists of:

Create a Ethernet header

# standalone
eth = PacketGen::Header::Eth.new
# in a packet
pkt = PacketGen.gen('Eth')
# access to Ethernet header
pkt.eth   # => PacketGen::Header::Eth

Ethernet attributes

eth.dst = "00:01:02:03:04:05"
eth.src        # => "00:01:01:01:01:01"
eth[:src]      # => PacketGen::Header::Eth::MacAddr
eth.ethertype  # => 16-bit Integer
eth.body = "This is a body"

Defined Under Namespace

Classes: MacAddr

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Base

bind, calculate_and_set_length, #header_id, inherited, #initialize, #ip_header, known_headers, #ll_header

Methods included from PacketGen::Headerable

#added_to_packet, included, #method_name, #packet, #packet=, #parse?, #protocol_name, #read

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::Header::Base

Instance Attribute Details

#body ⇒ Types::String, Header::Base

Returns:



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

define_field :body, Types::String

#dst ⇒ MacAddr

Returns Destination MAC address.

Returns:

  • (MacAddr) —

    Destination MAC address



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

define_field :dst, MacAddr, default: '00:00:00:00:00:00'

#ethertype ⇒ Integer

Returns 16-bit integer to determine payload type.

Returns:

  • (Integer) —

    16-bit integer to determine payload type



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

define_field :ethertype, Types::Int16, default: 0

#src ⇒ MacAddr

Returns Source MAC address.

Returns:



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

define_field :src, MacAddr, default: '00:00:00:00:00:00'

Instance Method Details

#reply! ⇒ self

Invert destination and source addresses

Returns:

  • (self)

Since:

  • 2.7.0



105
106
107
108
 
# File 'lib/packetgen/header/eth.rb', line 105

def reply!
  self[:src], self[:dst] = self[:dst], self[:src]
  self
end

#to_w(iface) ⇒ void

This method returns an undefined value.

send Eth packet on wire.

Parameters:

  • iface (String) —

    interface name



96
97
98
99
100
 
# File 'lib/packetgen/header/eth.rb', line 96

def to_w(iface)
  pcap = PCAPRUB::Pcap.open_live(iface, PCAP_SNAPLEN, PCAP_PROMISC, PCAP_TIMEOUT)
  pcap.inject self.to_s
  pcap.close
end