pwn 0.5.15 → 0.5.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca005bf83f64e7926d3e22c14ce0a0b742ef1853c5ea6da768a324ab0504ac3d
-  data.tar.gz: 29b3ee47db3700a71b3f06a53337d8b225e6c5c43bb8fb88eb824d5e212c1988
+  metadata.gz: cc85d1a101656ee9aec078f6d1f22ce6321eb026411a99741016b0a6f9f57825
+  data.tar.gz: 1d5ea91b0a93c1b883e33464431c68acdcdac06d6d2a6d33d7d7dfb07f9ccde0
 SHA512:
-  metadata.gz: 532f192473d0b71ded741f93a1eae042d8ad0a3c7ab833b676011d7e22ea8da43763f4d1b8c3c30f946eec467b9ba2e2e435e13554ee67d86786e5fd8025b83a
-  data.tar.gz: 9dd7580d09ed7215c5fe35f0658250b3face53484d2a87dd90719d0e1b3bc1e1857992ff1a210761009a41c688c3b99af2c7ed4df77841395a6950bd6de48c58
+  metadata.gz: 1a08f6c2484a5e31cb51068d67c0964f76b310b1046d7ce34ff33661af91ef7538ac58f060acc9b02b09846e8703de636c0d9e65d68ba9c10bfbe43adb2058ce
+  data.tar.gz: 5556463bff9ea637bd8fa7659d37234c15bab2e6cf002b2db0dbe1cb04fd0274eafd838484440f81029d19f6c6ebece8d5847aae062d911755be0fac66444e6b

data/README.md

@@ -37,7 +37,7 @@ $ cd /opt/pwn
 $ ./install.sh
 $ ./install.sh ruby-gem
 $ pwn
-pwn[v0.5.15]:001 >>> PWN.help
+pwn[v0.5.16]:001 >>> PWN.help
 ```
 
 [![Installing the pwn Security Automation Framework](https://raw.githubusercontent.com/0dayInc/pwn/master/documentation/pwn_install.png)](https://youtu.be/G7iLUY4FzsI)
@@ -52,7 +52,7 @@ $ rvm use ruby-3.3.0@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.5.15]:001 >>> PWN.help
+pwn[v0.5.16]:001 >>> PWN.help
 ```
 
 If you're using a multi-user install of RVM do:
@@ -62,7 +62,7 @@ $ rvm use ruby-3.3.0@pwn
 $ rvmsudo gem uninstall --all --executables pwn
 $ rvmsudo gem install --verbose pwn
 $ pwn
-pwn[v0.5.15]:001 >>> PWN.help
+pwn[v0.5.16]:001 >>> PWN.help
 ```
 
 PWN periodically upgrades to the latest version of Ruby which is reflected in `/opt/pwn/.ruby-version`.  The easiest way to upgrade to the latest version of Ruby from a previous PWN installation is to run the following script:

data/lib/pwn/plugins/assembly.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require 'tempfile'
+
+module PWN
+  module Plugins
+    # This plugin converts images to readable text
+    module Assembly
+      # Supported Method Parameters::
+      # PWN::Plugins::Assembly.opcode_to_asm(
+      #   opcodes: 'required - hex escaped opcode(s) (e.g. '\x90\x90\x90')',
+      #   arch: 'optional - architecture (defaults to PWN::Plugins::DetectOS.arch)'
+      # )
+
+      public_class_method def self.opcode_to_asm(opts = {})
+        opcodes = opts[:opcodes]
+        arch = opts[:arch] ||= PWN::Plugins::DetectOS.arch
+
+        opcodes_tmp = Tempfile.new('pwn_opcodes')
+        File.binwrite(opcodes_tmp.path, opcodes)
+        asm = `objdump -M intel -b binary -m #{arch} -D #{opcodes_tmp.path}`
+        opcodes_tmp.unlink
+
+        asm
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::Plugins::Assembly.asm_to_opcode(
+      #   asm: 'required - assembly code(s) (e.g. 'nop\nnop\nnop\njmp rsp\n)',
+      #   arch: 'optional - architecture (defaults to PWN::Plugins::DetectOS.arch)'
+      # )
+
+      public_class_method def self.asm_to_opcode(opts = {})
+        asm = opts[:asm]
+        arch = opts[:arch] ||= PWN::Plugins::DetectOS.arch
+
+        asm_code = ".global _start\n_start:\n#{asm}"
+
+        asm_tmp = Tempfile.new('pwn_asm')
+        asm_tmp.write(asm_code)
+        asm_tmp.close
+
+        system('as', '-o', "#{asm_tmp.path}.o", asm_tmp.path)
+        opcodes = `objdump -d #{asm_tmp.path}.o`
+        asm_tmp.unlink
+
+        opcodes
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <request.pentest@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <request.pentest@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          #{self}.opcode_to_asm(
+            opcodes: 'required - hex escaped opcode(s) (e.g. '\\x90\\x90\\x90')',
+            arch: 'optional - architecture (defaults to PWN::Plugins::DetectOS.arch)'
+          )
+
+          #{self}.asm_to_opcode(
+            asm: 'required - assembly code(s) (e.g. 'jmp rsp')',
+            arch: 'optional - architecture (defaults to PWN::Plugins::DetectOS.arch)'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/plugins/detect_os.rb

@@ -46,6 +46,8 @@ module PWN
         puts "USAGE:
           #{self}.type
 
+          #{self}.arch
+
           #{self}.authors
         "
       end

data/lib/pwn/plugins.rb

@@ -7,6 +7,7 @@ module PWN
   module Plugins
     autoload :Android, 'pwn/plugins/android'
     autoload :AnsibleVault, 'pwn/plugins/ansible_vault'
+    autoload :Assembly, 'pwn/plugins/assembly'
     autoload :AuthenticationHelper, 'pwn/plugins/authentication_helper'
     autoload :BareSIP, 'pwn/plugins/baresip'
     autoload :BasicAuth, 'pwn/plugins/basic_auth'

data/lib/pwn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PWN
-  VERSION = '0.5.15'
+  VERSION = '0.5.16'
 end

data/spec/lib/pwn/plugins/assembly_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::Plugins::Assembly do
+  it 'should display information for authors' do
+    authors_response = PWN::Plugins::Assembly
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::Plugins::Assembly
+    expect(help_response).to respond_to :help
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.15
+  version: 0.5.16
 platform: ruby
 authors:
 - 0day Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-02-24 00:00:00.000000000 Z
+date: 2024-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -1707,6 +1707,7 @@ files:
 - lib/pwn/plugins.rb
 - lib/pwn/plugins/android.rb
 - lib/pwn/plugins/ansible_vault.rb
+- lib/pwn/plugins/assembly.rb
 - lib/pwn/plugins/authentication_helper.rb
 - lib/pwn/plugins/baresip.rb
 - lib/pwn/plugins/basic_auth.rb
@@ -2032,6 +2033,7 @@ files:
 - spec/lib/pwn/ffi_spec.rb
 - spec/lib/pwn/plugins/android_spec.rb
 - spec/lib/pwn/plugins/ansible_vault_spec.rb
+- spec/lib/pwn/plugins/assembly_spec.rb
 - spec/lib/pwn/plugins/authentication_helper_spec.rb
 - spec/lib/pwn/plugins/baresip_spec.rb
 - spec/lib/pwn/plugins/basic_auth_spec.rb