Class: PacketGen::Header::RadioTap

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

Overview

Radiotap header (see www.radiotap.org/)

Author:

  • Sylvain Daubert

Since:

  • 1.4.0

Instance Attribute Summary collapse

Attributes inherited from Base

#packet

Instance Method Summary collapse

Methods inherited from Base

#added_to_packet, bind, bind_header, calculate_and_set_length, #header_id, inherited, #initialize, #ip_header, known_headers, #ll_header, #method_name, #protocol_name, protocol_name

Methods inherited from Types::Fields

#[], #[]=, #bits_on, define_bit_fields_on, define_field, define_field_after, define_field_before, delete_field, fields, #fields, #force_binary, inherited, #initialize, #inspect, #is_optional?, #is_present?, #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

#body ⇒ Type::String

Returns:

  • (Type::String) 


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

define_field :body, Types::String

#length ⇒ Integer

Returns 16-bit RadioTap header length.

Returns:

  • (Integer) —

    16-bit RadioTap header length



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

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

#pad ⇒ Integer

Returns 8-bit pad.

Returns:

  • (Integer) —

    8-bit pad



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

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

#present_flags ⇒ Integer

Returns 32-bit integer.

Returns:

  • (Integer) —

    32-bit integer



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

define_field :present_flags, Types::Int32le

#radio_fields ⇒ Type::String

Returns concatenation of RadioTap fields.

Returns:

  • (Type::String) —

    concatenation of RadioTap fields



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

define_field :radio_fields, Types::String

#version ⇒ Integer

Returns 8-bit version.

Returns:

  • (Integer) —

    8-bit version



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

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

Instance Method Details

#calc_length ⇒ Integer

Calculate header length

Returns:

  • (Integer) —

    calculated length

Since:

  • 2.1.3



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

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



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

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

#read(str) ⇒ RadioTap

Returns self.

Parameters:

  • str (String)

Returns:

Since:

  • 1.4.0



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

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



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

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