snmpscan 0.1

data/README

@@ -0,0 +1,62 @@
+*SYNOPSIS*
+
+Snmpscan is a simple, yet powerful (and fast!) command-line SNMP
+scanner. Its aim is to reproduce the funcionalities of popular tools
+such as nbtscan, scanssh, smtpscan and other.
+
+
+*WEB REFERENCES*
+
+Home page: http://snmpscan.rubyforge.org/
+Project page (and download): http://rubyforge.org/projects/snmpscan/
+
+
+*REQUISITIES*
+
+You must have Ruby installed (of course!) and the wonderful SNMP Ruby
+library written by Dave Halliday (http://snmplib.rubyforge.org/).
+Download a copy from http://rubyforge.org/projects/snmplib/ or simply
+do a
+
+# gem install snmp
+
+
+*INSTALLATION*
+
+If you got this software on a tarball tgz, simply install it with 
+
+# ruby setup.rb
+
+Otherwise you can use gem:
+
+# gem install snmpscan
+
+
+*EXAMPLES*
+
+Directly from the online help:
+
+ snmpscan 10.10.10.64
+    Scans host 10.10.10.64 with default values 
+
+ snmpscan -t 200 -c comread -m sysName 172.30.149.0/24
+    Scans a range of 255 addresses for mib sysName.0, with comunity
+    password "comread" and a timeout value of 200 milliseconds
+
+If you use the -V (--verbose) option, you will have more output, like
+a string with the motivation for the failed scan for every host:
+
+ snmpscan -V 172.30.149.0/24
+
+ 172.30.149.0:   host 172.30.149.0 not responding
+ 172.30.149.1:   host 172.30.149.0 not responding
+
+and so on.
+
+
+*AUTHOR and LICENSE*
+
+This software is written by Marco Ceresa.
+ceresa@gmail.com
+
+License: Ruby.

data/bin/snmpscan

@@ -0,0 +1,157 @@
+#! /usr/bin/ruby1.8
+
+# == Synopsis
+#
+# snmpscan: a simple yet powerful snmp scanner
+#
+# == Usage
+#
+# snmpscan [OPTION] ip-range
+#
+# -h, --help:
+#    show help
+#
+# --timeout x, -t x:
+#    timeout x milliseconds (for faster scans), default 1 second
+#
+# --mib m, -m m:
+#    optional mib to use, defaults to sysDescr
+#
+# --comunity c, -c c
+#    comunity string, default "public"
+#
+# --protocol p, -p p
+#    version of the protocolo, defaults to 2c
+#
+# --version, -v
+#    version of the software
+#
+# --verbose, -V
+#    be verbose in output
+#
+# ip-range: An ip range (in the form 192.168.10.0/24) 
+# or a single address (172.30.16.1)
+#
+# == Examples
+#
+# snmpscan 10.10.10.64
+#    Scans host 10.10.10.64 with default values 
+#
+# snmpscan -t 200 -c comread -m sysName 172.30.149.0/24
+#    Scans a range of 255 addresses for mib sysName.0, with comunity password "comread"
+#    and a timeout value of 200 milliseconds
+#
+# == Author and license
+#    Written by Marco Ceresa
+#    Distributed under the same license as Ruby is
+#
+
+$VERSION = 0.1
+
+begin
+  require 'snmp'
+rescue LoadError
+  require 'rubygems'
+  require_gem 'snmp'
+end
+require 'ipaddr'
+require 'timeout'
+require 'getoptlong'
+require 'rdoc/usage'
+require 'thwait'
+
+opts = GetoptLong.new([ '--help', '-h', GetoptLong::NO_ARGUMENT ],
+                      [ '--version', '-v', GetoptLong::NO_ARGUMENT ],
+                      [ '--verbose', '-V', GetoptLong::NO_ARGUMENT ],
+                      [ '--timeout', '-t', GetoptLong::REQUIRED_ARGUMENT ],
+                      [ '--mib', '-m', GetoptLong::REQUIRED_ARGUMENT ],
+                      [ '--protocol', '-p', GetoptLong::REQUIRED_ARGUMENT ],
+                      [ '--comunity', '-c', GetoptLong::REQUIRED_ARGUMENT ]
+                      )
+
+# Defaults
+timeout = 1000
+mib = "sysDescr.0"
+protocol = "2c"
+comunity = "public"
+verbose = false
+
+opts.each do |opt, arg|
+  case opt
+  when '--help'
+    RDoc::usage
+  when '--version'
+    puts "snmpscan, version #$VERSION"
+    exit 0
+  when '--timeout'
+    timeout = arg.to_i
+  when '--mib'
+    mib = arg
+    unless mib =~ /\.\d+$/
+      mib += ".0"
+    end
+  when '--protocol'
+    protocol = arg
+  when '--comunity'
+    comunity = arg
+  when '--verbose'
+    verbose = true
+  end
+end
+
+puts "\nSNMP Scanner v.#$VERSION (c) Marco Ceresa 2006"
+puts "Reference at http://snmpscan.rubyforge.org/"
+print "Starting scanner for #{ARGV[0]} at #{Time.now}\n\n"
+
+if ARGV.length != 1
+  print "\nMissing ip-range argument (try --help)\n\n"
+  exit 0
+end
+
+args = [timeout,mib,protocol,comunity]
+print "Arguments: #{args.join ' '}\n\n" if verbose
+
+class IPAddr
+  # The broadcast method calculate the broadcast
+  # address of the range (if any)
+  def broadcast
+    return @addr + (IPAddr::IN4MASK - @mask_addr)  
+  end
+  # The each_address method iterates over each address
+  # of the ip range
+  def each_address
+    (@addr..broadcast).each do |addr|
+      yield _to_string(addr)
+    end
+  end
+end
+
+iprange = IPAddr.new(ARGV.shift,Socket::AF_INET)
+threads = []
+$stdout.sync = true
+
+
+
+iprange.each_address do |ip|
+  begin
+    threads << Thread.new(ip,args) do |ip,args|
+      timeout,mib,protocol,comunity = args
+      begin
+        SNMP::Manager.open(:Host => ip,
+                           :Community => comunity, 
+                           :Port => 161,
+                           :Timeout => (timeout/1000.0)) do |man|
+          res = man.get([mib])
+          answer = res.varbind_list[0].value
+          print "#{ip}:\t#{answer}\n"
+        end
+      rescue
+        print "#{ip}:\t#$!\n" if verbose
+      end
+    end
+  rescue
+    next
+  end
+end
+
+ThreadsWait.all_waits(threads)

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.11
+specification_version: 1
+name: snmpscan
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+date: 2006-05-26 00:00:00 +02:00
+summary: A fast SNMP scanner
+require_paths: 
+- lib
+email: ceresa@gmail.com
+homepage: http://snmpscan.rubyforge.org/
+rubyforge_project: 
+description: 
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: false
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+authors: 
+- Marco Ceresa
+files: 
+- bin/snmpscan
+- README
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: snmp
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+    version: