ronin-exploits 0.2.1 → 0.3.0

data/spec/spec_helper.rb

@@ -1,9 +1,12 @@
 require 'rubygems'
-gem 'rspec', '>=1.1.12'
+gem 'rspec', '>=1.2.8'
 require 'spec'
 
 require 'ronin/exploits/version'
+require 'ronin/ui/output'
 
 include Ronin
 
+UI::Output.silent = true
+
 require 'helpers/database'

data/static/ronin/generators/exploits/_cache.erb

@@ -0,0 +1,14 @@
+    self.name = <%= options[:name].inspect %>
+    self.description = %{<%= options[:description] %>}
+
+    self.status = <%= options[:status].to_sym.inspect %>
+    self.disclosure = <%= options[:disclosure].map { |name| name.to_sym }.inspect %>
+    <% options[:authors].each do |author| %>
+    author(:name => <%= author.inspect %>)
+    <% end
+    unless options[:controls].empty? %>
+    control <%= options[:controls].map { |name| name.to_sym.inspect }.join(', ') %>
+    <% end %>
+    targeting do |target|
+      target.arch :i686
+    end

data/static/ronin/generators/exploits/_header.erb

@@ -0,0 +1 @@
+#!/usr/bin/ronin-exploit -f

data/static/ronin/generators/exploits/_helpers.erb

@@ -0,0 +1,4 @@
+<% unless options[:helpers].empty? %>
+<%   options[:helpers].each do |name| %>  helper <%= name.to_sym.inspect %>
+<%   end
+   end %>

data/static/ronin/generators/exploits/exploit.erb

@@ -0,0 +1,24 @@
+<%= template '_header.erb' %>
+
+ronin_exploit do
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+  end
+
+  #
+  # Builds the exploit.
+  #
+  def build
+  end
+
+  #
+  # Deploys the built exploit.
+  #
+  def deploy
+  end
+
+end

data/static/ronin/generators/exploits/ftp.erb

@@ -0,0 +1,24 @@
+<%= template '_header.erb' %>
+
+ronin_ftp_exploit do
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+  end
+
+  #
+  # Builds the FTP exploit.
+  #
+  def build
+  end
+
+  #
+  # Deploys the built FTP exploit.
+  #
+  def deploy
+  end
+
+end

data/static/ronin/generators/exploits/http.erb

@@ -0,0 +1,26 @@
+<%= template '_header.erb' %>
+
+ronin_http_exploit do
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+<% if options[:default_port] %>
+    self.default_port = <%= options[:default_port].inspect %><% end %>
+  end
+
+  #
+  # Builds the HTTP exploit.
+  #
+  def build
+  end
+
+  #
+  # Deploys the built HTTP exploit.
+  #
+  def deploy
+  end
+
+end

data/static/ronin/generators/exploits/local.erb

@@ -0,0 +1,24 @@
+<%= template '_header.erb' %>
+
+ronin_local_exploit do
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+  end
+
+  #
+  # Builds the local exploit.
+  #
+  def build
+  end
+
+  #
+  # Deploys the built local exploit.
+  #
+  def deploy
+  end
+
+end

data/static/ronin/generators/exploits/remote.erb

@@ -0,0 +1,24 @@
+<%= template '_header.erb' %>
+
+ronin_remote_exploit do
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+  end
+
+  #
+  # Builds the remote exploit.
+  #
+  def build
+  end
+
+  #
+  # Deploys the built remote exploit.
+  #
+  def deploy
+  end
+
+end

data/static/ronin/generators/exploits/remote_tcp.erb

@@ -0,0 +1,26 @@
+<%= template '_header.erb' %>
+
+ronin_remote_tcp_exploit do
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+<% if options[:default_port] %>
+    self.default_port = <%= options[:default_port].inspect %><% end %>
+  end
+
+  #
+  # Builds the remote tcp exploit.
+  #
+  def build
+  end
+
+  #
+  # Deploys the built remote tcp exploit.
+  #
+  def deploy
+  end
+
+end

data/static/ronin/generators/exploits/remote_udp.erb

@@ -0,0 +1,26 @@
+<%= template '_header.erb' %>
+
+ronin_remote_udp_exploit do
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+<% if options[:default_port] %>
+    self.default_port = <%= options[:default_port].inspect %><% end %>
+  end
+
+  #
+  # Builds the remote udp exploit.
+  #
+  def build
+  end
+
+  #
+  # Deploys the built remote udp exploit.
+  #
+  def deploy
+  end
+
+end

data/static/ronin/generators/exploits/web.erb

@@ -0,0 +1,28 @@
+<%= template '_header.erb' %>
+
+ronin_web_exploit do
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+<% if options[:url_path] %>
+    self.url_path = <%= options[:url_path].inspect %><% end
+   if options[:url_query] %>
+    self.url_query = <%= options[:url_query].inspect %><% end %>
+  end
+
+  #
+  # Builds the web exploit.
+  #
+  def build
+  end
+
+  #
+  # Deploys the built web exploit.
+  #
+  def deploy
+  end
+
+end

data/static/ronin/generators/payloads/_cache.erb

@@ -0,0 +1,10 @@
+    self.name = <%= options[:name].inspect %>
+    self.version = <%= options[:version].inspect %>
+    self.description = %{<%= options[:description] %>}
+
+    <% options[:authors].each do |author| %>
+    author(:name => <%= author.inspect %>)
+    <% end
+    unless options[:controls].empty? %>
+    control <%= options[:controls].map { |name| name.to_sym.inspect }.join(', ') %>
+    <% end %>

data/static/ronin/generators/payloads/_header.erb

@@ -0,0 +1 @@
+#!/usr/bin/ronin-payload -f

data/static/ronin/generators/payloads/_helpers.erb

@@ -0,0 +1,2 @@
+<% options[:helpers].each do |name| %>  helper <%= name.to_sym.inspect %>
+<% end %>

data/static/ronin/generators/payloads/binary_payload.erb

@@ -0,0 +1,25 @@
+<%= template '_header.erb' %>
+
+ronin_binary_payload do
+
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+  end
+
+  #
+  # Builds the binary payload.
+  #
+  def build
+  end
+
+  #
+  # Deploys the binary payload.
+  #
+  def deploy
+  end
+
+end

data/static/ronin/generators/payloads/nops.erb

@@ -0,0 +1,19 @@
+<%= template '_header.erb' %>
+
+ronin_nops do
+
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+  end
+
+  #
+  # Builds the NOPs.
+  #
+  def build
+  end
+
+end

data/static/ronin/generators/payloads/payload.erb

@@ -0,0 +1,25 @@
+<%= template '_header.erb' %>
+
+ronin_payload do
+
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+  end
+
+  #
+  # Builds the payload.
+  #
+  def build
+  end
+
+  #
+  # Deploys the payload.
+  #
+  def deploy
+  end
+
+end

data/static/ronin/generators/payloads/shellcode.erb

@@ -0,0 +1,25 @@
+<%= template '_header.erb' %>
+
+ronin_shellcode do
+
+<%= template '_helpers.erb' %>
+  #
+  # Cacheable data.
+  #
+  cache do
+<%= template '_cache.erb' %>
+  end
+
+  #
+  # Builds the shellcode.
+  #
+  def build
+  end
+
+  #
+  # Deploys the shellcode.
+  #
+  def deploy
+  end
+
+end

data/tasks/spec.rb

@@ -6,4 +6,5 @@ Spec::Rake::SpecTask.new(:spec) do |t|
   t.spec_opts = ['--colour', '--format', 'specdoc']
 end
 
+task :test => :spec
 task :default => :spec

data/tasks/yard.rb

@@ -0,0 +1,13 @@
+require 'ronin/yard/handlers'
+
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb']
+  t.options = [
+    '--protected',
+    '--files', 'History.txt',
+    '--title', 'Ronin Exploits',
+    '--quiet'
+  ]
+end
+
+task :docs => :yardoc

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ronin-exploits
 version: !ruby/object:Gem::Version 
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors: 
 - Postmodern
@@ -30,7 +30,7 @@ cert_chain:
   pDj+ws7QjtH/Qcrr1l9jfN0ehDs=
   -----END CERTIFICATE-----
 
-date: 2009-07-08 00:00:00 -07:00
+date: 2009-09-25 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -41,7 +41,37 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.2.4
+        version: 0.3.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: ronin-gen
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.8
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.3.5
     version: 
 - !ruby/object:Gem::Dependency 
   name: hoe
@@ -51,21 +81,34 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 2.3.2
+        version: 2.3.3
     version: 
 description: |-
   Ronin Exploits is a Ruby library for Ronin that provides exploitation and
   payload crafting functionality.
   
-  Ronin is a Ruby platform designed for information security and data
-  exploration tasks. Ronin allows for the rapid development and distribution
-  of code over many of the common Source-Code-Management (SCM) systems.
+  Ronin is a Ruby platform for exploit development and security research.
+  Ronin allows for the rapid development and distribution of code, exploits
+  or payloads over many common Source-Code-Management (SCM) systems.
 email: 
 - postmodern.mod3@gmail.com
 executables: 
 - ronin-payload
+- ronin-exploit
 - ronin-payloads
 - ronin-exploits
+- ronin-gen-exploit
+- ronin-gen-local-exploit
+- ronin-gen-remote-exploit
+- ronin-gen-remote-tcp-exploit
+- ronin-gen-remote-udp-exploit
+- ronin-gen-http-exploit
+- ronin-gen-ftp-exploit
+- ronin-gen-web-exploit
+- ronin-gen-payload
+- ronin-gen-binary-payload
+- ronin-gen-shellcode
+- ronin-gen-nops
 extensions: []
 
 extra_rdoc_files: 
@@ -73,33 +116,61 @@ extra_rdoc_files:
 - COPYING.txt
 - Manifest.txt
 - README.txt
-- TODO.txt
 files: 
 - History.txt
 - COPYING.txt
 - Manifest.txt
 - README.txt
 - Rakefile
-- TODO.txt
 - bin/ronin-payload
+- bin/ronin-exploit
 - bin/ronin-payloads
 - bin/ronin-exploits
+- bin/ronin-gen-exploit
+- bin/ronin-gen-local-exploit
+- bin/ronin-gen-remote-exploit
+- bin/ronin-gen-remote-tcp-exploit
+- bin/ronin-gen-remote-udp-exploit
+- bin/ronin-gen-http-exploit
+- bin/ronin-gen-ftp-exploit
+- bin/ronin-gen-web-exploit
+- bin/ronin-gen-payload
+- bin/ronin-gen-binary-payload
+- bin/ronin-gen-shellcode
+- bin/ronin-gen-nops
 - lib/ronin/model/has_default_port.rb
 - lib/ronin/model/targets_arch.rb
 - lib/ronin/model/targets_os.rb
+- lib/ronin/model/targets_product.rb
 - lib/ronin/vuln/behavior.rb
+- lib/ronin/controls.rb
+- lib/ronin/controls/exceptions.rb
+- lib/ronin/controls/exceptions/not_implemented.rb
+- lib/ronin/controls/exceptions/program_not_found.rb
+- lib/ronin/controls/behaviors.rb
+- lib/ronin/controls/file_system.rb
+- lib/ronin/controls/helpers.rb
+- lib/ronin/controls/helpers/memory_read.rb
+- lib/ronin/controls/helpers/memory_write.rb
+- lib/ronin/controls/helpers/file_read.rb
+- lib/ronin/controls/helpers/file_write.rb
+- lib/ronin/controls/helpers/file_remove.rb
+- lib/ronin/controls/helpers/file_ownership.rb
+- lib/ronin/controls/helpers/file_mtime.rb
+- lib/ronin/controls/helpers/file_ctime.rb
+- lib/ronin/controls/helpers/dir_listing.rb
+- lib/ronin/controls/helpers/dir_create.rb
+- lib/ronin/controls/helpers/dir_remove.rb
+- lib/ronin/controls/helpers/command_exec.rb
 - lib/ronin/exploits.rb
 - lib/ronin/exploits/exceptions.rb
+- lib/ronin/exploits/exceptions/exception.rb
 - lib/ronin/exploits/exceptions/unknown_helper.rb
 - lib/ronin/exploits/exceptions/target_unspecified.rb
 - lib/ronin/exploits/exceptions/target_data_missing.rb
 - lib/ronin/exploits/exceptions/exploit_not_built.rb
 - lib/ronin/exploits/exceptions/restricted_char.rb
 - lib/ronin/exploits/exceptions/payload_size.rb
-- lib/ronin/exploits/arch.rb
-- lib/ronin/exploits/os.rb
-- lib/ronin/exploits/license.rb
-- lib/ronin/exploits/product.rb
 - lib/ronin/exploits/verifiers.rb
 - lib/ronin/exploits/helpers.rb
 - lib/ronin/exploits/helpers/file_based.rb
@@ -110,7 +181,7 @@ files:
 - lib/ronin/exploits/targets.rb
 - lib/ronin/exploits/targets/buffer_overflow.rb
 - lib/ronin/exploits/targets/format_string.rb
-- lib/ronin/exploits/allow.rb
+- lib/ronin/exploits/control.rb
 - lib/ronin/exploits/target.rb
 - lib/ronin/exploits/exploit.rb
 - lib/ronin/exploits/exploit_author.rb
@@ -124,20 +195,16 @@ files:
 - lib/ronin/exploits/version.rb
 - lib/ronin/payloads.rb
 - lib/ronin/payloads/exceptions.rb
+- lib/ronin/payloads/exceptions/exception.rb
 - lib/ronin/payloads/exceptions/unknown_helper.rb
-- lib/ronin/payloads/license.rb
-- lib/ronin/payloads/arch.rb
-- lib/ronin/payloads/os.rb
-- lib/ronin/payloads/encoder.rb
-- lib/ronin/payloads/encoders.rb
-- lib/ronin/payloads/encoders/xor.rb
+- lib/ronin/payloads/exceptions/not_implemented.rb
 - lib/ronin/payloads/helpers.rb
-- lib/ronin/payloads/helpers/exceptions.rb
-- lib/ronin/payloads/helpers/exceptions/not_implemented.rb
-- lib/ronin/payloads/helpers/exceptions/program_not_found.rb
-- lib/ronin/payloads/helpers/file_system.rb
-- lib/ronin/payloads/helpers/shell.rb
+- lib/ronin/payloads/helpers/chained.rb
 - lib/ronin/payloads/helpers/rpc.rb
+- lib/ronin/payloads/encoders.rb
+- lib/ronin/payloads/encoders/encoder.rb
+- lib/ronin/payloads/encoders/xor.rb
+- lib/ronin/payloads/has_payload.rb
 - lib/ronin/payloads/control.rb
 - lib/ronin/payloads/payload_author.rb
 - lib/ronin/payloads/payload.rb
@@ -146,25 +213,76 @@ files:
 - lib/ronin/payloads/nops.rb
 - lib/ronin/payloads/shellcode.rb
 - lib/ronin/payloads/web_payload.rb
+- lib/ronin/generators/exploits.rb
+- lib/ronin/generators/exploits/exploit.rb
+- lib/ronin/generators/exploits/local.rb
+- lib/ronin/generators/exploits/remote.rb
+- lib/ronin/generators/exploits/remote_tcp.rb
+- lib/ronin/generators/exploits/remote_udp.rb
+- lib/ronin/generators/exploits/http.rb
+- lib/ronin/generators/exploits/ftp.rb
+- lib/ronin/generators/exploits/web.rb
+- lib/ronin/generators/exploits/static.rb
+- lib/ronin/generators/payloads.rb
+- lib/ronin/generators/payloads/payload.rb
+- lib/ronin/generators/payloads/binary_payload.rb
+- lib/ronin/generators/payloads/shellcode.rb
+- lib/ronin/generators/payloads/nops.rb
+- lib/ronin/generators/payloads/static.rb
 - lib/ronin/ui/command_line/commands/payload.rb
+- lib/ronin/ui/command_line/commands/exploit.rb
 - lib/ronin/ui/command_line/commands/payloads.rb
 - lib/ronin/ui/command_line/commands/exploits.rb
+- lib/ronin/ui/command_line/commands/gen_exploit.rb
+- lib/ronin/ui/command_line/commands/gen_local_exploit.rb
+- lib/ronin/ui/command_line/commands/gen_remote_exploit.rb
+- lib/ronin/ui/command_line/commands/gen_remote_tcp_exploit.rb
+- lib/ronin/ui/command_line/commands/gen_remote_udp_exploit.rb
+- lib/ronin/ui/command_line/commands/gen_http_exploit.rb
+- lib/ronin/ui/command_line/commands/gen_ftp_exploit.rb
+- lib/ronin/ui/command_line/commands/gen_web_exploit.rb
+- lib/ronin/ui/command_line/commands/gen_payload.rb
+- lib/ronin/ui/command_line/commands/gen_binary_payload.rb
+- lib/ronin/ui/command_line/commands/gen_shellcode.rb
+- lib/ronin/ui/command_line/commands/gen_nops.rb
 - tasks/spec.rb
+- tasks/yard.rb
+- static/ronin/generators/exploits/_header.erb
+- static/ronin/generators/exploits/_helpers.erb
+- static/ronin/generators/exploits/_cache.erb
+- static/ronin/generators/exploits/exploit.erb
+- static/ronin/generators/exploits/local.erb
+- static/ronin/generators/exploits/remote.erb
+- static/ronin/generators/exploits/remote_tcp.erb
+- static/ronin/generators/exploits/remote_udp.erb
+- static/ronin/generators/exploits/http.erb
+- static/ronin/generators/exploits/ftp.erb
+- static/ronin/generators/exploits/web.erb
+- static/ronin/generators/payloads/_header.erb
+- static/ronin/generators/payloads/_helpers.erb
+- static/ronin/generators/payloads/_cache.erb
+- static/ronin/generators/payloads/payload.erb
+- static/ronin/generators/payloads/binary_payload.erb
+- static/ronin/generators/payloads/shellcode.erb
+- static/ronin/generators/payloads/nops.erb
 - spec/spec_helper.rb
 - spec/helpers/database.rb
 - spec/helpers/objects.rb
-- spec/objects/exploits/test.rb
+- spec/objects/exploits/simple.rb
 - spec/objects/exploits/example.rb
-- spec/objects/payloads/test.rb
+- spec/objects/payloads/simple.rb
 - spec/exploits_spec.rb
 - spec/model/models/default_port_model.rb
 - spec/model/models/non_default_port_model.rb
 - spec/model/models/targets_arch_model.rb
 - spec/model/models/targets_os_model.rb
+- spec/model/models/targets_product_model.rb
 - spec/model/has_default_port_spec.rb
 - spec/model/targets_arch_spec.rb
 - spec/model/targets_os_spec.rb
+- spec/model/targets_product_spec.rb
 - spec/vuln/behavior_spec.rb
+- spec/controls/behaviors_examples.rb
 - spec/exploits/targets/buffer_overflow_spec.rb
 - spec/exploits/target_spec.rb
 - spec/exploits/exploit_spec.rb
@@ -178,10 +296,24 @@ files:
 - spec/exploits/padding_exploit_spec.rb
 - spec/exploits/buffer_overflow_exploit_spec.rb
 - spec/exploits/format_string_exploit_spec.rb
-- spec/payloads/encoder_spec.rb
+- spec/payloads/encoders/encoder_spec.rb
 - spec/payloads/encoders/xor_spec.rb
 - spec/payloads/payload_spec.rb
-has_rdoc: true
+- spec/generators/exploits/exploit_examples.rb
+- spec/generators/exploits/exploit_spec.rb
+- spec/generators/exploits/local_spec.rb
+- spec/generators/exploits/remote_spec.rb
+- spec/generators/exploits/remote_tcp_spec.rb
+- spec/generators/exploits/remote_udp_spec.rb
+- spec/generators/exploits/http_spec.rb
+- spec/generators/exploits/ftp_spec.rb
+- spec/generators/exploits/web_spec.rb
+- spec/generators/payloads/payload_examples.rb
+- spec/generators/payloads/payload_spec.rb
+- spec/generators/payloads/binary_payload_spec.rb
+- spec/generators/payloads/shellcode_spec.rb
+- spec/generators/payloads/nops_spec.rb
+has_rdoc: yard
 homepage: http://ronin.rubyforge.org/exploits/
 licenses: []
 
@@ -206,7 +338,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: ronin
-rubygems_version: 1.3.4
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
 summary: Ronin Exploits is a Ruby library for Ronin that provides exploitation and payload crafting functionality