Class: Rex::Post::Meterpreter::Packet

Inherits:
GroupTlv show all
Defined in:
lib/rex/post/meterpreter/packet.rb

Overview

The logical meterpreter packet class

Instance Attribute Summary collapse

Attributes inherited from GroupTlv

#tlvs

Attributes inherited from Tlv

#compress, #type, #value

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from GroupTlv

#add_tlv, #add_tlvs, #each, #each_tlv, #each_tlv_with_index, #each_with_index, #from_r, #get_tlv, #get_tlv_value, #get_tlv_values, #get_tlvs, #has_tlv?, #reset, #to_r

Methods inherited from Tlv

#from_r, #inspect, #meta_type?, #to_r, #type?, #value?

Constructor Details

#initialize(type = nil, method = nil) ⇒ Packet

Initializes the packet to the supplied packet type and method, if any. If the packet is a request, a request identifier is created.



617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
 
# File 'lib/rex/post/meterpreter/packet.rb', line 617

def initialize(type = nil, method = nil)
	super(type)

	if (method)
		self.method = method
	end

	self.created_at = ::Time.now

	# If it's a request, generate a random request identifier
	if ((type == PACKET_TYPE_REQUEST) ||
	    (type == PACKET_TYPE_PLAIN_REQUEST))
		rid = ''

		32.times { |val| rid << rand(10).to_s }

		add_tlv(TLV_TYPE_REQUEST_ID, rid)
	end
end

Instance Attribute Details

#created_at ⇒ Object

Returns the value of attribute created_at.



573
574
575
 
# File 'lib/rex/post/meterpreter/packet.rb', line 573

def created_at
  @created_at
end

Class Method Details

.create_request(method = nil) ⇒ Object

Creates a request with the supplied method.



584
585
586
 
# File 'lib/rex/post/meterpreter/packet.rb', line 584

def Packet.create_request(method = nil)
	return Packet.new(PACKET_TYPE_REQUEST, method)
end

.create_response(request = nil) ⇒ Object

Creates a response to a request if one is provided.



591
592
593
594
595
596
597
598
599
600
601
602
603
604
 
# File 'lib/rex/post/meterpreter/packet.rb', line 591

def Packet.create_response(request = nil)
	response_type = PACKET_TYPE_RESPONSE
	method = nil

	if (request)
		if (request.type?(PACKET_TYPE_PLAIN_REQUEST))
			response_type = PACKET_TYPE_PLAIN_RESPONSE
		end

		method = request.method
	end

	return Packet.new(response_type, method)
end

Instance Method Details

#method ⇒ Object

Returns the value of the packet’s method TLV.



674
675
676
 
# File 'lib/rex/post/meterpreter/packet.rb', line 674

def method
	return get_tlv_value(TLV_TYPE_METHOD)
end

#method=(method) ⇒ Object

Sets the packet’s method TLV to the method supplied.



667
668
669
 
# File 'lib/rex/post/meterpreter/packet.rb', line 667

def method=(method)
	add_tlv(TLV_TYPE_METHOD, method, true)
end

#method?(method) ⇒ Boolean

Checks to see if the packet’s method is equal to the supplied method.

Returns:

  • (Boolean) 


660
661
662
 
# File 'lib/rex/post/meterpreter/packet.rb', line 660

def method?(method)
	return (get_tlv_value(TLV_TYPE_METHOD) == method)
end

#response? ⇒ Boolean

Checks to see if the packet is a response.

Returns:

  • (Boolean) 


646
647
648
649
 
# File 'lib/rex/post/meterpreter/packet.rb', line 646

def response?
	return ((self.type == PACKET_TYPE_RESPONSE) ||
	        (self.type == PACKET_TYPE_PLAIN_RESPONSE))
end

#result ⇒ Object

Gets the value of the packet’s result TLV.



696
697
698
 
# File 'lib/rex/post/meterpreter/packet.rb', line 696

def result
	return get_tlv_value(TLV_TYPE_RESULT)
end

#result=(result) ⇒ Object

Sets the packet’s result TLV.



689
690
691
 
# File 'lib/rex/post/meterpreter/packet.rb', line 689

def result=(result)
	add_tlv(TLV_TYPE_RESULT, result, true)
end

#result?(result) ⇒ Boolean

Checks to see if the packet’s result value is equal to the supplied result.

Returns:

  • (Boolean) 


682
683
684
 
# File 'lib/rex/post/meterpreter/packet.rb', line 682

def result?(result)
	return (get_tlv_value(TLV_TYPE_RESULT) == result)
end

#rid ⇒ Object

Gets the value of the packet’s request identifier TLV.



703
704
705
 
# File 'lib/rex/post/meterpreter/packet.rb', line 703

def rid
	return get_tlv_value(TLV_TYPE_REQUEST_ID)
end