rex-java 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b1cc8296c437588d34502bf7ce4eb44011c8ebda
+  data.tar.gz: a93efc058ae439f2588a6b28c58e5413cf2571db
+SHA512:
+  metadata.gz: ca9cb732b9140e11c385023f75630f9d57cf7e4c35a9d56ec41aecda7126216da8600ab6b5fcbcb966c466ce8493541df17cc694a555b9f5533d715c5f5ec975
+  data.tar.gz: 8680ab754505669e9e775cb371a77cc1e5a1e460aca60e4a37c3cf63b568f98dae17f729b1b082c4262054699277f05565d5fbcd71ea11e9138a7ce3cf000bfc

checksums.yaml.gz.sig

@@ -0,0 +1,3 @@
+7)c��d��)V֍��P8A��?8�C�<Ɩ�)�XP|�
+�!xZ1�g�%������)��-�A>��Ї̚�:T���$m-���C�����=F å�-+iN]�H+q���TQ���{���k1JH
+��誣|ޱ��A���P���/&Z���!}A��^�l\�b�-P˿M

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.1.5
+before_install: gem install bundler -v 1.12.5

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,52 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project maintainers at msfdev@metasploit.com. If
+the incident involves a committer, you may report directly to
+egypt@metasploit.com or todb@metasploit.com.
+
+All complaints will be reviewed and investigated and will result in a
+response that is deemed necessary and appropriate to the circumstances.
+Maintainers are obligated to maintain confidentiality with regard to the
+reporter of an incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rex-java.gemspec
+gemspec

data/README.md

@@ -0,0 +1,36 @@
+# Rex::Java
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/rex/java`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'rex-java'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install rex-java
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/rapid7/rex-java. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "rex/java"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/rex/java.rb

@@ -0,0 +1,10 @@
+# -*- coding: binary -*-
+
+require "rex/java/version"
+require 'rex/java/serialization'
+
+module Rex
+  module Java
+    # Your code goes here...
+  end
+end

data/lib/rex/java/serialization.rb

@@ -0,0 +1,57 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Java
+    # Include constants defining terminal and constant
+    # values expected in a stream.
+    module Serialization
+      STREAM_MAGIC = 0xaced
+      STREAM_VERSION = 5
+      TC_NULL = 0x70
+      TC_REFERENCE = 0x71
+      TC_CLASSDESC = 0x72
+      TC_OBJECT = 0x73
+      TC_STRING = 0x74
+      TC_ARRAY = 0x75
+      TC_CLASS = 0x76
+      TC_BLOCKDATA = 0x77
+      TC_ENDBLOCKDATA = 0x78
+      TC_RESET = 0x79
+      TC_BLOCKDATALONG = 0x7A
+      TC_EXCEPTION = 0x7B
+      TC_LONGSTRING =  0x7C
+      TC_PROXYCLASSDESC =  0x7D
+      TC_ENUM =  0x7E
+      BASE_WIRE_HANDLE = 0x7E0000
+
+      SC_WRITE_METHOD = 0x01 # if SC_SERIALIZABLE
+      SC_BLOCK_DATA = 0x08   # if SC_EXTERNALIZABLE
+      SC_SERIALIZABLE = 0x02
+      SC_EXTERNALIZABLE = 0x04
+      SC_ENUM = 0x10
+
+      PRIMITIVE_TYPE_CODES = {
+        'B' => 'byte',
+        'C' => 'char',
+        'D' => 'double',
+        'F' => 'float',
+        'I' => 'int',
+        'J' => 'long',
+        'S' => 'short',
+        'Z' => 'boolean'
+      }
+
+      OBJECT_TYPE_CODES = {
+        '[' => 'array',
+        'L' => 'object'
+      }
+
+      TYPE_CODES = PRIMITIVE_TYPE_CODES.merge(OBJECT_TYPE_CODES)
+    end
+  end
+end
+
+require 'rex/java/serialization/decode_error'
+require 'rex/java/serialization/encode_error'
+require 'rex/java/serialization/model'
+require 'rex/java/serialization/builder'

data/lib/rex/java/serialization/builder.rb

@@ -0,0 +1,94 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Java
+    module Serialization
+      # This class provides a builder to help in the construction of
+      # Java serialized contents.
+      class Builder
+
+        # Creates a Rex::Java::Serialization::Model::NewArray
+        #
+        # @param opts [Hash{Symbol => <Rex::Java::Serialization::Model::NewClassDesc, String, Array>}]
+        # @option opts [Rex::Java::Serialization::Model::NewClassDesc] :description
+        # @option opts [String] :values_type
+        # @option opts [Array] :values
+        # @return [Rex::Java::Serialization::Model::NewArray]
+        # @see #new_class
+        def new_array(opts = {})
+          class_desc = opts[:description] || new_class(opts)
+          type = opts[:values_type] || ''
+          values = opts[:values] || []
+
+          array = Rex::Java::Serialization::Model::NewArray.new
+          array.array_description = Rex::Java::Serialization::Model::ClassDesc.new
+          array.array_description.description = class_desc
+          array.type = type
+          array.values = values
+
+          array
+        end
+
+        # Creates a Rex::Java::Serialization::Model::NewObject
+        #
+        # @param opts [Hash{Symbol => <Rex::Java::Serialization::Model::NewClassDesc, Array>}]
+        # @option opts [Rex::Java::Serialization::Model::NewClassDesc] :description
+        # @option opts [Array] :data
+        # @return [Rex::Java::Serialization::Model::NewObject]
+        # @see #new_class
+        def new_object(opts = {})
+          class_desc = opts[:description] || new_class(opts)
+          data = opts[:data] || []
+
+          object = Rex::Java::Serialization::Model::NewObject.new
+          object.class_desc = Rex::Java::Serialization::Model::ClassDesc.new
+          object.class_desc.description = class_desc
+          object.class_data = data
+
+          object
+        end
+
+        # Creates a Rex::Java::Serialization::Model::NewClassDesc
+        #
+        # @param opts [Hash{Symbol => <Rex::Java::Serialization::Model::NewClassDesc, Array>}]
+        # @option opts [String] :name
+        # @option opts [Fixnum] :serial
+        # @option opts [Fixnum] :flags
+        # @option opts [Array] :fields
+        # @option opts [Array] :annotations
+        # @option opts [Rex::Java::Serialization::Model::Element] :super_class
+        # @return [Rex::Java::Serialization::Model::NewClassDesc]
+        def new_class(opts = {})
+          class_name = opts[:name] || ''
+          serial_version = opts[:serial] || 0
+          flags = opts[:flags] || 2
+          fields = opts[:fields] || []
+          annotations = opts[:annotations] || [Rex::Java::Serialization::Model::NullReference.new,
+                                               Rex::Java::Serialization::Model::EndBlockData.new]
+          super_class = opts[:super_class] || Rex::Java::Serialization::Model::NullReference.new
+
+          class_desc = Rex::Java::Serialization::Model::NewClassDesc.new
+          class_desc.class_name = Rex::Java::Serialization::Model::Utf.new(nil, class_name)
+          class_desc.serial_version = serial_version
+          class_desc.flags = flags
+          class_desc.fields = []
+
+          fields.each do |f|
+            field = Rex::Java::Serialization::Model::Field.new
+            field.type = f[0]
+            field.name = Rex::Java::Serialization::Model::Utf.new(nil, f[1])
+            field.field_type = Rex::Java::Serialization::Model::Utf.new(nil, f[2]) if f[2]
+            class_desc.fields << field
+          end
+
+          class_desc.class_annotation = Rex::Java::Serialization::Model::Annotation.new
+          class_desc.class_annotation.contents = annotations
+          class_desc.super_class = Rex::Java::Serialization::Model::ClassDesc.new
+          class_desc.super_class.description = super_class
+
+          class_desc
+        end
+      end
+    end
+  end
+end

data/lib/rex/java/serialization/decode_error.rb

@@ -0,0 +1,11 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Java
+    module Serialization
+      class DecodeError < ::RuntimeError
+
+      end
+    end
+  end
+end

data/lib/rex/java/serialization/encode_error.rb

@@ -0,0 +1,11 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Java
+    module Serialization
+      class EncodeError < ::RuntimeError
+
+      end
+    end
+  end
+end

data/lib/rex/java/serialization/model.rb

@@ -0,0 +1,33 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Java
+    module Serialization
+      module Model
+
+        autoload :Annotation,     'rex/java/serialization/model/annotation'
+        autoload :BlockDataLong,  'rex/java/serialization/model/block_data_long'
+        autoload :BlockData,      'rex/java/serialization/model/block_data'
+        autoload :ClassDesc,      'rex/java/serialization/model/class_desc'
+        autoload :Contents,       'rex/java/serialization/model/contents'
+        autoload :Element,        'rex/java/serialization/model/element'
+        autoload :EndBlockData,   'rex/java/serialization/model/end_block_data'
+        autoload :Field,          'rex/java/serialization/model/field'
+        autoload :LongUtf,        'rex/java/serialization/model/long_utf'
+        autoload :NewArray,       'rex/java/serialization/model/new_array'
+        autoload :ProxyClassDesc, 'rex/java/serialization/model/proxy_class_desc'
+        autoload :NewClassDesc,   'rex/java/serialization/model/new_class_desc'
+        autoload :NewEnum,        'rex/java/serialization/model/new_enum'
+        autoload :NewObject,      'rex/java/serialization/model/new_object'
+        autoload :NewClass,       'rex/java/serialization/model/new_class'
+        autoload :NullReference,  'rex/java/serialization/model/null_reference'
+        autoload :Reference,      'rex/java/serialization/model/reference'
+        autoload :Reset,          'rex/java/serialization/model/reset'
+        autoload :Stream,         'rex/java/serialization/model/stream'
+        autoload :Utf,            'rex/java/serialization/model/utf'
+
+      end
+    end
+  end
+end
+

data/lib/rex/java/serialization/model/annotation.rb

@@ -0,0 +1,69 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Java
+    module Serialization
+      module Model
+        # This class provides an annotation representation. It's used for both class
+        # annotations (classAnnotation) and object annotations (objectAnnotation).
+        class Annotation < Element
+
+          include Rex::Java::Serialization::Model::Contents
+
+          # @!attribute contents
+          #   @return [Array] The annotation contents
+          attr_accessor :contents
+
+          # @param stream [Rex::Java::Serialization::Model::Stream] the stream where it belongs to
+          def initialize(stream = nil)
+            super(stream)
+            self.contents = []
+          end
+
+          # Deserializes a Rex::Java::Serialization::Model::Annotation
+          #
+          # @param io [IO] the io to read from
+          # @return [self] if deserialization succeeds
+          # @raise [Rex::Java::Serialization::DecodeError] if deserialization doesn't succeed
+          def decode(io)
+            loop do
+              content = decode_content(io, stream)
+              self.contents << content
+              return self if content.kind_of?(EndBlockData)
+            end
+
+            self
+          end
+
+          # Serializes the Rex::Java::Serialization::Model::Annotation
+          #
+          # @return [String] if serialization suceeds
+          # @raise [Rex::Java::Serialization::EncodeError] if serialization doesn't succeed
+          def encode
+            raise Rex::Java::Serialization::EncodeError, 'Failed to serialize Annotation with empty contents' if contents.empty?
+
+            encoded = ''
+
+            contents.each do |content|
+              encoded << encode_content(content)
+            end
+
+            encoded
+          end
+
+          # Creates a print-friendly string representation
+          #
+          # @return [String]
+          def to_s
+            str = '[ '
+            contents_data = contents.collect {|content| "#{print_content(content)}"}
+            str << contents_data.join(', ')
+            str << ' ]'
+            str
+          end
+
+        end
+      end
+    end
+  end
+end