Class: PacketGen::Header::RadioTap

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

Overview

Radiotap header (see www.radiotap.org/)

Since:

  • 1.4.0

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

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?, 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

#bodyType::String

Returns:

  • (Type::String)


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

define_field :body, Types::String

#lengthInteger

Returns 16-bit RadioTap header length.

Returns:

  • (Integer)

    16-bit RadioTap header length



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

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

#padInteger

Returns 8-bit pad.

Returns:

  • (Integer)

    8-bit pad



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

define_field :pad, Types::Int8, default: 0

#present_flagsInteger

Returns 32-bit integer.

Returns:

  • (Integer)

    32-bit integer



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

define_field :present_flags, Types::Int32le

#radio_fieldsType::String

Returns concatenation of RadioTap fields.

Returns:

  • (Type::String)

    concatenation of RadioTap fields



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

define_field :radio_fields, Types::String

#versionInteger

Returns 8-bit version.

Returns:

  • (Integer)

    8-bit version



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

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

Instance Method Details

#calc_lengthInteger

Calculate header length

Returns:

  • (Integer)

    calculated length

Since:

  • 2.1.3



125
126
127
# File 'lib/packetgen/header/dot11.rb', line 125

def calc_length
  self[:length].value = self.sz - self[:body].sz
end

#parse?Boolean

Check version field

Returns:

  • (Boolean)

See Also:

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

Since:

  • 1.4.0



118
119
120
# File 'lib/packetgen/header/dot11.rb', line 118

def parse?
  version.zero? && (length >= 8)
end

#read(str) ⇒ RadioTap

Returns self.

Parameters:

  • str (String)

Returns:

Since:

  • 1.4.0



103
104
105
106
107
108
109
110
111
112
113
114
# File 'lib/packetgen/header/dot11.rb', line 103

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

  force_binary str
  self[:version].read str[0, 1]
  self[:pad].read str[1, 1]
  self[:length].read str[2, 2]
  self[:present_flags].read str[4, 4]
  self[:radio_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 RadioTap packet on wire. Dot11 FCS trailer should be set.

Parameters:

  • iface (String)

    interface name

Since:

  • 1.4.0



132
133
134
135
136
137
# File 'lib/packetgen/header/dot11.rb', line 132

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