Class: PacketGen::Header::OSPFv3::Hello

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

Overview

This class handles OSPFv3 HELLO packets payload. The HELLO payload has the following format:

 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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                        Interface ID                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Rtr Priority  |             Options                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|        HelloInterval          |       RouterDeadInterval      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                   Designated Router ID                        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                Backup Designated Router ID                    |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                         Neighbor ID                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                        ...                                    |

A HELLO payload consists of:

Create a HELLO payload

# standalone
hello = PacketGen::Header::OSPFv3::Hello.new
# in a packet
pkt = PacketGen.gen('IPv6', src: source_ip).add('OSPFv3').add('OSPFv3::Hello')
# make IPv6 header correct for OSPF
pkt.ospfize
# access to Hello payload
pkt.ospfv3_hello    # => PacketGen::Header::OSPFv3::Hello

HELLO attributes

hello.interface_id = 1
hello.priority = 1
# set options. Options may also be set one by one with #v6_opt, #e_opt,
# #n_opt, #r_opt and #dc_opt
hello.options = 0x33
hello.hello_interval = 10
hello.dead_interval = 300
hello.designated_router = '0.0.0.1'
hello.backup_designated_router = '0.0.0.2'
# set neighbors identifiers
hello.neighbors << '1.1.1.1'
hello.neighbors << '2.2.2.2'

Author:

  • Sylvain Daubert

Since:

  • 2.5.0

Instance Attribute Summary collapse

Method Summary

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, #read

Methods inherited from Types::Fields

#[], #[]=, #bits_on, define_bit_fields_on, define_field, define_field_after, define_field_before, #fields, fields, inherited, #initialize, #inspect, #offset_of, #optional?, #optional_fields, #present?, #read, 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

#backup_designated_routerString

The identity of the Backup Designated Router for this network, in the view of the sending router.

Returns:

  • (String)

92
# File 'lib/packetgen/header/ospfv3/hello.rb', line 92

define_field :backup_designated_router, IP::Addr

#dc_optBoolean

This bit describes the router's handling of demand circuits.

Returns:

  • (Boolean)

74
# File 'lib/packetgen/header/ospfv3/hello.rb', line 74

OSPFv3.define_options(self)

#dead_intervalInteger

The number of seconds before declaring a silent router down.

Returns:

  • (Integer)

82
# File 'lib/packetgen/header/ospfv3/hello.rb', line 82

define_field :dead_interval, Types::Int16

#designated_routerString

The identity of the Designated Router for this network, in the view of the sending router.

Returns:

  • (String)

87
# File 'lib/packetgen/header/ospfv3/hello.rb', line 87

define_field :designated_router, IP::Addr

#e_optBoolean

This bit describes the way AS-external-LSAs are flooded.

Returns:

  • (Boolean)

74
# File 'lib/packetgen/header/ospfv3/hello.rb', line 74

OSPFv3.define_options(self)

#hello_intervalInteger

The number of seconds between this router's Hello packets.

Returns:

  • (Integer)

78
# File 'lib/packetgen/header/ospfv3/hello.rb', line 78

define_field :hello_interval, Types::Int16

#interface_idString

The network mask associated with this interface.

Returns:

  • (String)

67
# File 'lib/packetgen/header/ospfv3/hello.rb', line 67

define_field :interface_id, Types::Int32

#n_optBoolean

This bit indicates whether or not the router is attached to an NSSA.

Returns:

  • (Boolean)

74
# File 'lib/packetgen/header/ospfv3/hello.rb', line 74

OSPFv3.define_options(self)

#neighborsIP::ArrayOfAddr

Array of neighbors

Returns:


96
# File 'lib/packetgen/header/ospfv3/hello.rb', line 96

define_field :neighbors, IP::ArrayOfAddr

#optionsInteger

24-bit options field. Handle #v6_opt, #e_opt, #x_opt, #n_opt, #r_opt and #dc_opt.

Returns:

  • (Integer)

74
# File 'lib/packetgen/header/ospfv3/hello.rb', line 74

OSPFv3.define_options(self)

#priorityInteger

This router's Router Priority. Used in (Backup) Designated Router election.

Returns:

  • (Integer)

72
# File 'lib/packetgen/header/ospfv3/hello.rb', line 72

define_field :priority, Types::Int8

#r_optBoolean

This bit indicates whether the originator is an active router.

Returns:

  • (Boolean)

74
# File 'lib/packetgen/header/ospfv3/hello.rb', line 74

OSPFv3.define_options(self)

#v6_optBoolean

If this bit is clear, the router/link should be excluded from IPv6 routing calculations.

Returns:

  • (Boolean)

74
# File 'lib/packetgen/header/ospfv3/hello.rb', line 74

OSPFv3.define_options(self)

#x_optBoolean

This bit should be set to 0, and ignored when received.

Returns:

  • (Boolean)

74
# File 'lib/packetgen/header/ospfv3/hello.rb', line 74

OSPFv3.define_options(self)