Class: PacketFu::IPPacket

Inherits:
Packet
  • Object
show all
Includes:
EthHeaderMixin, IPHeaderMixin
Defined in:
lib/packetfu/protos/ip.rb

Overview

IPPacket is used to construct IP packets. They contain an EthHeader, an IPHeader, and usually a transport-layer protocol such as UDPHeader, TCPHeader, or ICMPHeader.

Example

require 'packetfu'
ip_pkt = PacketFu::IPPacket.new
ip_pkt.ip_saddr="10.20.30.40"
ip_pkt.ip_daddr="192.168.1.1"
ip_pkt.ip_proto=1
ip_pkt.ip_ttl=64
ip_pkt.ip_payload="\x00\x00\x12\x34\x00\x01\x00\x01"+
  "Lovingly hand-crafted echo responses delivered directly to your door."
ip_pkt.recalc 
ip_pkt.to_f('/tmp/ip.pcap')

Parameters

:eth
  A pre-generated EthHeader object.
:ip
  A pre-generated IPHeader object.
:flavor
  TODO: Sets the "flavor" of the IP packet. This might include known sets of IP options, and
  certainly known starting TTLs.
:config
  A hash of return address details, often the output of Utils.whoami?

Instance Attribute Summary collapse

Attributes inherited from Packet

#flavor, #headers, #iface, #inspect_style

Class Method Summary collapse

Instance Method Summary collapse

Methods included from IPHeaderMixin

#ip_calc_id, #ip_calc_len, #ip_calc_sum, #ip_daddr, #ip_daddr=, #ip_dst, #ip_dst=, #ip_dst_readable, #ip_frag, #ip_frag=, #ip_hl, #ip_hl=, #ip_hlen, #ip_id, #ip_id=, #ip_id_readable, #ip_len, #ip_len=, #ip_proto, #ip_proto=, #ip_recalc, #ip_saddr, #ip_saddr=, #ip_src, #ip_src=, #ip_src_readable, #ip_sum, #ip_sum=, #ip_sum_readable, #ip_tos, #ip_tos=, #ip_ttl, #ip_ttl=, #ip_v, #ip_v=

Methods included from EthHeaderMixin

#eth_daddr, #eth_daddr=, #eth_dst, #eth_dst=, #eth_dst_readable, #eth_proto, #eth_proto=, #eth_proto_readable, #eth_saddr, #eth_saddr=, #eth_src, #eth_src=, #eth_src_readable

Methods inherited from Packet

#==, #clone, #dissect, #dissection_table, force_binary, #handle_is_identity, #hexify, inherited, #inspect, #inspect_hex, #kind_of?, #layer, layer, layer_symbol, #layer_symbol, #method_missing, #orig_kind_of?, parse, #payload, #payload=, #peek, #proto, #recalc, #respond_to?, #size, #to_f, #to_pcap, #to_s, #to_w, #write

Constructor Details

#initialize(args = {}) ⇒ IPPacket

Creates a new IPPacket object.


66
67
68
69
70
71
72
73
# File 'lib/packetfu/protos/ip.rb', line 66

def initialize(args={})
  @eth_header = EthHeader.new(args).read(args[:eth])
  @ip_header = IPHeader.new(args).read(args[:ip])
  @eth_header.body=@ip_header

  @headers = [@eth_header, @ip_header]
  super
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class PacketFu::Packet

Instance Attribute Details

#eth_headerObject

Returns the value of attribute eth_header


41
42
43
# File 'lib/packetfu/protos/ip.rb', line 41

def eth_header
  @eth_header
end

#ip_headerObject

Returns the value of attribute ip_header


41
42
43
# File 'lib/packetfu/protos/ip.rb', line 41

def ip_header
  @ip_header
end

Class Method Details

.can_parse?(str) ⇒ Boolean

Returns:

  • (Boolean)

43
44
45
46
47
48
49
50
51
52
53
54
55
56
# File 'lib/packetfu/protos/ip.rb', line 43

def self.can_parse?(str)
  return false unless str.size >= 34
  return false unless EthPacket.can_parse? str
  if str[12,2] == "\x08\x00"
    if 1.respond_to? :ord
      ipv = str[14,1][0].ord >> 4
    else
      ipv = str[14,1][0] >> 4
    end
    return true if ipv == 4 
  else
    return false
  end
end

Instance Method Details

#peek_formatObject

Peek provides summary data on packet contents.


76
77
78
79
80
81
82
83
84
85
# File 'lib/packetfu/protos/ip.rb', line 76

def peek_format
  peek_data = ["I  "]
  peek_data << "%-5d" % to_s.size
  peek_data << "%-21s" % "#{ip_saddr}"
  peek_data << "->"
  peek_data << "%21s" % "#{ip_daddr}"
  peek_data << "%23s" % "I:"
  peek_data << "%04x" % ip_id.to_i
  peek_data.join
end

#read(str = nil, args = {}) ⇒ Object


58
59
60
61
62
63
# File 'lib/packetfu/protos/ip.rb', line 58

def read(str=nil, args={})
  raise "Cannot parse `#{str}'" unless self.class.can_parse?(str)
  @eth_header.read(str)
  super(args) 
  self
end