keystone-engine 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6e12313098bec81cc9d176bcfe0e6dea4886f825
+  data.tar.gz: 83df6a1a369e4611d03c92b0efbfcc86863a9e19
+SHA512:
+  metadata.gz: 190a6ea3b49d9f302a54fdbf3ad73ac3d5b9407a22641c6e97bd7902107330435fa0f8ad11be1ac79675b84be2b3eaa04790e596374dfff85196c0fca32504dd
+  data.tar.gz: c828d56ca92f0d03ffb23c443949d6d56ba7a2f12512d89e848cbe8aada8843f99fb5057a0fd3e8217dc57ce53a0d9a44b965fd9ad78c8c05ca19a19211f7857

data/lib/keystone_engine.rb

@@ -0,0 +1,77 @@
+# Ruby bindings for the Keystone Engine
+#
+# Copyright(c) 2017 Sascha Schirra
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# version 2 as published by the Free Software Foundation.
+#
+# 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 "ffi"
+require "objspace"
+
+
+module KeystoneEngine extend FFI::Library
+    ffi_lib "keystone"
+
+    class IntPtr < FFI::Struct
+        layout  :value, :size_t
+    end
+    class KsEnginePtr < FFI::Struct
+        layout :value, :pointer
+    end
+    class StringPtr < FFI::Struct
+        layout :value, :pointer
+    end
+
+    attach_function :ks_open, [:int, :int, KsEnginePtr], :int
+    attach_function :ks_close, [:pointer], :int
+    attach_function :ks_errno, [:pointer], :int
+    attach_function :ks_strerror, [:int], :pointer
+    attach_function :ks_asm, [:pointer, :pointer, :uint64, StringPtr, IntPtr, IntPtr], :int
+
+    class KsError < StandardError
+    end
+
+    class Ks
+        private
+        attr_accessor :ks
+
+        public
+        def initialize(arch, mode)
+            _ks = KsEnginePtr.new
+            err = KeystoneEngine::ks_open(arch, mode, _ks)
+            if err != KS_ERR_OK
+                raise KsError, KeystoneEngine::ks_strerror(err).read_string
+            end
+            @ks = _ks[:value]
+
+            ObjectSpace.define_finalizer(self, proc{ KeystoneEngine::ks_close(ks) })
+        end
+
+        def asm(instructions, address=0)
+            inst = FFI::MemoryPointer.from_string(instructions)
+            bytes = StringPtr.new
+            size = IntPtr.new 
+            count = IntPtr.new
+            err = KeystoneEngine::ks_asm(ks, inst, address, bytes, size, count)
+
+            if err != KS_ERR_OK
+                raise KsError, KeystoneEngine::ks_strerror(err).read_string
+            end
+
+            return [bytes[:value].read_string(size[:value]), count[:value]]
+        end
+
+    end
+
+end

data/lib/keystone_engine/arm64_const.rb

@@ -0,0 +1,6 @@
+
+module KeystoneEngine
+	KS_ERR_ASM_ARM64_INVALIDOPERAND = 512
+	KS_ERR_ASM_ARM64_MISSINGFEATURE = 513
+	KS_ERR_ASM_ARM64_MNEMONICFAIL = 514
+end

data/lib/keystone_engine/arm_const.rb

@@ -0,0 +1,6 @@
+
+module KeystoneEngine
+	KS_ERR_ASM_ARM_INVALIDOPERAND = 512
+	KS_ERR_ASM_ARM_MISSINGFEATURE = 513
+	KS_ERR_ASM_ARM_MNEMONICFAIL = 514
+end

data/lib/keystone_engine/hexagon_const.rb

@@ -0,0 +1,6 @@
+
+module KeystoneEngine
+	KS_ERR_ASM_HEXAGON_INVALIDOPERAND = 512
+	KS_ERR_ASM_HEXAGON_MISSINGFEATURE = 513
+	KS_ERR_ASM_HEXAGON_MNEMONICFAIL = 514
+end

data/lib/keystone_engine/keystone_const.rb

@@ -0,0 +1,92 @@
+
+module KeystoneEngine
+	KS_API_MAJOR = 0
+	KS_API_MINOR = 9
+	KS_VERSION_MAJOR = 0
+	KS_VERSION_MINOR = 9
+	KS_VERSION_EXTRA = 1
+	KS_ARCH_ARM = 1
+	KS_ARCH_ARM64 = 2
+	KS_ARCH_MIPS = 3
+	KS_ARCH_X86 = 4
+	KS_ARCH_PPC = 5
+	KS_ARCH_SPARC = 6
+	KS_ARCH_SYSTEMZ = 7
+	KS_ARCH_HEXAGON = 8
+	KS_ARCH_MAX = 9
+	KS_MODE_LITTLE_ENDIAN = 0
+	KS_MODE_BIG_ENDIAN = 1073741824
+	KS_MODE_ARM = 1
+	KS_MODE_THUMB = 16
+	KS_MODE_V8 = 64
+	KS_MODE_MICRO = 16
+	KS_MODE_MIPS3 = 32
+	KS_MODE_MIPS32R6 = 64
+	KS_MODE_MIPS32 = 4
+	KS_MODE_MIPS64 = 8
+	KS_MODE_16 = 2
+	KS_MODE_32 = 4
+	KS_MODE_64 = 8
+	KS_MODE_PPC32 = 4
+	KS_MODE_PPC64 = 8
+	KS_MODE_QPX = 16
+	KS_MODE_SPARC32 = 4
+	KS_MODE_SPARC64 = 8
+	KS_MODE_V9 = 16
+	KS_ERR_ASM = 128
+	KS_ERR_ASM_ARCH = 512
+	KS_ERR_OK = 0
+	KS_ERR_NOMEM = 1
+	KS_ERR_ARCH = 2
+	KS_ERR_HANDLE = 3
+	KS_ERR_MODE = 4
+	KS_ERR_VERSION = 5
+	KS_ERR_OPT_INVALID = 6
+	KS_ERR_ASM_EXPR_TOKEN = 128
+	KS_ERR_ASM_DIRECTIVE_VALUE_RANGE = 129
+	KS_ERR_ASM_DIRECTIVE_ID = 130
+	KS_ERR_ASM_DIRECTIVE_TOKEN = 131
+	KS_ERR_ASM_DIRECTIVE_STR = 132
+	KS_ERR_ASM_DIRECTIVE_COMMA = 133
+	KS_ERR_ASM_DIRECTIVE_RELOC_NAME = 134
+	KS_ERR_ASM_DIRECTIVE_RELOC_TOKEN = 135
+	KS_ERR_ASM_DIRECTIVE_FPOINT = 136
+	KS_ERR_ASM_DIRECTIVE_UNKNOWN = 137
+	KS_ERR_ASM_DIRECTIVE_EQU = 138
+	KS_ERR_ASM_DIRECTIVE_INVALID = 139
+	KS_ERR_ASM_VARIANT_INVALID = 140
+	KS_ERR_ASM_EXPR_BRACKET = 141
+	KS_ERR_ASM_SYMBOL_MODIFIER = 142
+	KS_ERR_ASM_SYMBOL_REDEFINED = 143
+	KS_ERR_ASM_SYMBOL_MISSING = 144
+	KS_ERR_ASM_RPAREN = 145
+	KS_ERR_ASM_STAT_TOKEN = 146
+	KS_ERR_ASM_UNSUPPORTED = 147
+	KS_ERR_ASM_MACRO_TOKEN = 148
+	KS_ERR_ASM_MACRO_PAREN = 149
+	KS_ERR_ASM_MACRO_EQU = 150
+	KS_ERR_ASM_MACRO_ARGS = 151
+	KS_ERR_ASM_MACRO_LEVELS_EXCEED = 152
+	KS_ERR_ASM_MACRO_STR = 153
+	KS_ERR_ASM_MACRO_INVALID = 154
+	KS_ERR_ASM_ESC_BACKSLASH = 155
+	KS_ERR_ASM_ESC_OCTAL = 156
+	KS_ERR_ASM_ESC_SEQUENCE = 157
+	KS_ERR_ASM_ESC_STR = 158
+	KS_ERR_ASM_TOKEN_INVALID = 159
+	KS_ERR_ASM_INSN_UNSUPPORTED = 160
+	KS_ERR_ASM_FIXUP_INVALID = 161
+	KS_ERR_ASM_LABEL_INVALID = 162
+	KS_ERR_ASM_FRAGMENT_INVALID = 163
+	KS_ERR_ASM_INVALIDOPERAND = 512
+	KS_ERR_ASM_MISSINGFEATURE = 513
+	KS_ERR_ASM_MNEMONICFAIL = 514
+	KS_OPT_SYNTAX = 1
+	KS_OPT_SYM_RESOLVER = 2
+	KS_OPT_SYNTAX_INTEL = 1
+	KS_OPT_SYNTAX_ATT = 2
+	KS_OPT_SYNTAX_NASM = 4
+	KS_OPT_SYNTAX_MASM = 8
+	KS_OPT_SYNTAX_GAS = 16
+	KS_OPT_SYNTAX_RADIX16 = 32
+end

data/lib/keystone_engine/mips_const.rb

@@ -0,0 +1,6 @@
+
+module KeystoneEngine
+	KS_ERR_ASM_MIPS_INVALIDOPERAND = 512
+	KS_ERR_ASM_MIPS_MISSINGFEATURE = 513
+	KS_ERR_ASM_MIPS_MNEMONICFAIL = 514
+end

data/lib/keystone_engine/ppc_const.rb

@@ -0,0 +1,6 @@
+
+module KeystoneEngine
+	KS_ERR_ASM_PPC_INVALIDOPERAND = 512
+	KS_ERR_ASM_PPC_MISSINGFEATURE = 513
+	KS_ERR_ASM_PPC_MNEMONICFAIL = 514
+end

data/lib/keystone_engine/sparc_const.rb

@@ -0,0 +1,6 @@
+
+module KeystoneEngine
+	KS_ERR_ASM_SPARC_INVALIDOPERAND = 512
+	KS_ERR_ASM_SPARC_MISSINGFEATURE = 513
+	KS_ERR_ASM_SPARC_MNEMONICFAIL = 514
+end

data/lib/keystone_engine/systemz_const.rb

@@ -0,0 +1,6 @@
+
+module KeystoneEngine
+	KS_ERR_ASM_SYSTEMZ_INVALIDOPERAND = 512
+	KS_ERR_ASM_SYSTEMZ_MISSINGFEATURE = 513
+	KS_ERR_ASM_SYSTEMZ_MNEMONICFAIL = 514
+end

data/lib/keystone_engine/version.rb

@@ -0,0 +1,3 @@
+module KeystoneEngine
+  VERSION = "0.9.0"
+end

data/lib/keystone_engine/x86_const.rb

@@ -0,0 +1,6 @@
+
+module KeystoneEngine
+	KS_ERR_ASM_X86_INVALIDOPERAND = 512
+	KS_ERR_ASM_X86_MISSINGFEATURE = 513
+	KS_ERR_ASM_X86_MNEMONICFAIL = 514
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: keystone-engine
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- Sascha Schirra
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-10-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+description: Ruby binding for Keystone <Keystone-engine.org>
+email:
+- sashs@scoding.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/keystone_engine.rb
+- lib/keystone_engine/arm64_const.rb
+- lib/keystone_engine/arm_const.rb
+- lib/keystone_engine/hexagon_const.rb
+- lib/keystone_engine/keystone_const.rb
+- lib/keystone_engine/mips_const.rb
+- lib/keystone_engine/ppc_const.rb
+- lib/keystone_engine/sparc_const.rb
+- lib/keystone_engine/systemz_const.rb
+- lib/keystone_engine/version.rb
+- lib/keystone_engine/x86_const.rb
+homepage: https://keystone-engine.org
+licenses:
+- GPL-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: Ruby binding for Keystone
+test_files: []