Class: PacketGen::Header::IGMPv3::GroupRecord

Inherits:
BinStruct::Struct
  • Object
show all
Includes:
BinStruct::Structable
Defined in:
lib/packetgen/header/igmpv3/group_record.rb

Overview

Class to handle IGMPv3 Group Records.

A Group Record is a block of attributes containing information pertaining to the sender’s membership in a single multicast group on the interface from which the Report is sent.

A Group Record 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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  Record Type  |  Aux Data Len |     Number of Sources (N)     |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                       Multicast Address                       |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                       Source Address [1]                      |
+-                                                             -+
|                       Source Address [2]                      |
+-                                                             -+
.                               .                               .
.                               .                               .
.                               .                               .
+-                                                             -+
|                       Source Address [N]                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
.                                                               .
.                         Auxiliary Data                        .
.                                                               .
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Author:

  • Sylvain Daubert

Since:

  • 2.4.0

Constant Summary collapse

RECORD_TYPES =

Known record types

Since:

  • 2.4.0

{
  'MODE_IS_INCLUDE' => 1,
  'MODE_IS_EXCLUDE' => 2,
  'CHANGE_TO_INCLUDE_MODE' => 3,
  'CHANGE_TO_EXCLUDE_MODE' => 4,
  'ALLOW_NEW_SOURCES' => 5,
  'BLOCK_OLD_SOURCES' => 6
}.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#aux_data ⇒ Object

Not used in IGMPv3



81
82
 
# File 'lib/packetgen/header/igmpv3/group_record.rb', line 81

define_attr :aux_data, BinStruct::String,
builder: ->(h, t) { t.new(length_from: -> { h[:aux_data_len].to_i * 4 }) }

#aux_data_len ⇒ Integer

8-bit length of of the Auxiliary Data field (#aux_data), in unit of 32-bit words

Returns:

  • (Integer) 


64
 
# File 'lib/packetgen/header/igmpv3/group_record.rb', line 64

define_attr :aux_data_len, BinStruct::Int8, default: 0

#multicast_addr ⇒ IP::Addr

IP multicast address to which this Group Record pertains

Returns:



72
 
# File 'lib/packetgen/header/igmpv3/group_record.rb', line 72

define_attr :multicast_addr, IP::Addr, default: '0.0.0.0'

#number_of_sources ⇒ Integer

16-bit Number of source addresses in #source_addr

Returns:

  • (Integer) 


68
 
# File 'lib/packetgen/header/igmpv3/group_record.rb', line 68

define_attr :number_of_sources, BinStruct::Int16, default: 0

#source_addr ⇒ IP::ArrayOfAddr

Array of source addresses

Returns:



76
77
 
# File 'lib/packetgen/header/igmpv3/group_record.rb', line 76

define_attr :source_addr, IP::ArrayOfAddr,
builder: ->(h, t) { t.new(counter: h[:number_of_sources]) }

#type ⇒ Integer

8-bit record type

Returns:

  • (Integer) 


59
 
# File 'lib/packetgen/header/igmpv3/group_record.rb', line 59

define_attr :type, BinStruct::Int8Enum, enum: RECORD_TYPES

Instance Method Details

#human_type ⇒ String

Human-readable type

Returns:

  • (String)

Since:

  • 2.4.0



86
87
88
 
# File 'lib/packetgen/header/igmpv3/group_record.rb', line 86

def human_type
  self[:type].to_human
end

#to_human ⇒ String

Human-readable description of a group record

Returns:

  • (String)

Since:

  • 2.4.0



92
93
94
 
# File 'lib/packetgen/header/igmpv3/group_record.rb', line 92

def to_human
  "#{human_type}(ma:#{multicast_addr}|src:#{source_addr.to_human})"
end