Class: PacketGen::Header::PPI

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

Overview

PPI (Per-Packet Information) packet

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, #protocol_name

Methods inherited from Types::Fields

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

Constructor Details

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

Instance Attribute Details

#alignBoolean

Returns align flag from #flags attribute.

Returns:

  • (Boolean)

    align flag from #flags attribute



34
# File 'lib/packetgen/header/dot11.rb', line 34

define_bit_fields_on :flags, :reserved, 7, :align

#bodyType::String

Returns:

  • (Type::String)


31
# File 'lib/packetgen/header/dot11.rb', line 31

define_field :body, Types::String

#dltInteger

Returns 32-bit PPI data link type.

Returns:

  • (Integer)

    32-bit PPI data link type



25
# File 'lib/packetgen/header/dot11.rb', line 25

define_field :dlt, Types::Int32le

#flagsInteger

Returns 8-bit PPI flags.

Returns:

  • (Integer)

    8-bit PPI flags



19
# File 'lib/packetgen/header/dot11.rb', line 19

define_field :flags, Types::Int8

#lengthInteger

Returns 16-bit PPI header length.

Returns:

  • (Integer)

    16-bit PPI header length



22
# File 'lib/packetgen/header/dot11.rb', line 22

define_field :length, Types::Int16le, default: 8

#ppi_fieldsType::String

Returns concatenation of PPI fields.

Returns:

  • (Type::String)

    concatenation of PPI fields



28
# File 'lib/packetgen/header/dot11.rb', line 28

define_field :ppi_fields, Types::String

#versionInteger

Returns 8-bit PPI version.

Returns:

  • (Integer)

    8-bit PPI version



16
# File 'lib/packetgen/header/dot11.rb', line 16

define_field :version, Types::Int8, default: 0

Instance Method Details

#parse?Boolean

Check version field

Returns:

  • (Boolean)

See Also:

  • PacketGen::Header::PPI.[Base[Base#parse?]


52
53
54
# File 'lib/packetgen/header/dot11.rb', line 52

def parse?
  version == 0
end

#read(str) ⇒ PPI

Returns self.

Parameters:

  • str (String)

Returns:

  • (PPI)

    self



38
39
40
41
42
43
44
45
46
47
48
# File 'lib/packetgen/header/dot11.rb', line 38

def read(str)
  return self if str.nil?
  force_binary str
  self[:version].read str[0, 1]
  self[:flags].read str[1, 1]
  self[:length].read str[2, 2]
  self[:dlt].read str[4, 4]
  self[:ppi_fields].read str[8, length - 8]
  self[:body].read str[length, str.size]
  self
end

#to_w(iface) ⇒ void

This method returns an undefined value.

send PPI packet on wire. Dot11 FCS trailer should be set.

Parameters:

  • iface (String)

    interface name



59
60
61
62
63
# File 'lib/packetgen/header/dot11.rb', line 59

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