Class: ReDNS::Name

Inherits:
Fragment show all
Defined in:
lib/redns/name.rb

Instance Attribute Summary

Attributes inherited from Fragment

#attributes

Instance Method Summary collapse

Methods inherited from Fragment

attribute

Methods included from Support

#addr_to_arpa, #bind_all_addr, #default_nameservers, #default_resolver_address, #dns_port, #inet_aton, #inet_ntoa, #io_nonblock, #io_nonblock?, #io_set_nonblock, #is_ip?

Constructor Details

#initialize(contents = nil) ⇒ Name

Instance Methods =====================================================



8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
# File 'lib/redns/name.rb', line 8

def initialize(contents = nil)
  case (contents)
  when ReDNS::Buffer
    # Ensure that this String subclass is handled using the default
    # method, not intercepted and treated as an actual String
    super(contents)
  when String
    super(:name => contents)
    
    unless (ReDNS::Support.is_ip?(name) or self.name.match(/\.$/))
      self.name += '.'
    end
  else
    super(contents)
  end
end

Instance Method Details

#deserialize(buffer) ⇒ Object 



51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/redns/name.rb', line 51

def deserialize(buffer)
  self.name = ''
  
  return_to_offset = nil

   while (c = buffer.unpack('C')[0])
     if (c & 0xC0 == 0xC0)
       # This is part of a pointer to another section, so advance to that
       # point and read from there, but preserve the position where the
       # pointer was found to leave the buffer in that final state.

       pointer = (c & 0x3F << 8) | buffer.unpack('C')[0]

       return_to_offset ||= buffer.offset
       buffer.rewind
       buffer.advance(pointer)
     elsif (c == 0)
       break
     else
       if (read = buffer.read(c))
         name << read
         name << '.'
       else
         break
       end
     end
   end
   
   if (return_to_offset)
     buffer.rewind
     buffer.advance(return_to_offset)
   end
   
   self
end

#empty? ⇒ Boolean

Returns:

  • (Boolean) 


37
38
39
 
# File 'lib/redns/name.rb', line 37

def empty?
  name == '.'
end

#length ⇒ Object 



33
34
35
 
# File 'lib/redns/name.rb', line 33

def length
  to_s.length
end

#serialize(buffer = ReDNS::Buffer.new) ⇒ Object 



41
42
43
44
45
46
47
48
49
 
# File 'lib/redns/name.rb', line 41

def serialize(buffer = ReDNS::Buffer.new)
  buffer.append(
    self.name.split(/\./).collect { |l| [ l.length, l ].pack("ca*") }.join('')
  )

  buffer.append("\0")
  
  buffer
end

#to_a ⇒ Object 



29
30
31
 
# File 'lib/redns/name.rb', line 29

def to_a
  [ self.name ]
end

#to_s ⇒ Object 



25
26
27
 
# File 'lib/redns/name.rb', line 25

def to_s
  self.name
end