snmp 1.0.1 → 1.0.2

data/README

@@ -9,7 +9,7 @@ that Ruby can run.
 
 See snmplib.rubyforge.org[http://snmplib.rubyforge.org/] for more info.
 
-Version 1.0.0 of this software supports the following:
+Version 1.0.2 of this software supports the following:
 
 * The GetRequest, GetNextRequest, GetBulkRequest, SetRequest, Response
   SNMPv1_Trap, SNMPv2_Trap, and Inform PDUs
@@ -18,13 +18,20 @@ Version 1.0.0 of this software supports the following:
 * Trap handling for informs and v1 and v2 traps
 * Symbolic OID values (ie. "ifTable" instead of "1.3.6.1.2.1.2.2") as   
   parameters to the SNMP.Manager API
-* Includes symbol data files for all current IETF MIBs 
+* Includes symbol data files for all current IETF MIBs
+* Compatibility with both Ruby 1.8 and Ruby 1.9 
 
 See the SNMP.Manager, SNMP.TrapListener, and SNMP.MIB classes and the
 examples below for more details.
 
 == Changes
 
+Changes for version 1.0.2:
+
+* Internal code changes to make this library compatible with both Ruby 1.8
+  and Ruby 1.9.  Note that an ord() method is now added to the Fixnum class
+  for Ruby 1.8.  See the ber.rb file for details.
+
 Changes for version 1.0.1:
 
 * Made the host configurable for the TrapListener.  Previously defaulted
@@ -114,25 +121,26 @@ formats.
 From the .gem file you can install using
 RubyGems[http://rubyforge.org/projects/rubygems].
 
-  gem install snmp-1.0.0.gem
+  gem install snmp-1.0.2.gem
 
 From the .tgz or .zip file you can install using
 setup.rb[http://i.loveruby.net/en/prog/setup.html].  Uncompress the archive
 and then run setup.
 
-  cd snmp-1.0.0
+  cd snmp-1.0.2
   ruby setup.rb (may require root privilege)  
 
 == Testing
 
 This library has received limited testing:
-* The unit tests have been executed with Ruby 1.8.4 on Mac OS X 10.4.
+* The unit tests have been executed with both Ruby 1.8.6 and Ruby 1.9.0 on
+  Mac OS X 10.5.
 * Basic interoperability testing has been done with the
   net-snmp[http://www.net-snmp.org/] tools.
 
 I'm very interested in hearing about successes or failures on other platforms.
 
-Send me an email at snmp at halliday.ca.
+Send me an email at hallidave at gmail.com.
 
 == Examples
 
@@ -230,7 +238,7 @@ Log traps to STDOUT.
    
 == License
 
-This SNMP Library is Copyright (c) 2004,2005 by David R. Halliday.  It is free
+This SNMP Library is Copyright (c) 2004-2007 by David R. Halliday.  It is free
 software.  Redistribution is permitted under the same terms and conditions as
 the standard Ruby distribution.  See the COPYING file in the Ruby distribution
 for details.

data/Rakefile

@@ -10,7 +10,7 @@ Rake::TestTask.new do |test|
 end
 
 # package target
-PKG_VERSION = '1.0.1'
+PKG_VERSION = '1.0.2'
 PKG_FILES = FileList[
     'Rakefile',
     'README',
@@ -30,7 +30,6 @@ spec = Gem::Specification.new do |s|
     s.summary = "A Ruby implementation of SNMP (the Simple Network Management Protocol)."
     s.name = 'snmp'
     s.version = PKG_VERSION
-    s.autorequire = 'snmp'
     s.files = PKG_FILES.to_a
     s.has_rdoc = true
     s.extra_rdoc_files = ['README']    
@@ -38,7 +37,7 @@ spec = Gem::Specification.new do |s|
                       '--title' << 'SNMP Library for Ruby'
     s.description = "A Ruby implementation of SNMP (the Simple Network Management Protocol)."
     s.author = 'Dave Halliday'
-    s.email = 'snmp@halliday.ca'
+    s.email = 'hallidave@gmail.com'
     s.rubyforge_project = 'snmplib'
     s.homepage = 'http://snmplib.rubyforge.org'
 end

data/examples/datetime.rb

@@ -0,0 +1,22 @@
+require 'snmp'
+
+module SNMP
+  class OctetString
+    def to_date_time
+      raise ArgumentError, "not DateAndTime format" if size != 8 and size != 11
+      year = self[0].ord * 256 + self[1].ord
+      month = self[2].ord
+      day = self[3].ord
+      hour = self[4].ord
+      minutes = self[5].ord
+      seconds = self[6].ord
+      tenths = self[7].ord
+      sprintf("%d-%d-%d,%02d:%02d:%02d.%d", year, month, day, hour, minutes, seconds, tenths)
+    end
+  end
+end
+
+SNMP::Manager.open(:Host => 'localhost', :MibModules => ["HOST-RESOURCES-MIB"]) do |snmp|
+  response = snmp.get_value("hrSystemDate.0")
+  puts response.to_date_time
+end

data/examples/link_down.rb

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'snmp'
+require 'logger'
+
+log = Logger.new($stdout)
+
+mib = SNMP::MIB.new
+mib.load_module("IF-MIB")
+linkDown_OID = mib.oid("linkDown")
+
+# 1 is "up" and 2 is "down" in the MIB
+ADMIN_UP = 1
+ADMIN_DOWN = 2
+
+listener = SNMP::TrapListener.new(:Port => 1062, :Community => 'public') do |listener|
+  log.info "Listening for linkDown traps"
+  listener.on_trap(linkDown_OID) do |trap|
+      vb_list = trap.vb_list
+      up_time = vb_list[0].value    # standard varbind - always in v2c trap
+      trap_oid = vb_list[1].value   # standard varbind - always in v2c trap
+
+      # extract trap info - order determined by IF-MIB
+      ifIndex = vb_list[2].value
+      adminStatus = vb_list[3].value
+      operStatus = vb_list[4].value
+
+      # log stuff based on interface status      
+      if adminStatus == ADMIN_DOWN   
+        log.info "Interface #{ifIndex} turned down"
+      else
+      	log.error "Problem on interface #{ifIndex}!  Link unintentionally down"
+      end
+  end
+ 
+  listener.on_trap_v1 do |trap|
+      log.warn "Unexpected v1 trap: #{trap.generic_trap}"
+  end
+
+  listener.on_trap_v2c do |trap|
+      log.warn "Unexpected v2c trap: #{trap.trap_oid}"
+  end
+end
+
+trap("INT") do
+  puts "\nShutting down"
+  listener.kill
+end
+
+listener.join

data/lib/snmp/ber.rb

@@ -7,6 +7,17 @@
 # COPYING file in the Ruby distribution for details.
 #
 
+#
+# Add ord method to Fixnum for forward compatibility with Ruby 1.9
+#
+if "a"[0].kind_of? Fixnum
+    unless Fixnum.methods.include? :ord
+        class Fixnum
+            def ord; self; end
+        end
+    end
+end
+
 #
 # This module implements methods for encoding and decoding SNMP packets
 # using the ASN.1 BER (Basic Encoding Rules).
@@ -84,9 +95,9 @@ module BER #:nodoc:all
     # multi-byte).
     #
     def decode_tlv(data)
-        raise OutOfData if (data.length == 2 && data[1] != 0) || data.length < 2
-        tag = data[0]
-        length = data[1]
+        raise OutOfData if (data.length == 2 && data[1].ord != 0) || data.length < 2
+        tag = data[0].ord
+        length = data[1].ord
         if length < 0x80
             value = data[2, length]
             remainder = data[length+2..-1]
@@ -122,7 +133,7 @@ module BER #:nodoc:all
     
     def decode_integer_value(value)
         result = build_integer(value, 0, value.length)
-        if value[0][7] == 1
+        if value[0].ord[7] == 1
             result -= (1 << (8 * value.length))
         end
         result
@@ -139,7 +150,7 @@ module BER #:nodoc:all
     
     def build_integer(data, start, num_octets)
         number = 0
-        num_octets.times { |i| number = number<<8 | data[start+i] }
+        num_octets.times { |i| number = number<<8 | data[start+i].ord }
         return number
     end
 
@@ -197,18 +208,19 @@ module BER #:nodoc:all
         if value.length == 0
             object_id = []
         else
-            if value[0] == 0x2b
+            value0 = value[0].ord
+            if value0 == 0x2b
                 object_id = [1,3]
             else
-                second = value[0] % 40
-                first = (value[0] - second) / 40
+                second = value0 % 40
+                first = (value0 - second) / 40
                 raise InvalidObjectId, value.to_s if first > 2
                 object_id = [first, second]
             end
             n = 0
             for i in 1...value.length
-                n = (n<<7) + (value[i] & 0x7f)
-                if value[i] < 0x80
+                n = (n<<7) + (value[i].ord & 0x7f)
+                if value[i].ord < 0x80
                     object_id << n
                     n = 0
                 end 
@@ -243,9 +255,9 @@ module BER #:nodoc:all
             data = value.chr
         else
             data = integer_to_octets(value)
-            if value > 0 && data[0] > 0x7f
+            if value > 0 && data[0].ord > 0x7f
                 data = "\000" << data 
-            elsif value < 0 && data[0] < 0x80
+            elsif value < 0 && data[0].ord < 0x80
                 data = "\377" << data
             end
         end
@@ -326,7 +338,7 @@ module BER #:nodoc:all
                         octets = (n & 0x7f | 0x80).chr << octets
                         n = n >> 7
                     end until n == 0
-                    octets[-1] &= 0x7f
+                    octets[-1] = (octets[-1].ord & 0x7f).chr
                     data << octets
                 end
             end

data/lib/snmp/varbind.rb

@@ -29,11 +29,17 @@ class VarBindList < Array
 
     def initialize(varbind_list=[])
         super()
-        varbind_list.each do |item|
-            if item.respond_to? :to_str
-                self << ObjectId.new(item.to_str).to_varbind
-            else
-                self << item.to_varbind
+        if varbind_list.respond_to? :to_str
+            self << ObjectId.new(varbind_list.to_str).to_varbind
+        elsif varbind_list.respond_to? :to_varbind
+            self << varbind_list.to_varbind
+        else
+            varbind_list.each do |item|
+                if item.respond_to? :to_str
+                    self << ObjectId.new(item.to_str).to_varbind
+                else
+                    self << item.to_varbind
+                end
             end
         end
     end

data/test/test_mib.rb

@@ -33,7 +33,13 @@ class TestMib < Test::Unit::TestCase
         
         assert_raise(ArgumentError) {
             @mib.oid("IF-MIB::")
+        } 
+        
+        assert_raise(ArgumentError) {
+           MIB.new.oid("sysDescr.0")
         }
+        
+        assert_equal("1.2.3.4", MIB.new.oid("1.2.3.4").to_s)
     end
     
     def test_varbind_list

metadata

@@ -1,43 +1,37 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.8.11
-specification_version: 1
 name: snmp
 version: !ruby/object:Gem::Version 
-  version: 1.0.1
-date: 2006-05-04 00:00:00 -04:00
-summary: A Ruby implementation of SNMP (the Simple Network Management Protocol).
-require_paths: 
-- lib
-email: snmp@halliday.ca
-homepage: http://snmplib.rubyforge.org
-rubyforge_project: snmplib
-description: A Ruby implementation of SNMP (the Simple Network Management Protocol).
-autorequire: snmp
-default_executable: 
-bindir: bin
-has_rdoc: true
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
-  version: 
+  version: 1.0.2
 platform: ruby
-signing_key: 
-cert_chain: 
 authors: 
 - Dave Halliday
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2007-12-29 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: A Ruby implementation of SNMP (the Simple Network Management Protocol).
+email: hallidave@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
 files: 
 - Rakefile
 - README
 - setup.rb
-- lib/snmp.rb
 - lib/snmp/agent.rb
 - lib/snmp/ber.rb
 - lib/snmp/manager.rb
 - lib/snmp/mib.rb
 - lib/snmp/pdu.rb
 - lib/snmp/varbind.rb
+- lib/snmp.rb
 - test/test_ber.rb
 - test/test_manager.rb
 - test/test_mib.rb
@@ -48,9 +42,11 @@ files:
 - test/test_walk.rb
 - test/if_table1.yaml
 - test/if_table6.yaml
+- examples/datetime.rb
 - examples/dump.rb
 - examples/get.rb
 - examples/iftable.rb
+- examples/link_down.rb
 - examples/log_traps.rb
 - examples/set.rb
 - examples/walk.rb
@@ -246,20 +242,34 @@ files:
 - data/ruby/snmp/mibs/VDSL-LINE-MIB.yaml
 - data/ruby/snmp/mibs/VRRP-MIB.yaml
 - data/ruby/snmp/mibs/WWW-MIB.yaml
-test_files: []
-
+has_rdoc: true
+homepage: http://snmplib.rubyforge.org
+post_install_message: 
 rdoc_options: 
 - --main
 - README
 - --title
 - SNMP Library for Ruby
-extra_rdoc_files: 
-- README
-executables: []
-
-extensions: []
-
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
 requirements: []
 
-dependencies: []
+rubyforge_project: snmplib
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: A Ruby implementation of SNMP (the Simple Network Management Protocol).
+test_files: []