Class: PacketGen::Header::HTTP::Request

Inherits:
Base show all
Defined in:
lib/packetgen/header/http/request.rb

Overview

An HTTP/1.1 Request packet consists of:

Create a HTTP Request header

# standalone
http_rqst = PacketGen::Header::HTTP::Request.new
# in a packet
pkt = PacketGen.gen("IP").add("TCP").add("HTTP::Request")
# access to HTTP Request header
pkt.http_request # => PacketGen::Header::HTTP::Request

Note: When creating a HTTP Request packet, sport and dport attributes of TCP header are not set.

HTTP Request attributes

http_rqst.version = "HTTP/1.1"
http_rqst.verb  = "GET"
http_rqst.path    = "/meow.html"
http_rqst.headers = "Host: tcpdump.org"     # string or
http_rqst.headers = { "Host": "tcpdump.org" } # even a hash

Author:

  • Kent ‘picat’ Gruber

  • Sylvain Daubert

Since:

  • 3.1.0 Rename #method into #verb to not mask Object#method.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Base

bind, calculate_and_set_length, #header_id, inherited, #ip_header, known_headers, #ll_header

Methods included from PacketGen::Headerable

#added_to_packet, included, #method_name, #packet, #packet=, #parse?, #protocol_name

Methods inherited from Types::Fields

#[], #[]=, #bits_on, define_bit_fields_on, define_field, define_field_after, define_field_before, #fields, fields, inherited, #inspect, #offset_of, #optional?, #optional_fields, #present?, remove_bit_fields_on, remove_field, #sz, #to_h, update_field

Constructor Details

#initialize(options = {}) ⇒ Request

Returns a new instance of Request.

Parameters:

  • options (Hash) (defaults to: {})

Options Hash (options):

  • :verb (String)
  • :path (String)
  • :version (String)
  • :headers (Hash)

Since:

  • 3.1.0 Rename #method into #verb to not mask Object#method.



62
63
64
65
 
# File 'lib/packetgen/header/http/request.rb', line 62

def initialize(options={})
  super(options)
  self.headers ||= options[:headers]
end

Instance Attribute Details

#body ⇒ Types::String

Returns:



55
 
# File 'lib/packetgen/header/http/request.rb', line 55

define_field :body, Types::String

#headers ⇒ HTTP::Headers

associated http/1.1 headers

Returns:



52
 
# File 'lib/packetgen/header/http/request.rb', line 52

define_field :headers, HTTP::Headers

#path ⇒ Types::String

Returns:



45
 
# File 'lib/packetgen/header/http/request.rb', line 45

define_field :path,    Types::String

#verb ⇒ Types::String

Returns:

Since:

  • 3.1.0



42
 
# File 'lib/packetgen/header/http/request.rb', line 42

define_field :verb,  Types::String

#version ⇒ Types::String

Returns:



48
 
# File 'lib/packetgen/header/http/request.rb', line 48

define_field :version, Types::String, default: 'HTTP/1.1'

Instance Method Details

#read(str) ⇒ PacketGen::HTTP::Request

Read in the HTTP portion of the packet, and parse it.

Returns:

  • (PacketGen::HTTP::Request)

Since:

  • 3.1.0 Rename #method into #verb to not mask Object#method.



69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
 
# File 'lib/packetgen/header/http/request.rb', line 69

def read(str)
  str = str.bytes.map!(&:chr).join unless str.valid_encoding?
  vrb = HTTP::VERBS.detect { |verb| str.include?(verb) }
  str = vrb + str.split(vrb)[-1]
  str = str.split("\n").map(&:chomp)
  first_line = str.shift.split
  self[:verb].read first_line[0]
  self[:path].read first_line[1]
  self[:version].read first_line[2]
  # requests can sometimes have a payload
  if (data_index = str.find_index(''))
    data    = str[data_index + 1..-1].join("\n")
    headers = str[0..data_index - 1].join("\n")
  else
    headers = str.join("\n")
  end
  self[:headers].read(headers)
  self[:body].read data
  self
end

#to_s ⇒ String

String representation of data.

Returns:

  • (String)

Raises:

Since:

  • 3.1.0 Rename #method into #verb to not mask Object#method.



92
93
94
95
96
97
98
99
 
# File 'lib/packetgen/header/http/request.rb', line 92

def to_s
  raise FormatError, 'Missing #verb.'  if self.verb.empty?
  raise FormatError, 'Missing #path.'    if self.path.empty?
  raise FormatError, 'Missing #version.' if self.version.empty?

  str = ''.dup # build 'dat string
  str << self[:verb] << ' ' << self[:path] << ' ' << self[:version] << "\r\n" << self[:headers].to_s << self[:body]
end