Dnsruby 0.5.0

data/lib/Dnsruby/resource/NSAP.rb

@@ -0,0 +1,172 @@
+#--
+#Copyright 2007 Nominet UK
+#
+#Licensed under the Apache License, Version 2.0 (the "License");
+#you may not use this file except in compliance with the License. 
+#You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0 
+#
+#Unless required by applicable law or agreed to in writing, software 
+#distributed under the License is distributed on an "AS IS" BASIS, 
+#WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+#See the License for the specific language governing permissions and 
+#limitations under the License.
+#++
+module Dnsruby
+  class RR
+    #Class for DNS Network Service Access Point (NSAP) resource records.
+    #RFC 1706.
+    class NSAP < RR
+      ClassValue = nil #:nodoc: all
+      TypeValue= Types::NSAP #:nodoc: all
+      #The RR's authority and format identifier.  Dnsruby 
+      #currently supports only AFI 47 (GOSIP Version 2).
+      attr_accessor :afi
+      #The RR's initial domain identifier.
+      attr_accessor :idi
+      #The RR's DSP format identifier.
+      attr_accessor :dfi
+      #The RR's administrative authority.
+      attr_accessor :aa
+      #The RR's routing domain identifier.
+      attr_accessor :rd
+      #The RR's area identifier.
+      attr_accessor :area
+      #The RR's system identifier.
+      attr_accessor :id
+      #The RR's NSAP selector.
+      attr_accessor :sel
+      
+      #The RR's reserved field.
+      attr_writer :rsvd
+      
+      #The RR's initial domain part (the AFI and IDI fields).
+      def idp
+        ret = [@afi, @idi].join('')
+        return ret
+      end
+      
+      #The RR's domain specific part (the DFI, AA, Rsvd, RD, Area,
+      #ID, and SEL fields).
+      def dsp
+        ret = [@dfi,@aa,rsvd,@rd,@area,@id,@sel].join('')
+        return ret
+      end
+      
+      def rsvd
+        if (@rsvd==nil)
+          return "0000"
+        else
+          return @rsvd
+        end
+      end
+      
+      #------------------------------------------------------------------------------
+      # Usage:  str2bcd(STRING, NUM_BYTES)
+      #
+      # Takes a string representing a hex number of arbitrary length and
+      # returns an equivalent BCD string of NUM_BYTES length (with
+      # NUM_BYTES * 2 digits), adding leading zeros if necessary.
+      #------------------------------------------------------------------------------
+      def str2bcd(s, bytes)
+        retval = "";
+        
+        digits = bytes * 2;
+        string = sprintf("%#{digits}s", s);
+        string.tr!(" ","0");
+        
+        i=0;
+        bytes.times do
+          bcd = string[i*2, 2];
+          retval += [bcd.to_i(16)].pack("C");
+          i+=1
+        end
+        
+        return retval;
+      end
+      
+      
+      def from_data(data) #:nodoc: all
+        @afi, @idi, @dfi, @aa, @rsvd, @rd, @area, @id, @sel = data
+      end
+      
+      def from_string(s) #:nodoc: all
+        if (s)
+          string = s.gsub(/\./, "");  # remove all dots.
+          string.gsub!(/^0x/,"");  # remove leading 0x
+          
+          if (string =~ /^[a-zA-Z0-9]{40}$/)
+           (@afi, @idi, @dfi, @aa, @rsvd, @rd, @area, @id, @sel) = string.unpack("A2A4A2A6A4A4A4A12A2")
+          end
+        end
+        
+      end
+      
+      def rdata_to_string #:nodoc: all
+        rdatastr=""
+        
+        if (defined?@afi)
+          if (@afi == "47")
+            rdatastr = [idp, dsp].join('')
+          else
+            rdatastr = "; AFI #{@afi} not supported"
+          end
+        else
+          rdatastr = ''
+        end
+        
+        return rdatastr
+      end
+      
+      def encode_rdata(msg) #:nodoc: all
+        if (defined?@afi)
+          msg.put_pack("C", @afi.to_i(16))
+          
+          if (@afi == "47")
+            msg.put_bytes(str2bcd(@idi,  2))
+            msg.put_bytes(str2bcd(@dfi,  1))
+            msg.put_bytes(str2bcd(@aa,   3))
+            msg.put_bytes(str2bcd(0,               2))	# rsvd)
+            msg.put_bytes(str2bcd(@rd,   2))
+            msg.put_bytes(str2bcd(@area, 2))
+            msg.put_bytes(str2bcd(@id,   6))
+            msg.put_bytes(str2bcd(@sel,  1))
+          end            
+          # Checks for other versions would go here.
+        end
+        
+        return rdata
+      end
+      
+      def self.decode_rdata(msg) #:nodoc: all
+        afi = msg.get_unpack("C")[0]
+        afi = sprintf("%02x", afi)
+        
+        if (afi == "47")
+          idi = msg.get_unpack("CC")
+          dfi = msg.get_unpack("C")[0]
+          aa = msg.get_unpack("CCC")
+          rsvd = msg.get_unpack("CC")
+          rd = msg.get_unpack("CC")
+          area = msg.get_unpack("CC")
+          id = msg.get_unpack("CCCCCC")
+          sel = msg.get_unpack("C")[0]
+          
+          idi  = sprintf("%02x%02x", idi[0], idi[1])
+          dfi  = sprintf("%02x", dfi)
+          aa   = sprintf("%02x%02x%02x", aa[0], aa[1], aa[2])
+          rsvd = sprintf("%02x%02x", rsvd[0],rsvd[1])
+          rd   = sprintf("%02x%02x", rd[0],rd[1])
+          area = sprintf("%02x%02x", area[0],area[1])
+          id   = sprintf("%02x%02x%02x%02x%02x%02x", id[0],id[1],id[2],id[3],id[4],id[5])
+          sel  = sprintf("%02x", sel)
+          
+        else
+          # What to do for unsupported versions?
+        end
+        return self.new([afi, idi, dfi, aa, rsvd, rd, area, id, sel])
+      end
+    end
+  end
+end

data/lib/Dnsruby/resource/OPT.rb

@@ -0,0 +1,153 @@
+#--
+#Copyright 2007 Nominet UK
+#
+#Licensed under the Apache License, Version 2.0 (the "License");
+#you may not use this file except in compliance with the License. 
+#You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0 
+#
+#Unless required by applicable law or agreed to in writing, software 
+#distributed under the License is distributed on an "AS IS" BASIS, 
+#WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+#See the License for the specific language governing permissions and 
+#limitations under the License.
+#++
+module Dnsruby
+  class RR   
+    #Class for EDNS pseudo resource record OPT.
+    #This class is effectively internal to Dnsruby
+    #See RFC 2671, RFC 2435 Section 3
+    class OPT < RR #:nodoc: all
+      ClassValue = nil #:nodoc: all
+      TypeValue = Types::OPT #:nodoc: all
+      DO_BIT = 0x8000
+      attr_accessor :options
+      
+      # From RFC 2671 :
+      # 4.3. The fixed part of an OPT RR is structured as follows:
+      #
+      #     Field Name   Field Type     Description
+      #     ------------------------------------------------------
+      #     NAME         domain name    empty (root domain)
+      #     TYPE         u_int16_t      OPT
+      #     CLASS        u_int16_t      sender's UDP payload size
+      #     TTL          u_int32_t      extended RCODE and flags
+      #     RDLEN        u_int16_t      describes RDATA
+      #     RDATA        octet stream   {attribute,value} pairs
+      
+      def flags_from_ttl
+        if (@ttl)
+          return [@ttl].pack("N")
+        else
+          return [0].pack("N")
+        end
+      end
+      
+      def xrcode
+        return flags_from_ttl[0, 1].unpack("C")[0]
+      end
+      
+      def xrcode=(code)
+        @ttl = (code << 24) + (version() << 16) + flags()
+      end
+      
+      def version
+        return flags_from_ttl[1, 1].unpack("C")[0]
+      end
+      
+      def version=(code)
+        @ttl = (xrcode() << 24) + (code << 16) + flags()
+      end
+      
+      def flags
+        return flags_from_ttl[2, 2].unpack("n")[0]
+      end
+      
+      def flags=(code)
+        set_flags(code)
+      end
+      
+      def set_flags(code)
+        @ttl = (xrcode() << 24) + (version() << 16) + code
+      end
+      
+      def d_o
+        return ((flags() & DO_BIT) == DO_BIT)
+      end
+      
+      def d_o= (on)
+        if (on)
+          set_flags(flags() | DO_BIT)
+        else
+          set_flags(flags() & (~DO_BIT))
+        end
+      end
+      
+      attr_accessor :class
+      
+      def payloadsize
+        return @class
+      end
+      
+      def payloadsize=(size)
+        @class=size
+      end
+      
+      def options(args)
+        if (args==nil)
+          return @options
+        elsif args.kind_of?Fixnum
+          #@todo@ return list of options with that code
+        end
+      end
+      
+      def from_data(data)
+        @options = data
+      end
+      
+      def from_string(input)
+        if input
+          @options = input.split(" ")
+        end
+      end
+      
+      def rdata_to_string
+        ret = ""
+        if @options
+          @options.each do |opt|
+            ret = ret + opt.to_s + " "
+          end
+          ret.chomp!
+        end
+        return ret
+      end
+      
+      def encode_rdata(msg)
+        options.each do |opt|
+          msg.pack('n', opt.code)
+          msg.pack('n', opt.data.length)
+          msg.put_bytes(opt.data)
+        end
+        msg.put_array(@options)
+      end
+      
+      def self.decode_rdata(msg)
+        if (msg.has_remaining)
+          options = new ArrayList();
+          while (msg.has_remaining) do
+            code = msg.unpack('n');
+            len = msg.unpack('n');
+            data = msg.get_bytes(len);
+            options.add(Option.new(code, data));
+          end
+        end
+        return self.new([options])
+      end
+      
+      class Option
+        attr_accessor :code, :data
+      end
+    end
+  end
+end

data/lib/Dnsruby/resource/PX.rb

@@ -0,0 +1,71 @@
+#--
+#Copyright 2007 Nominet UK
+#
+#Licensed under the Apache License, Version 2.0 (the "License");
+#you may not use this file except in compliance with the License. 
+#You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0 
+#
+#Unless required by applicable law or agreed to in writing, software 
+#distributed under the License is distributed on an "AS IS" BASIS, 
+#WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+#See the License for the specific language governing permissions and 
+#limitations under the License.
+#++
+module Dnsruby
+  class RR   
+    module IN
+      class PX < RR
+        ClassHash[[TypeValue = Types::PX, ClassValue = Classes.IN.code]] = self #:nodoc: all
+        
+        #The preference given to this RR.
+        attr_accessor :preference
+        #The RFC822 part of the RFC1327 mapping information.
+        attr_accessor :map822
+        #The X.400 part of the RFC1327 mapping information.
+        attr_accessor :mapx400
+        
+        def from_hash(hash) #:nodoc: all
+          @preference = hash[:preference]
+          @map822 = Name.create(hash[:map822])
+          @mapx400 = Name.create(hash[:mapx400])
+        end
+        
+        def from_data(data) #:nodoc: all
+          @preference, @map822, @mapx400 = data
+        end
+        
+        def from_string(input) #:nodoc: all
+          if (input.length > 0)
+            names = input.split(" ")
+            @preference = names[0]
+            @map822 = Name.create(names[1])
+            @mapx400 = Name.create(names[2])
+          end
+        end
+        
+        def rdata_to_string #:nodoc: all
+          if (@preference!=nil)
+            return "#{@preference} #{@map822} #{@mapx400}"
+          else
+            return ""
+          end
+        end
+        
+        def encode_rdata(msg, canonical=false) #:nodoc: all
+          msg.put_pack('n', @preference)
+          msg.put_name(@map822, canonical)
+          msg.put_name(@mapx400, canonical)
+        end
+        
+        def self.decode_rdata(msg) #:nodoc: all
+          preference = msg.get_unpack('n')
+          map822 = msg.get_name
+          mapx400 = msg.get_name
+          return self.new([preference, map822, mapx400])
+        end
+      end
+    end
+  end
+end

data/lib/Dnsruby/resource/RP.rb

@@ -0,0 +1,67 @@
+#--
+#Copyright 2007 Nominet UK
+#
+#Licensed under the Apache License, Version 2.0 (the "License");
+#you may not use this file except in compliance with the License. 
+#You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0 
+#
+#Unless required by applicable law or agreed to in writing, software 
+#distributed under the License is distributed on an "AS IS" BASIS, 
+#WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+#See the License for the specific language governing permissions and 
+#limitations under the License.
+#++
+module Dnsruby
+  class RR   
+    #Class for DNS Responsible Person (RP) resource records.
+    #RFC 1183 Section 2.2
+    class RP < RR
+      ClassValue = nil #:nodoc: all
+      TypeValue = Types::RP #:nodoc: all
+      
+      #Returns a domain name that specifies the mailbox for the responsible person.
+      attr_accessor :mailbox
+      #A domain name that specifies a TXT record containing further
+      #information about the responsible person.
+      attr_accessor :txtdomain
+      
+      def from_hash(hash)
+        @mailbox = Name.create(hash[:mailbox])
+        @txtdomain = Name.create(hash[:txtdomain])
+      end
+      
+      def from_data(data) #:nodoc: all
+        @mailbox, @txtdomain= data
+      end
+      
+      def from_string(input) #:nodoc: all
+        if (input.length > 0)
+          names = input.split(" ")
+          @mailbox = Name.create(names[0])
+          @txtdomain = Name.create(names[1])
+        end
+      end
+      
+      def rdata_to_string #:nodoc: all
+        if (@mailbox!=nil)
+          return "#{@mailbox} #{@txtdomain}"
+        else
+          return ""
+        end
+      end
+      
+      def encode_rdata(msg, canonical=false) #:nodoc: all
+        msg.put_name(@mailbox, canonical)
+        msg.put_name(@txtdomain, canonical)
+      end
+      
+      def self.decode_rdata(msg) #:nodoc: all
+        mailbox = msg.get_name
+        txtdomain = msg.get_name
+        return self.new([mailbox, txtdomain])
+      end
+    end
+  end
+end

data/lib/Dnsruby/resource/RT.rb

@@ -0,0 +1,67 @@
+#--
+#Copyright 2007 Nominet UK
+#
+#Licensed under the Apache License, Version 2.0 (the "License");
+#you may not use this file except in compliance with the License. 
+#You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0 
+#
+#Unless required by applicable law or agreed to in writing, software 
+#distributed under the License is distributed on an "AS IS" BASIS, 
+#WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+#See the License for the specific language governing permissions and 
+#limitations under the License.
+#++
+module Dnsruby
+  class RR   
+    #Class for DNS Route Through (RT) resource records.
+    #RFC 1183 Section 3.3
+    class RT < RR
+      ClassValue = nil #:nodoc: all
+      TypeValue = Types::RT #:nodoc: all
+      
+      #The preference for this route.
+      attr_accessor :preference
+      
+      #The domain name of the intermediate host.
+      attr_accessor :intermediate
+      
+      def from_hash(hash) #:nodoc: all
+        @preference = hash[:preference]
+        @intermediate = Name.create(hash[:intermediate])
+      end
+      
+      def from_data(data) #:nodoc: all
+        @preference, @intermediate = data
+      end
+      
+      def from_string(input) #:nodoc: all
+        if (input.length > 0)
+          names = input.split(" ")
+          @preference = names[0]
+          @intermediate = Name.create(names[1])
+        end
+      end
+      
+      def rdata_to_string #:nodoc: all
+        if (@preference!=nil)
+          return "#{@preference} #{@intermediate}"
+        else
+          return ""
+        end
+      end
+      
+      def encode_rdata(msg, canonical = false) #:nodoc: all
+        msg.put_pack('n', @preference)
+        msg.put_name(@intermediate, canonical)
+      end
+      
+      def self.decode_rdata(msg) #:nodoc: all
+        preference = msg.get_unpack('n')
+        intermediate = msg.get_name
+        return self.new([preference, intermediate])
+      end
+    end
+  end
+end

data/lib/Dnsruby/resource/SOA.rb

@@ -0,0 +1,89 @@
+#--
+#Copyright 2007 Nominet UK
+#
+#Licensed under the Apache License, Version 2.0 (the "License");
+#you may not use this file except in compliance with the License. 
+#You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0 
+#
+#Unless required by applicable law or agreed to in writing, software 
+#distributed under the License is distributed on an "AS IS" BASIS, 
+#WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+#See the License for the specific language governing permissions and 
+#limitations under the License.
+#++
+module Dnsruby
+  class RR
+    class SOA < RR
+      ClassValue = nil #:nodoc: all
+      TypeValue = Types::SOA #:nodoc: all
+      
+      #The domain name of the original or primary nameserver for
+      #this zone.
+      attr_accessor :mname
+      #A domain name that specifies the mailbox for the person
+      #responsible for this zone.
+      attr_accessor :rname
+      #The zone's serial number.
+      attr_accessor :serial
+      #The zone's refresh interval.
+      attr_accessor :refresh
+      #The zone's retry interval.
+      attr_accessor :retry
+      #The zone's expire interval.
+      attr_accessor :expire
+      #The minimum (default) TTL for records in this zone.
+      attr_accessor :minimum
+      
+      def from_data(data) #:nodoc: all
+        @mname, @rname, @serial, @refresh, @retry, @expire, @minimum = data
+      end
+      
+      def from_hash(hash)
+        @mname = Name.create(hash[:mname])
+        @rname = Name.create(hash[:rname])
+        @serial = hash[:serial]
+        @refresh = hash[:refresh]
+        @retry = hash[:retry]
+        @expire = hash[:expire]
+        @minimum = hash[:minimum]
+      end
+      
+      def from_string(input)
+        if (input.length > 0)
+          names = input.split(" ")
+          @mname = Name.create(names[0])
+          @rname = Name.create(names[1])
+          @serial = names[2].to_i
+          @refresh = names[3].to_i
+          @retry = names[4].to_i
+          @expire = names[5].to_i
+          @minimum = names[6].to_i
+        end
+      end
+      
+      def rdata_to_string #:nodoc: all
+        if (@mname!=nil)
+          return "#{@mname} #{@rname} #{@serial} #{@refresh} #{@retry} #{@expire} #{@minimum}"
+        else
+          return ""
+        end
+      end
+      
+      def encode_rdata(msg, canonical=false) #:nodoc: all
+        msg.put_name(@mname, canonical)
+        msg.put_name(@rname, canonical)
+        msg.put_pack('NNNNN', @serial, @refresh, @retry, @expire, @minimum)
+      end
+      
+      def self.decode_rdata(msg) #:nodoc: all
+        mname = msg.get_name
+        rname = msg.get_name
+        serial, refresh, retry_, expire, minimum = msg.get_unpack('NNNNN')
+        return self.new(
+                        [mname, rname, serial, refresh, retry_, expire, minimum])
+      end
+    end 
+  end
+end

data/lib/Dnsruby/resource/SPF.rb

@@ -0,0 +1,29 @@
+#--
+#Copyright 2007 Nominet UK
+#
+#Licensed under the Apache License, Version 2.0 (the "License");
+#you may not use this file except in compliance with the License. 
+#You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0 
+#
+#Unless required by applicable law or agreed to in writing, software 
+#distributed under the License is distributed on an "AS IS" BASIS, 
+#WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
+#See the License for the specific language governing permissions and 
+#limitations under the License.
+#++
+module Dnsruby
+  class RR
+    #DNS SPF resource record
+    
+    #This is a clone of the TXT record. This class therfore completely inherits
+    #all properties of the Dnsruby::Resource::TXT class.
+    #
+    #Please see the Dnsruby::Resource::TXT documentation for details
+    #RFC 1035 Section 3.3.14, draft-schlitt-ospf-classic-02.txt
+    class SPF < TXT
+      TypeValue = Types::SPF #:nodoc: all
+    end
+  end
+end