snmp 0.5.1 → 0.6.0

data/lib/snmp/varbind.rb

@@ -93,6 +93,11 @@ class Integer
     def encode
         encode_integer(@value)
     end
+    
+    def to_oid
+        raise RangeError, "@{value} cannot be an OID (must be >0)" if @value < 0
+        ObjectId.new([@value])
+    end
 end
 
 class Integer32 < Integer
@@ -115,6 +120,12 @@ class OctetString < String
     def encode
         encode_octet_string(self)
     end
+    
+    def to_oid
+        oid = ObjectId.new
+        each_byte { |b| oid << b }
+        oid
+    end
 end
 
 class ObjectId < Array
@@ -133,19 +144,25 @@ class ObjectId < Array
     # in the format "n.n.n.n.n.n" or an array of integers.
     #
     def initialize(id=[])
-        if id.respond_to? :to_str
+        if id.nil?
+            raise ArgumentError
+        elsif id.respond_to? :to_str
             super(make_integers(id.to_str.split(".")))
         else
             super(make_integers(id.to_ary))
         end
     rescue ArgumentError
-        raise ArgumentError, "'#{id}' not a valid object ID"
+        raise ArgumentError, "#{id.inspect}:#{id.class} not a valid object ID"
     end
     
     def to_varbind
         VarBind.new(self, Null)
     end
     
+    def to_oid
+        self
+    end
+    
     def to_s
         self.join('.')
     end
@@ -163,9 +180,7 @@ class ObjectId < Array
     # ObjectId.  For example, "1.3.6.1.5" is a subtree of "1.3.6.1".
     #
     def subtree_of?(parent_tree)
-        unless parent_tree.kind_of? ObjectId
-            parent_tree = ObjectId.new(parent_tree)
-        end
+        parent_tree = make_object_id(parent_tree)
         if parent_tree.length > self.length
             false
         else
@@ -176,11 +191,34 @@ class ObjectId < Array
         end
     end
     
+    ##
+    # Returns an index based on the difference between this ObjectId
+    # and the provided parent ObjectId.
+    #
+    # For example, ObjectId.new("1.3.6.1.5").index("1.3.6.1") returns an
+    # ObjectId of "5".
+    #
+    def index(parent_tree)
+        parent_tree = make_object_id(parent_tree)
+        if not subtree_of?(parent_tree)
+            raise ArgumentError, "#{self.to_s} not a subtree of #{parent_tree.to_s}"
+        elsif self.length == parent_tree.length
+            raise ArgumentError, "OIDs are the same"
+        else
+            ObjectId.new(self[parent_tree.length..-1])
+        end
+    end
+    
     private
     
     def make_integers(list)
         list.collect{|n| Integer(n)}
+    end 
+    
+    def make_object_id(oid)
+        oid.kind_of?(ObjectId) ? oid : ObjectId.new(oid)
     end
+    
 end
 
 class IpAddress
@@ -200,12 +238,13 @@ class IpAddress
     # (i.e. "10.1.2.3").
     #
     def initialize(value_data)
-        if value_data.length > 4
-            value_data = parse_string(value_data)
-        elsif value_data.length != 4
+        ip = value_data.to_str
+        if ip.length > 4
+            ip = parse_string(ip)
+        elsif ip.length != 4
             raise InvalidIpAddress, "Expected 4 octets or formatted string, got #{value_data.inspect}"
         end
-        @value = value_data
+        @value = ip
     end
     
     ##
@@ -224,6 +263,12 @@ class IpAddress
         octets.join('.')    
     end
     
+    def to_oid
+        oid = ObjectId.new
+        @value.each_byte { |b| oid << b }
+        oid
+    end
+    
     def ==(other)
         if other.respond_to? :to_str
             return @value.eql?(other.to_str)
@@ -442,6 +487,8 @@ class VarBind
     attr_accessor :name
     attr_accessor :value
     
+    alias :oid :name
+    
     class << self
         def decode(data)
             varbind_data, remaining_varbind_data = decode_sequence(data)

data/test/if_table1.yaml

@@ -0,0 +1,81 @@
+--- 
+- 
+  - 1.3.6.1.2.1.2.2.1.1
+  - noSuchObject
+  - SNMP::NoSuchObject
+- 
+  - 1.3.6.1.2.1.2.2.1.1.1
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.2
+  - noSuchObject
+  - SNMP::NoSuchObject
+- 
+  - 1.3.6.1.2.1.2.2.1.2.1
+  - lo0
+  - SNMP::OctetString
+- 
+  - 1.3.6.1.2.1.2.2.1.3
+  - noSuchObject
+  - SNMP::NoSuchObject
+- 
+  - 1.3.6.1.2.1.2.2.1.4.1
+  - "16384"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.5.1
+  - "0"
+  - SNMP::Gauge32
+- 
+  - 1.3.6.1.2.1.2.2.1.7.1
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.8.1
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.9.1
+  - "0"
+  - SNMP::TimeTicks
+- 
+  - 1.3.6.1.2.1.2.2.1.10.1
+  - "18228208"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.11.1
+  - "141603"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.12.1
+  - "12738"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.13.1
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.14.1
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.15.1
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.16.1
+  - "18233800"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.17.1
+  - "154413"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.18.1
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.20.1
+  - "0"
+  - SNMP::Counter32

data/test/if_table6.yaml

@@ -0,0 +1,441 @@
+--- 
+- 
+  - 1.3.6.1.2.1.2.2.1.1
+  - noSuchObject
+  - SNMP::NoSuchObject
+- 
+  - 1.3.6.1.2.1.2.2.1.1.1
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.1.2
+  - "2"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.1.3
+  - "3"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.1.4
+  - "4"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.1.5
+  - "5"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.1.6
+  - "6"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.2
+  - noSuchObject
+  - SNMP::NoSuchObject
+- 
+  - 1.3.6.1.2.1.2.2.1.2.1
+  - lo0
+  - SNMP::OctetString
+- 
+  - 1.3.6.1.2.1.2.2.1.2.2
+  - gif0
+  - SNMP::OctetString
+- 
+  - 1.3.6.1.2.1.2.2.1.2.3
+  - stf0
+  - SNMP::OctetString
+- 
+  - 1.3.6.1.2.1.2.2.1.2.4
+  - en0
+  - SNMP::OctetString
+- 
+  - 1.3.6.1.2.1.2.2.1.2.5
+  - en1
+  - SNMP::OctetString
+- 
+  - 1.3.6.1.2.1.2.2.1.2.6
+  - fw0
+  - SNMP::OctetString
+- 
+  - 1.3.6.1.2.1.2.2.1.3.1
+  - "24"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.3.2
+  - "55"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.3.3
+  - "57"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.3.4
+  - "6"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.3.5
+  - "6"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.3.6
+  - "144"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.4.1
+  - "16384"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.4.2
+  - "1280"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.4.3
+  - "1280"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.4.4
+  - "1500"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.4.5
+  - "1500"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.4.6
+  - "4078"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.5.1
+  - "0"
+  - SNMP::Gauge32
+- 
+  - 1.3.6.1.2.1.2.2.1.5.2
+  - "0"
+  - SNMP::Gauge32
+- 
+  - 1.3.6.1.2.1.2.2.1.5.3
+  - "0"
+  - SNMP::Gauge32
+- 
+  - 1.3.6.1.2.1.2.2.1.5.4
+  - "10000000"
+  - SNMP::Gauge32
+- 
+  - 1.3.6.1.2.1.2.2.1.5.5
+  - "10000000"
+  - SNMP::Gauge32
+- 
+  - 1.3.6.1.2.1.2.2.1.5.6
+  - "10000000"
+  - SNMP::Gauge32
+- 
+  - 1.3.6.1.2.1.2.2.1.7.1
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.7.2
+  - "2"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.7.3
+  - "2"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.7.4
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.7.5
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.7.6
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.8.1
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.8.2
+  - "2"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.8.3
+  - "2"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.8.4
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.8.5
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.8.6
+  - "1"
+  - SNMP::Integer
+- 
+  - 1.3.6.1.2.1.2.2.1.9.1
+  - "0"
+  - SNMP::TimeTicks
+- 
+  - 1.3.6.1.2.1.2.2.1.9.2
+  - "0"
+  - SNMP::TimeTicks
+- 
+  - 1.3.6.1.2.1.2.2.1.9.3
+  - "0"
+  - SNMP::TimeTicks
+- 
+  - 1.3.6.1.2.1.2.2.1.9.4
+  - "0"
+  - SNMP::TimeTicks
+- 
+  - 1.3.6.1.2.1.2.2.1.9.5
+  - "0"
+  - SNMP::TimeTicks
+- 
+  - 1.3.6.1.2.1.2.2.1.9.6
+  - "0"
+  - SNMP::TimeTicks
+- 
+  - 1.3.6.1.2.1.2.2.1.10.1
+  - "18228208"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.10.2
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.10.3
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.10.4
+  - "561918678"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.10.5
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.10.6
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.11.1
+  - "141603"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.11.2
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.11.3
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.11.4
+  - "544419"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.11.5
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.11.6
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.12.1
+  - "12738"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.12.2
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.12.3
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.12.4
+  - "159"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.12.5
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.12.6
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.13.1
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.13.2
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.13.3
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.13.4
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.13.5
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.13.6
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.14.1
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.14.2
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.14.3
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.14.4
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.14.5
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.14.6
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.15.1
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.15.2
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.15.3
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.15.4
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.15.5
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.15.6
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.16.1
+  - "18233800"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.16.2
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.16.3
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.16.4
+  - "68141195"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.16.5
+  - "342"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.16.6
+  - "346"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.17.1
+  - "154413"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.17.2
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.17.3
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.17.4
+  - "351526"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.17.5
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.17.6
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.18.1
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.18.2
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.18.3
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.18.4
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.18.5
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.18.6
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.20.1
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.20.2
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.20.3
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.20.4
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.20.5
+  - "0"
+  - SNMP::Counter32
+- 
+  - 1.3.6.1.2.1.2.2.1.20.6
+  - "0"
+  - SNMP::Counter32