Class: PacketGen::Header::Dot11::Management

Inherits:
PacketGen::Header::Dot11 show all
Defined in:
lib/packetgen/header/dot11/management.rb

Overview

IEEE 802.11 management frame header

This class make a PacketGen::Header::Dot11 header with #type set to 0 (management frame).

A IEEE 802.11 management header consists of:

Management frames should be constructed with more headers from SubMngt subclasses. Some frames also need to have Element.

Examples:

Build a DeAuth frame:

PacketGen.gen('Dot11::Management').add('Dot11::DeAuth')

a Beacon frame with elements:

bssid = '00:01:02:03:04:05'
pkt = PacketGen.gen('Dot11::Management', mac1: 'ff:ff:ff:ff:ff:ff', mac2: bssid, mac3: bssid)
               .add('Dot11::Beacon')
# Directly add elements to Beacon
pkt.dot11_beacon.elements << { type: 'SSID', value: "SSIDSSID" }
pkt.dot11_beacon.elements << { type: 'Rates', value: "\x82\x84\x8b\x96\x12\x24\x48\x6c" }
# Add elements to beacon through management header
pkt.dot11_management.add_element(type: 'DSset', value: "\x06")
pkt.dot11_management.add_element(type: 'TIM', value: "\x00\x01\x00\x00")

Author:

  • Sylvain Daubert

Since:

  • 1.4.0

Constant Summary

Constants inherited from PacketGen::Header::Dot11

TYPES

Instance Attribute Summary

Attributes inherited from PacketGen::Header::Dot11

#body, #fcs, #fragment_number, #frame_ctrl, #from_ds, #ht_ctrl, #id, #mac1, #mac2, #mac3, #mac4, #md, #mf, #order, #proto_version, #pwmngt, #qos_ctrl, #retry, #sequence_ctrl, #sequence_number, #subtype, #to_ds, #type, #wep

Instance Method Summary collapse

Methods inherited from PacketGen::Header::Dot11

#added_to_packet, #attributes, #calc_checksum, #human_type, #inspect, #old_attributes, #old_read, #read, #to_s, #to_w

Methods inherited from Base

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

Methods included from PacketGen::Headerable

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

Constructor Details

#initialize(options = {}) ⇒ Management

Returns a new instance of Management.

Parameters:

  • options (Hash) (defaults to: {})

See Also:

Since:

  • 1.4.0



48
49
50
51
52
 
# File 'lib/packetgen/header/dot11/management.rb', line 48

def initialize(options={})
  super({ type: 0 }.merge!(options))
  @applicable_attributes -= %i[mac4 qos_ctrl ht_ctrl]
  define_applicable_attributes
end

Instance Method Details

#add_element(type:, value:) ⇒ self

Add an Element to header in body (for example, a Beacon)

Parameters:

  • type (Integer, String) —

    element type

  • value (Object) —

    element value

Returns:

  • (self)

Raises:

Since:

  • 2.1.3



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

def add_element(type:, value:)
  raise FormatError, 'Before adding an Element, you have to add a Dot11::SubMngt subclass instance' unless self[:body].is_a?(SubMngt)

  self[:body].elements << { type: type, value: value }
  self
end

#reply! ⇒ self

Invert mac1 and mac2 (resp. destination address and source address).

Returns:

  • (self)

Since:

  • 1.4.0



68
69
70
 
# File 'lib/packetgen/header/dot11/management.rb', line 68

def reply!
  self[:mac1], self[:mac2] = self[:mac2], self[:mac1]
end