Contents

# coding: utf-8
# This file is part of PacketGen
# See https://github.com/sdaubert/packetgen for more informations
# Copyright (C) 2016 Sylvain Daubert <[e-mail]>
# This program is published under MIT license.

module PacketGen
  module Header
    class Dot11

      # IEEE 802.11 control frame header
      #
      # This class make a {Dot11} header with {#type} set to +1+
      # (control frame).
      #
      # A IEEE 802.11 control header consists of:
      # * a {#frame_ctrl} ({Types::Int16}),
      # * a {#id}/duration ({Types::Int16le}),
      # * a {#mac1} ({Eth::MacAddr}).
      # * sometimes a {#mac2} ({Eth::MacAddr}),
      # * a {#body} (a {Types::String} or another {Base} class),
      # * and a Frame check sequence ({#fcs}, of type {Types::Int32le}).
      # @author Sylvain Daubert
      class Control < Dot11

        # Control subtypes
        SUBTYPES = {
          7  => 'Wrapper',
          8  => 'Block Ack Request',
          9  => 'Block Ack',
          10 => 'PS-Poll',
          11 => 'RTS',
          12 => 'CTS',
          13 => 'Ack',
          14 => 'CF-End',
          15 => 'CF-End+CF-Ack'
        }.freeze

        # Control subtypes with mac2 field
        SUBTYPES_WITH_MAC2 = [9, 10, 11, 14, 15].freeze

        # @param [Hash] options
        # @see Base#initialize
        def initialize(options={})
          super({type: 1}.merge!(options))
          @applicable_fields -= %i(mac3 sequence_ctrl mac4 qos_ctrl ht_ctrl)
          define_applicable_fields
        end

        # Get human readable subtype
        # @return [String]
        def human_subtype
          SUBTYPES[subtype] || subtype.to_s
        end

        private

        def define_applicable_fields
          super
          if @applicable_fields.include? :mac2
            @applicable_fields -= %i(mac2) unless SUBTYPES_WITH_MAC2.include? self.subtype
          elsif SUBTYPES_WITH_MAC2.include? self.subtype
            @applicable_fields[3, 0] = :mac2
          end
        end
      end
    end
  end
end

Version data entries

5 entries across 5 versions & 1 rubygems

Version	Path
packetgen-2.4.0	lib/packetgen/header/dot11/control.rb
packetgen-2.3.0	lib/packetgen/header/dot11/control.rb
packetgen-2.2.0	lib/packetgen/header/dot11/control.rb
packetgen-2.1.4	lib/packetgen/header/dot11/control.rb
packetgen-2.1.3	lib/packetgen/header/dot11/control.rb