scandb 0.0.9

data/History.txt

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2008-07-08
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,22 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/scandb
+lib/scandb/exceptions/invalid_database_config.rb
+lib/scandb/exceptions.rb
+lib/scandb/config.rb
+lib/scandb/database.rb
+lib/scandb/model.rb
+lib/scandb/port.rb
+lib/scandb/service.rb
+lib/scandb/scanned_port.rb
+lib/scandb/os.rb
+lib/scandb/os_guess.rb
+lib/scandb/host_name.rb
+lib/scandb/host.rb
+lib/scandb/nmap.rb
+lib/scandb/runner.rb
+lib/scandb/scandb.rb
+lib/scandb/version.rb
+lib/scandb.rb

data/README.txt

@@ -0,0 +1,47 @@
+= ScanDB
+
+* http://rubyforge.org/projects/scandb/
+
+== DESCRIPTION:
+
+ScanDB is a library for importing and analyzing information generated by
+various network scanning utilities.
+
+== FEATURES/PROBLEMS:
+
+* Imports scan information from Nmap XML scan files.
+
+== REQUIREMENTS:
+
+* DataMapper:
+  * do_sqlite3 >= 0.9.2
+  * dm-core >= 0.9.2
+  * dm-types >= 0.9.2
+* libxml-ruby
+
+== INSTALL:
+
+  $ sudo gem install scandb
+
+== EXAMPLES:
+
+== LICENSE:
+
+ScanDB - A library for importing and analyzing information generated by
+various network scanning utilities.
+
+Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along
+with this program; if not, write to the Free Software Foundation, Inc.,
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

data/Rakefile

@@ -0,0 +1,18 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/scandb/version.rb'
+
+Hoe.new('scandb', ScanDB::VERSION) do |p|
+  p.rubyforge_name = 'scandb'
+  p.developer('Postmodern Modulus III', 'postmodern.mod3@gmail.com')
+  p.extra_deps = [
+    ['do_sqlite3', '>=0.9.3'],
+    ['dm-core', '>=0.9.3'],
+    ['dm-types', '>=0.9.3'],
+    ['libxml-ruby']
+  ]
+end
+
+# vim: syntax=Ruby

data/bin/scandb

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__),'..','lib'))
+unless $LOAD_PATH.include?(lib_dir)
+  $LOAD_PATH << lib_dir
+end
+
+require 'scandb/runner'
+
+ScanDB::Runner.command_line(ARGV)

data/lib/scandb.rb

@@ -0,0 +1,26 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/nmap'
+require 'scandb/scandb'
+require 'scandb/version'

data/lib/scandb/config.rb

@@ -0,0 +1,33 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'fileutils'
+
+module ScanDB
+  module Config
+    # The configuration directory
+    PATH = File.join(ENV['HOME'],'.scandb')
+
+    FileUtils.mkdir(PATH) unless File.directory?(PATH)
+  end
+end

data/lib/scandb/database.rb

@@ -0,0 +1,103 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/exceptions/invalid_database_config'
+require 'scandb/config'
+require 'scandb/port'
+require 'scandb/service'
+require 'scandb/os'
+require 'scandb/os_guess'
+require 'scandb/host_name'
+require 'scandb/host'
+
+require 'dm-core'
+
+module ScanDB
+  module Database
+    # Database configuration file
+    CONFIG_FILE = File.join(Config::PATH,'database.yml')
+
+    # Default database configuration
+    DEFAULT_CONFIG = "sqlite3://" + File.join(Config::PATH,'scandb.db')
+
+    # Default log path
+    DEFAULT_LOG_PATH = File.join(Config::PATH,'scandb.log')
+
+    # Default log level
+    DEFAULT_LOG_LEVEL = :info
+
+    #
+    # Returns the Database configuration that is stored in the
+    # +CONFIG_FILE+. Defaults to +DEFAULT_CONFIG+ if +CONFIG_FILE+ does not
+    # exist.
+    #
+    def Database.config
+      if File.file?(CONFIG_FILE)
+        conf = YAML.load(CONFIG_FILE)
+
+        unless (conf.kind_of?(Hash) || conf.kind_of?(String))
+          raise(InvalidDatabaseConfig,"#{CONFIG_FILE} must contain either a Hash or a String",caller)
+        end
+
+        return conf
+      end
+
+      return DEFAULT_CONFIG
+    end
+
+    #
+    # Setup the Database log with the given _options_.
+    #
+    # _options_ may contain the following keys:
+    # <tt>:path</tt>:: The path of the log file. Defaults to
+    #                  +DEFAULT_LOG_PATH+.
+    # <tt>:stream</tt>:: The stream to use for the log.
+    # <tt>:level</tt>:: The level of messages to log.
+    #
+    def Database.setup_log(options={})
+      path = (options[:path] || DEFAULT_LOG_PATH)
+      stream = (options[:stream] || File.new(path,'w+'))
+      level = (options[:level] || DEFAULT_LOG_LEVEL)
+
+      DataMapper::Logger.new(stream,level)
+      return nil
+    end
+
+    #
+    # Sets up the Database with the given _configuration_. If
+    # _configuration is not given, +DEFAULT_CONFIG+ will be used to setup
+    # the Database.
+    #
+    def Database.setup(configuration=DEFAULT_CONFIG,&block)
+      Database.setup_log
+      DataMapper.setup(:default, configuration)
+
+      block.call if block
+
+      DataMapper.auto_upgrade!
+      return nil
+    end
+
+    Database.setup
+  end
+end

data/lib/scandb/exceptions.rb

@@ -0,0 +1,24 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/exceptions/invalid_database_config'

data/lib/scandb/exceptions/invalid_database_config.rb

@@ -0,0 +1,27 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+module ScanDB
+  class InvalidDatabaseConfig < RuntimeError
+  end
+end

data/lib/scandb/host.rb

@@ -0,0 +1,54 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/model'
+require 'scandb/host_name'
+require 'scandb/os_guess'
+require 'scandb/scanned_port'
+
+module ScanDB
+  class Host
+
+    include Model
+
+    property :ip, String
+
+    has n, :names, :class_name => 'HostName'
+
+    has n, :os_guesses, :order => [:accuracy.desc], :class_name => 'OSGuess'
+
+    has n, :scanned_ports
+
+    #
+    # Returns the primary host name.
+    #
+    def host_name
+      names.first
+    end
+
+    def to_s
+      ip
+    end
+
+  end
+end

data/lib/scandb/host_name.rb

@@ -0,0 +1,47 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/host'
+
+module ScanDB
+  class HostName
+
+    include Model
+
+    property :name, Text
+
+    belongs_to :host
+
+    def inspect
+      name
+    end
+
+    #
+    # Returns the host name in String form.
+    #
+    def to_s
+      name
+    end
+
+  end
+end

data/lib/scandb/model.rb

@@ -0,0 +1,39 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'dm-core'
+
+module ScanDB
+  module Model
+    include DataMapper::Types
+
+    def self.included(base)
+      base.module_eval do
+        include DataMapper::Resource
+        include DataMapper::AutoMigrations
+
+        property :id, Serial
+      end
+    end
+  end
+end

data/lib/scandb/nmap.rb

@@ -0,0 +1,93 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/database'
+require 'scandb/host'
+
+require 'libxml'
+
+module ScanDB
+  module Nmap
+    #
+    # Imports scan information from a Nmap XML scan file, specified by
+    # the _path_. Returns an Array of Host objects.
+    #
+    #   Nmap.from_xml('path/to/scan.xml')
+    #   # => [...]
+    #
+    def Nmap.from_xml(path)
+      doc = XML::Document.file(path)
+      hosts = []
+
+      doc.find("/nmaprun/host[status[@state='up']]").each do |host|
+        ip = host.find_first("address[@addr and @addrtype='ipv4']")['addr']
+        new_host = Host.first_or_create(:ip => ip)
+
+        host.find('hostname').each do |hostname|
+          new_host.names << HostName.first_or_create(
+            :name => hostname['name'],
+            :host_id => new_host.id
+          )
+        end
+
+        host.find('os/osclass').each do |osclass|
+          new_os = OS.first_or_create(
+            :type => osclass['type'],
+            :vendor => osclass['vendor'],
+            :family => osclass['osfamily'],
+            :version => osclass['osgen']
+          )
+
+          new_host.os_guesses << OSGuess.first_or_create(
+            :os_id => new_os.id,
+            :accuracy => osclass['accuracy'].to_i
+          )
+        end
+
+        host.find('ports/port').each do |port|
+          new_port = Port.first_or_create(
+            :number => port['portid'].to_i,
+            :protocol => port['protocol'].to_sym
+          )
+
+          new_service = Service.first_or_create(
+            :name => port.find_first('service[@name]')['name']
+          )
+
+          new_host.scanned_ports << ScannedPort.first_or_create(
+            :status => port.find_first('state[@state]')['state'].to_sym,
+            :service_id => new_service.id,
+            :port_id => new_port.id,
+            :host_id => new_host.id
+          )
+        end
+
+        new_host.save
+
+        hosts << new_host
+      end
+
+      return hosts
+    end
+  end
+end

data/lib/scandb/os.rb

@@ -0,0 +1,42 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/model'
+
+module ScanDB
+  class OS
+
+    include Model
+
+    property :type, String
+
+    property :vendor, String
+
+    property :family, String
+
+    property :version, String
+
+    has n, :guesses, :class_name => 'OSGuess'
+
+  end
+end

data/lib/scandb/os_guess.rb

@@ -0,0 +1,40 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/model'
+require 'scandb/os'
+require 'scandb/host'
+
+module ScanDB
+  class OSGuess
+
+    include Model
+
+    property :accuracy, Integer
+
+    belongs_to :os, :class_name => 'OS'
+
+    belongs_to :host
+
+  end
+end

data/lib/scandb/port.rb

@@ -0,0 +1,53 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/model'
+require 'scandb/host'
+require 'scandb/service'
+
+require 'dm-types/enum'
+
+module ScanDB
+  class Port
+
+    include Model
+
+    property :protocol, Enum[:tcp, :udp]
+
+    property :number, Integer
+
+    has n, :scanned, :class_name => 'ScannedPort'
+
+    has n, :hosts, :through => :scanned
+
+    has n, :services, :through => :scanned
+
+    #
+    # Returns the String form of the port.
+    #
+    def to_s
+      "#{number}/#{protocol}"
+    end
+
+  end
+end

data/lib/scandb/runner.rb

@@ -0,0 +1,91 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/database'
+require 'scandb/nmap'
+
+require 'ostruct'
+require 'optparse'
+
+module ScanDB
+  module Runner
+    #
+    # The command-line runner.
+    #
+    def Runner.command_line(args)
+      options = OpenStruct.new
+
+      opts = OptionParser.new do |opts|
+        opts.banner = 'usage: scandb [-d URI] [--import-nmap FILE | -L | -p PORT | -s NAME]'
+
+        opts.on('-d','--database URI','The URI for the Database.','Defaults to ~/.scandb/scandb.db') do |uri|
+          options.database = uri
+        end
+
+        opts.on('--import-nmap FILE','Import a Nmap XML scan file') do |file|
+          options.import = :nmap
+          options.import_file = file
+        end
+
+        opts.on('-L','--list-hosts','List all hosts within ScanDB') do
+          options.list_hosts = true
+        end
+
+        opts.on('-p','--with-port PORT','List hosts with the specified open PORT') do |port|
+          options.with_port = port.to_i
+        end
+
+        opts.on('-s','--with-service NAME','List hosts with the specified service') do |name|
+          options.with_service = name
+        end
+
+        opts.on('-h','--help','This cruft') do
+          puts opts
+          exit
+        end
+      end
+
+      opts.parse!(args)
+
+      if options.import
+        case options.import
+        when :nmap then
+          hosts = Nmap.from_xml(options.import_file)
+          puts "Success imported #{hosts.length} hosts."
+        end
+      else
+        if options.with_port
+          hosts = Port.all(:number => options.with_port).scanned(:status => :open).host
+        elsif options.with_service
+          hosts = Service.all(:name.like => "%#{options.with_service}%").scanned(:status => :open).host
+        else
+          hosts = Host.all
+        end
+
+        hosts.each { |host| puts host}
+      end
+
+      return true
+    end
+  end
+end

data/lib/scandb/scandb.rb

@@ -0,0 +1,25 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+module ScanDB
+end

data/lib/scandb/scanned_port.rb

@@ -0,0 +1,52 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/model'
+require 'scandb/service'
+require 'scandb/port'
+require 'scandb/host'
+
+require 'dm-types/enum'
+
+module ScanDB
+  class ScannedPort
+
+    include Model
+
+    property :status, Enum[:open, :filtered, :closed]
+
+    belongs_to :service
+
+    belongs_to :port
+
+    belongs_to :host
+
+    #
+    # Returns the String form of the scanned port.
+    #
+    def to_s
+      sprintf("%9s%9s\t%s",port,status,service)
+    end
+
+  end
+end

data/lib/scandb/service.rb

@@ -0,0 +1,47 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+require 'scandb/model'
+
+require 'dm-types/enum'
+
+module ScanDB
+  class Service
+
+    include Model
+
+    property :name, String
+
+    has n, :scanned, :class_name => 'ScannedPort'
+
+    has n, :hosts, :through => :scanned
+
+    #
+    # Returns the String form of the service.
+    #
+    def to_s
+      name
+    end
+
+  end
+end

data/lib/scandb/version.rb

@@ -0,0 +1,27 @@
+#
+#--
+# ScanDB - A library for importing and analyzing information generated by
+# various network scanning utilities.
+#
+# Copyright (c) 2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#++
+#
+
+module ScanDB
+  # ScanDB version
+  VERSION = '0.0.9'
+end

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification 
+name: scandb
+version: !ruby/object:Gem::Version 
+  version: 0.0.9
+platform: ruby
+authors: 
+- Postmodern Modulus III
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-07-27 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: do_sqlite3
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: dm-core
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: dm-types
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: libxml-ruby
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.7.0
+    version: 
+description: ScanDB is a library for importing and analyzing information generated by various network scanning utilities.
+email: 
+- postmodern.mod3@gmail.com
+executables: 
+- scandb
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/scandb
+- lib/scandb/exceptions/invalid_database_config.rb
+- lib/scandb/exceptions.rb
+- lib/scandb/config.rb
+- lib/scandb/database.rb
+- lib/scandb/model.rb
+- lib/scandb/port.rb
+- lib/scandb/service.rb
+- lib/scandb/scanned_port.rb
+- lib/scandb/os.rb
+- lib/scandb/os_guess.rb
+- lib/scandb/host_name.rb
+- lib/scandb/host.rb
+- lib/scandb/nmap.rb
+- lib/scandb/runner.rb
+- lib/scandb/scandb.rb
+- lib/scandb/version.rb
+- lib/scandb.rb
+has_rdoc: true
+homepage: http://rubyforge.org/projects/scandb/
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: []
+
+rubyforge_project: scandb
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: ScanDB is a library for importing and analyzing information generated by various network scanning utilities.
+test_files: []
+