Class: Metasploit::Aggregator::Tlv::GroupTlv

Inherits:
Tlv
  • Object
show all
Defined in:
lib/metasploit/aggregator/tlv/packet.rb

Overview

Group TLVs contain zero or more TLVs

Direct Known Subclasses

Packet

Constant Summary

Constants inherited from Tlv

Tlv::HEADER_SIZE

Instance Attribute Summary collapse

Attributes inherited from Tlv

#compress, #type, #value

Instance Method Summary collapse

Methods inherited from Tlv

#inspect, #meta_type?, #type?, #value?

Constructor Details

#initialize(type) ⇒ GroupTlv

Initializes the group TLV container to the supplied type and creates an empty TLV array.



384
385
386
387
388
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 384

def initialize(type)
  super(type)

  self.tlvs = []
end

Instance Attribute Details

#tlvs ⇒ Object

Returns the value of attribute tlvs.



372
373
374
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 372

def tlvs
  @tlvs
end

Instance Method Details

#add_tlv(type, value = nil, replace = false, compress = false) ⇒ Object

Adds a TLV of a given type and value.



452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 452

def add_tlv(type, value = nil, replace = false, compress=false)

  # If we should replace any TLVs with the same type...remove them first
  if replace
    each(type) { |tlv|
      if (tlv.type == type)
        self.tlvs.delete(tlv)
      end
    }
  end

  if (type & TLV_META_TYPE_GROUP == TLV_META_TYPE_GROUP)
    tlv = GroupTlv.new(type)
  else
    tlv = Tlv.new(type, value, compress)
  end

  self.tlvs << tlv

  tlv
end

#add_tlvs(tlvs) ⇒ Object

Adds zero or more TLVs to the packet.



477
478
479
480
481
482
483
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 477

def add_tlvs(tlvs)
  if tlvs
    tlvs.each { |tlv|
      add_tlv(tlv['type'], tlv['value'])
    }
  end
end

#each(type = TLV_TYPE_ANY, &block) ⇒ Object

Enumerates TLVs of the supplied type.



399
400
401
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 399

def each(type = TLV_TYPE_ANY, &block)
  get_tlvs(type).each(&block)
end

#each_tlv(type = TLV_TYPE_ANY, &block) ⇒ Object

Synonym for each.



406
407
408
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 406

def each_tlv(type = TLV_TYPE_ANY, &block)
  each(type, &block)
end

#each_tlv_with_index(type = TLV_TYPE_ANY, &block) ⇒ Object

Synonym for each_with_index.



420
421
422
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 420

def each_tlv_with_index(type = TLV_TYPE_ANY, &block)
  each_with_index(type, block)
end

#each_with_index(type = TLV_TYPE_ANY, &block) ⇒ Object

Enumerates TLVs of a supplied type with indexes.



413
414
415
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 413

def each_with_index(type = TLV_TYPE_ANY, &block)
  get_tlvs(type).each_with_index(&block)
end

#from_r(raw) ⇒ Object

Converts the TLV group container from raw to all of the individual TLVs.



553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 553

def from_r(raw)
  offset = HEADER_SIZE

  # Reset the TLVs array
  self.tlvs = []
  self.type = raw.unpack("NN")[1]

  # Enumerate all of the TLVs
  while offset < raw.length-1

    tlv = nil

    # Get the length and type
    length, type = raw[offset..offset+HEADER_SIZE].unpack("NN")

    if (type & TLV_META_TYPE_GROUP == TLV_META_TYPE_GROUP)
      tlv = GroupTlv.new(type)
    else
      tlv = Tlv.new(type)
    end

    tlv.from_r(raw[offset..offset+length])

    # Insert it into the list of TLVs
    tlvs << tlv

    # Move up
    offset += length
  end
end

#get_tlv(type, index = 0) ⇒ Object

Gets the first TLV of a given type.



488
489
490
491
492
493
494
495
496
497
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 488

def get_tlv(type, index = 0)
  type_tlvs = get_tlvs(type)

  if type_tlvs.length > index
    type_tlvs[index]
  else
    nil
  end

end

#get_tlv_value(type, index = 0) ⇒ Object

Returns the value of a TLV if it exists, otherwise nil.



502
503
504
505
506
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 502

def get_tlv_value(type, index = 0)
  tlv = get_tlv(type, index)

  (tlv != nil) ? tlv.value : nil
end

#get_tlv_values(type) ⇒ Object

Returns an array of values for all tlvs of type type.



511
512
513
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 511

def get_tlv_values(type)
  get_tlvs(type).collect { |a| a.value }
end

#get_tlvs(type) ⇒ Object

Returns an array of TLVs for the given type.



427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 427

def get_tlvs(type)
  if type == TLV_TYPE_ANY
    self.tlvs
  else
    type_tlvs = []

    self.tlvs.each() { |tlv|
      if (tlv.type?(type))
        type_tlvs << tlv
      end
    }

    type_tlvs
  end
end

#has_tlv?(type) ⇒ Boolean

Checks to see if the container has a TLV of a given type.

Returns:

  • (Boolean) 


518
519
520
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 518

def has_tlv?(type)
  get_tlv(type) != nil
end

#reset ⇒ Object

Zeros out the array of TLVs.



525
526
527
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 525

def reset
  self.tlvs = []
end

#to_r ⇒ Object

Converts all of the TLVs in the TLV array to raw and prefixes them with a container TLV of this instance’s TLV type.



539
540
541
542
543
544
545
546
547
 
# File 'lib/metasploit/aggregator/tlv/packet.rb', line 539

def to_r
  raw = ''

  self.each() { |tlv|
    raw << tlv.to_r
  }

  [raw.length + HEADER_SIZE, self.type].pack("NN") + raw
end