Class: PacketGen::Header::DHCPv6::Option

Inherits:
Types::Fields show all
Defined in:
lib/packetgen/header/dhcpv6/option.rb

Overview

A DHCPv6 consists of:

Subclasses handles known options. These subclasses may remove #data field to replace it by specific option field(s).

Author:

  • Sylvain Daubert

Since:

  • 2.5.0

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Types::Fields

#[], #[]=, #bits_on, define_bit_fields_on, define_field, define_field_after, define_field_before, #fields, fields, inherited, #inspect, #offset_of, #optional?, #optional_fields, #present?, #read, remove_bit_fields_on, remove_field, #sz, #to_h, #to_s, update_field

Constructor Details

#initialize(options = {}) ⇒ Option

Create an Option

Parameters:

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

Since:

  • 2.5.0



76
77
78
79
80
 
# File 'lib/packetgen/header/dhcpv6/option.rb', line 76

def initialize(options={})
  options[:length] = options[:data].to_s.size if options[:data]
  super
  self.length = self.sz - 4 if options[:data].nil?
end

Instance Attribute Details

#data ⇒ String

variable length option data.

Returns:

  • (String) 


31
32
 
# File 'lib/packetgen/header/dhcpv6/option.rb', line 31

define_field :data, Types::String,
builder: ->(h, t) { t.new(length_from: h[:length]) }

#length ⇒ Integer

16-bit option length

Returns:

  • (Integer) 


27
 
# File 'lib/packetgen/header/dhcpv6/option.rb', line 27

define_field :length, Types::Int16

#type ⇒ Integer

16-bit option type

Returns:

  • (Integer) 


23
 
# File 'lib/packetgen/header/dhcpv6/option.rb', line 23

define_field :type, Types::Int16

Class Method Details

.new(options = {}) ⇒ Option

Create a new Option object (or a subclass)

Parameters:

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

Returns:

Since:

  • 2.5.0



53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
 
# File 'lib/packetgen/header/dhcpv6/option.rb', line 53

def new(options={})
  if self == Option
    case options[:type]
    when Integer
      klass = Option.subclasses[options[:type]]
      klass.new(options) if klass
    when String
      if DHCPv6.const_defined?(options[:type])
        klass = DHCPv6.const_get(options[:type])
        options.delete :type
        klass.new(options) if klass < Option
      end
    else
      super
    end
  else
    super
  end
end

.subclasses ⇒ Hash

Get Option subclasses

Returns:

  • (Hash)

Since:

  • 2.5.0



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

def subclasses
  return @klasses if defined? @klasses

  @klasses = []
  DHCPv6.constants.each do |cst|
    klass = DHCPv6.const_get(cst)
    next unless klass.is_a?(Class) && (klass < Option)

    @klasses[klass.new.type] = klass
  end
  @klasses
end

Instance Method Details

#human_type ⇒ String

Get human-readable #type

Returns:

  • (String)

Since:

  • 2.5.0



87
88
89
90
91
92
93
 
# File 'lib/packetgen/header/dhcpv6/option.rb', line 87

def human_type
  if self.class == Option
    "option#{type}"
  else
    self.class.to_s.sub(/.*::/, '')
  end
end

#to_human ⇒ String

Get a human-readable string for this option

Returns:

  • (String)

Since:

  • 2.5.0



97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/packetgen/header/dhcpv6/option.rb', line 97

def to_human
  str = "#{human_type}:".dup
  if respond_to?(:human_data) && !human_data.empty?
    str << human_data
  elsif !self[:data].nil?
    str << data.inspect
  else
    # No data: only give option name
    human_type
  end
end