Class: PacketGen::Header::UDP

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

Overview

A UDP header consists of:

Create a UDP header

# standalone
udp = PacketGen::Header::UDP.new
# in a packet
pkt = PAcketGen.gen('IP').eadd('UDP')
# access to IP header
pkt.udp    # => PacketGen::Header::UDP

UDP attributes

udp.sport = 65432
udp.dport = 53
udp.length = 43
udp.checksum = 0xffff
udp.body.read 'this is a UDP body'

Author:

  • Sylvain Daubert

Constant Summary collapse

IP_PROTOCOL =

IP protocol number for UDP

17

Instance Attribute Summary collapse

Attributes inherited from Base

#packet

Instance Method Summary collapse

Methods inherited from Base

#added_to_packet, bind, bind_header, calculate_and_set_length, #header_id, inherited, #ip_header, known_headers, #ll_header, #method_name, #parse?, #protocol_name, protocol_name

Methods inherited from Types::Fields

#[], #[]=, #bits_on, define_bit_fields_on, define_field, define_field_after, define_field_before, delete_field, #fields, fields, #force_binary, inherited, #inspect, #is_optional?, #is_present?, #offset_of, #optional?, #optional_fields, #present?, #read, remove_bit_fields_on, remove_field, #sz, #to_h, #to_s, update_field

Constructor Details

#initialize(options = {}) ⇒ UDP

Call {Base#initialize), and automagically compute length if :body option is set.



64
65
66
67
 
# File 'lib/packetgen/header/udp.rb', line 64

def initialize(options={})
  super
  self.length += self[:body].sz if self[:body].sz > 0
end

Instance Attribute Details

#body ⇒ Types::String, Header::Base

Returns:



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

define_field :body, Types::String

#checksum ⇒ Integer

16-bit UDP checksum

Returns:

  • (Integer) 


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

define_field :checksum, Types::Int16

#dport ⇒ Integer Also known as: destination_port

16-bit UDP destination port

Returns:

  • (Integer) 


44
 
# File 'lib/packetgen/header/udp.rb', line 44

define_field :dport, Types::Int16

#length ⇒ Integer

16-bit UDP length

Returns:

  • (Integer) 


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

define_field :length, Types::Int16, default: 8

#sport ⇒ Integer Also known as: source_port

16-bit UDP source port

Returns:

  • (Integer) 


40
 
# File 'lib/packetgen/header/udp.rb', line 40

define_field :sport, Types::Int16

Instance Method Details

#calc_checksum ⇒ Integer

Compute checksum and set checksum field

Returns:

  • (Integer) 


71
72
73
74
75
76
77
78
 
# File 'lib/packetgen/header/udp.rb', line 71

def calc_checksum
  ip = ip_header(self)
  sum = ip.pseudo_header_checksum
  sum += IP_PROTOCOL
  sum += self.sz
  sum += IP.sum16(self)
  self.checksum = IP.reduce_checksum(sum)
end

#calc_length ⇒ Integer

Compute length and set length field

Returns:

  • (Integer) 


82
83
84
 
# File 'lib/packetgen/header/udp.rb', line 82

def calc_length
  Base.calculate_and_set_length self
end

#reply! ⇒ self

Invert source and destination port numbers

Returns:

  • (self)

Since:

  • 2.7.0



89
90
91
92
 
# File 'lib/packetgen/header/udp.rb', line 89

def reply!
  self[:sport], self[:dport] = self[:dport], self[:sport]
  self
end