Class: PacketGen::Header::DHCPv6

Inherits:
Base
  • Object
show all
Defined in:
lib/packetgen/header/dhcpv6.rb,
lib/packetgen/header/dhcpv6.rb,
lib/packetgen/header/dhcpv6/duid.rb,
lib/packetgen/header/dhcpv6/relay.rb,
lib/packetgen/header/dhcpv6/option.rb,
lib/packetgen/header/dhcpv6/options.rb more...

Overview

Dynamic Host Configuration Protocol for IPv6, RFC 3315

 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|    msg-type   |               transaction-id                  |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
.                            options                            .
.                           (variable)                          .
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

A DHCPv6 header is made of:

Examples:

Create a DHCPv6 header

# standalone
dhcpv6 = PacketGen::Header::DHCPv6.new(msg_type: 'SOLLICIT')
# in a packet
pkt = PacketGen.gen('IPv6').add('UDP').add('DHCPv6', msg_type: 'SOLLICIT')
# access to DHCPv6 header from packet
pkt.dhcpv6.class    #=> PacketGen::Header::DHCPv6

Add options

# Options may be added by pushing a hash to #options:
dhcpv6 = PacketGen::Header::DHCPv6.new(msg_type: 'SOLLICIT')
dhcpv6.options << { type: 'Preference', value: 1 }

Author:

  • Sylvain Daubert

Since:

  • 2.5.0

Defined Under Namespace

Classes: ClientID, DUID, DUID_EN, DUID_LL, DUID_LLT, ElapsedTime, IAAddr, IANA, IATA, ORO, Option, Options, Preference, RapidCommit, Relay, RelayMessage, ServerID, ServerUnicast, StatusCode

Constant Summary collapse

UDP_CLIENT_PORT =

DHCPv6 UDP client port

Since:

  • 2.5.0

546
UDP_SERVER_PORT =

DHCPv6 UDP client port

Since:

  • 2.5.0

547
MESSAGE_TYPES =

DHCPv6 message types

Since:

  • 2.5.0

{
  'SOLLICIT' => 1,
  'ADVERTISE' => 2,
  'REQUEST' => 3,
  'CONFIRM' => 4,
  'RENEW' => 5,
  'REBIND' => 6,
  'REPLY' => 7,
  'RELEASE' => 8,
  'DECLINE' => 9,
  'RECONFIGURE' => 10,
  'INFORMATION-REQUEST' => 11
}.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Base

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

Methods included from PacketGen::Headerable

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

Constructor Details

This class inherits a constructor from PacketGen::Header::Base

Instance Attribute Details

#data ⇒ String

variable length option data.

Returns:

  • (String) 


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

#msg_type ⇒ Integer

8-bit message type

Returns:

  • (Integer) 

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

define_attr :msg_type, BinStruct::Int8Enum, enum: MESSAGE_TYPES

#options ⇒ DHCPv6::Options

Set of Options

Returns:


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

define_attr :options, DHCPv6::Options

#transaction_id ⇒ Integer

24-bit transaction ID

Returns:

  • (Integer) 

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

define_attr :transaction_id, BinStruct::Int24

Instance Method Details

#human_msg_type ⇒ String

Get human readable message type

Returns:

  • (String)

Since:

  • 2.5.0

[View source]

99
100
101
 
# File 'lib/packetgen/header/dhcpv6.rb', line 99

def human_msg_type
  self[:msg_type].to_human
end

#read(str) ⇒ DHCPv6, DHCPv6::Relay

Populate object from string

Parameters:

  • str (String)

Returns:

Since:

  • 2.5.0

[View source]

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

def read(str)
  msg_type = BinStruct::Int8.new.read(str)

  case msg_type
  when 12, 13
    DHCPv6::Relay.new.read(str)
  else
    super
  end
end