Class: PacketGen::Header::DNS::OPT

Inherits:
RR show all
Defined in:
lib/packetgen/header/dns/opt.rb

Overview

OPT pseudo-RR. Used by Extended DNS (EDNS(0), cf. RFC 6891).

a OPT record may contain zero or more options in its RR#rdata.

Author:

  • Sylvain Daubert

Since:

Constant Summary

Constants inherited from Question

Question::CLASSES, Question::TYPES

Instance Attribute Summary collapse

Attributes inherited from RR

#rdata, #rdlength, #ttl

Attributes inherited from Question

#name, #rrclass, #type

Instance Method Summary collapse

Methods inherited from RR

#human_rdata, #human_rrclass

Methods inherited from Question

#human_rrclass, #human_type, #type?

Methods included from Types::Fieldable

#format_inspect, #read, #sz, #to_s, #type_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?, #read, remove_bit_fields_on, remove_field, #sz, #to_h, #to_s, update_field

Constructor Details

#initialize(dns, options = {}) ⇒ OPT

Returns a new instance of OPT.

Parameters:

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

Options Hash (options):

  • :name (String) —

    domain as a dotted string. Default to “.”

  • :type (Integer, String) —

    see Question::TYPES. Default to ‘OPT’

  • :udp_size (Integer) —

    UDP maximum size. Also :rrclass. Default to 512.

  • :ext_rcode (Integer)
  • :version (Integer)
  • :do (Boolean) —

    DO bit

  • :ttl (Integer) —

    set ext_rcode, version, do and z at once

  • :rdlength (Integer) —

    if not provided, automatically set from :rdata length

  • :rdata (String)

Since:



38
39
40
41
42
43
44
45
46
 
# File 'lib/packetgen/header/dns/opt.rb', line 38

def initialize(dns, options={})
  opts = { name: '.', rrclass: 512, type: 41 }.merge!(options)
  super dns, opts

  self.udp_size = options[:udp_size] if options[:udp_size]
  self.ext_rcode = options[:ext_rcode] if options[:ext_rcode]
  self.version = options[:version] if options[:version]
  self.do = options[:do] unless options[:do].nil?
end

Instance Attribute Details

#options ⇒ ArrayOfOptions

Returns:



22
 
# File 'lib/packetgen/header/dns/opt.rb', line 22

define_field_after :rdata, :options, ArrayOfOptions

Instance Method Details

#do=(value) ⇒ Boolean #do? ⇒ Boolean Also known as: do?

Overloads:

  • #do=(value) ⇒ Boolean

    Setter EDNS do

    Parameters:

    • value (Boolean)

    Returns:

    • (Boolean)
  • #do? ⇒ Boolean

    Getter for EDNS do

    Returns:

    • (Boolean)

Returns:

  • (Boolean)

Since:



90
91
92
93
94
95
96
97
 
# File 'lib/packetgen/header/dns/opt.rb', line 90

def do=(value=nil)
  b = value ? 1 : 0
  unless value.nil?
    self[:ttl].value = self[:ttl].to_i & (0xffffffff & ~(1 << 15))
    self[:ttl].value |= (b & 1) << 15
  end
  ((self[:ttl].to_i >> 15) & 1) == 1
end

#ext_rcode=(value) ⇒ Integer #ext_rcode ⇒ Integer Also known as: ext_rcode

Overloads:

  • #ext_rcode=(value) ⇒ Integer

    Setter for upper 8 bits of extended 12-bit RCODE

    Parameters:

    • value (Integer)

    Returns:

    • (Integer)
  • #ext_rcode ⇒ Integer

    Getter for upper 8 bits of extended 12-bit RCODE

    Returns:

    • (Integer)

Returns:

  • (Integer)

Since:



56
57
58
59
60
61
62
 
# File 'lib/packetgen/header/dns/opt.rb', line 56

def ext_rcode=(value=nil)
  if value
    self[:ttl].value = self[:ttl].to_i & (0xffffffff & ~(0xff << 24))
    self[:ttl].value |= (value & 0xff) << 24
  end
  (self[:ttl].to_i >> 24) & 0xff
end

#human_flags ⇒ String

Returns:

  • (String)

Since:



121
122
123
 
# File 'lib/packetgen/header/dns/opt.rb', line 121

def human_flags
  do? ? 'do' : 'none'
end

#to_human ⇒ String

Returns:

  • (String)

Since:



126
127
128
129
130
 
# File 'lib/packetgen/header/dns/opt.rb', line 126

def to_human
  "#{name} #{human_type} UDPsize:#{udp_size} " \
    "extRCODE:#{ext_rcode} EDNSversion:#{version} flags:#{human_flags} " \
    "options:#{options.empty? ? 'none' : options.to_human}"
end

#version=(ver) ⇒ Integer #version ⇒ Integer Also known as: version

Overloads:

  • #version=(ver) ⇒ Integer

    Setter EDNS version

    Parameters:

    • ver (Integer)

    Returns:

    • (Integer)
  • #version ⇒ Integer

    Getter for EDNS version

    Returns:

    • (Integer)

Returns:

  • (Integer)

Since:



73
74
75
76
77
78
79
 
# File 'lib/packetgen/header/dns/opt.rb', line 73

def version=(ver=nil)
  if ver
    self[:ttl].value = self[:ttl].to_i & (0xffffffff & ~(0xff << 16))
    self[:ttl].value |= (ver & 0xff) << 16
  end
  (self[:ttl].to_i >> 16) & 0xff
end

#z=(value) ⇒ Integer #z ⇒ Integer Also known as: z

Overloads:

  • #z=(value) ⇒ Integer

    Parameters:

    • value (Integer)

    Returns:

    • (Integer)
  • #z ⇒ Integer

    Returns:

    • (Integer)

Returns:

  • (Integer)

Since:



106
107
108
109
110
111
112
 
# File 'lib/packetgen/header/dns/opt.rb', line 106

def z=(value=nil)
  if value
    self[:ttl].value = self[:ttl].to_i & (0xffffffff & ~0x7fff)
    self[:ttl].value |= value & 0x7fff
  end
  self[:ttl].to_i & 0x7fff
end