ronin-support 0.5.1 → 1.0.0.beta1

data/lib/ronin/support/binary/ctypes/arch/mips/little_endian.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# ronin-support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/support/binary/ctypes/little_endian'
+
+module Ronin
+  module Support
+    module Binary
+      module CTypes
+        module Arch
+          module MIPS
+            module LittleEndian
+              include CTypes::LittleEndian
+
+              # The size of a pointer in bytes on MIPS (little-endian).
+              ADDRESS_SIZE = 4
+
+              # The `long` type.
+              LONG = CTypes::LittleEndian::INT32
+
+              # The `unsigned long` type.
+              ULONG = CTypes::LittleEndian::UINT32
+
+              # The "machine word" type.
+              MACHINE_WORD = CTypes::LittleEndian::UINT32
+
+              # The `void *` type.
+              POINTER = MACHINE_WORD
+
+              # The MIPS (little-endian) types.
+              TYPES = CTypes::LittleEndian::TYPES.merge(
+                long:  self::LONG,
+                ulong: self::ULONG,
+
+                machine_word: self::MACHINE_WORD,
+                pointer:      self::POINTER
+              )
+
+              #
+              # Fetches the type from {TYPES}.
+              #
+              # @param [Symbol] name
+              #   The type name to lookup.
+              #
+              # @return [Type]
+              #   The type object from {TYPES}.
+              #
+              # @raise [ArgumentError]
+              #   The type name was unknown.
+              #
+              def self.[](name)
+                TYPES.fetch(name) do
+                  raise(ArgumentError,"unknown MIPS (little-endian) type: #{name.inspect}")
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/support/binary/ctypes/arch/mips.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# ronin-support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/support/binary/ctypes/big_endian'
+
+module Ronin
+  module Support
+    module Binary
+      module CTypes
+        module Arch
+          module MIPS
+            include BigEndian
+
+            # The size of a pointer in bytes on MIPS.
+            ADDRESS_SIZE = 4
+
+            # The `long` type.
+            LONG = BigEndian::INT32
+
+            # The `unsigned long` type.
+            ULONG = BigEndian::UINT32
+
+            # The "machine word" type.
+            MACHINE_WORD = BigEndian::UINT32
+
+            # The `void *` type.
+            POINTER = MACHINE_WORD
+
+            # The MIPS types.
+            TYPES = BigEndian::TYPES.merge(
+              long:  self::LONG,
+              ulong: self::ULONG,
+
+              machine_word: self::MACHINE_WORD,
+              pointer:      self::POINTER
+            )
+
+            #
+            # Fetches the type from {TYPES}.
+            #
+            # @param [Symbol] name
+            #   The type name to lookup.
+            #
+            # @return [Type]
+            #   The type object from {TYPES}.
+            #
+            # @raise [ArgumentError]
+            #   The type name was unknown.
+            #
+            def self.[](name)
+              TYPES.fetch(name) do
+                raise(ArgumentError,"unknown MIPS type: #{name.inspect}")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/support/binary/ctypes/arch/mips64/little_endian.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# ronin-support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/support/binary/ctypes/little_endian'
+
+module Ronin
+  module Support
+    module Binary
+      module CTypes
+        module Arch
+          module MIPS64
+            module LittleEndian
+              include CTypes::LittleEndian
+
+              # The size of a pointer in bytes on MIPS64 (little-endian).
+              ADDRESS_SIZE = 8
+
+              # The `long` type.
+              LONG = CTypes::LittleEndian::INT64
+
+              # The `unsigned long` type.
+              ULONG = CTypes::LittleEndian::UINT64
+
+              # The "machine word" type.
+              MACHINE_WORD = CTypes::LittleEndian::UINT64
+
+              # The `void *` type.
+              POINTER = MACHINE_WORD
+
+              # The MIPS64 types.
+              TYPES = CTypes::LittleEndian::TYPES.merge(
+                long:  self::LONG,
+                ulong: self::ULONG,
+
+                machine_word: self::MACHINE_WORD,
+                pointer:      self::POINTER
+              )
+
+              #
+              # Fetches the type from {TYPES}.
+              #
+              # @param [Symbol] name
+              #   The type name to lookup.
+              #
+              # @return [Type]
+              #   The type object from {TYPES}.
+              #
+              # @raise [ArgumentError]
+              #   The type name was unknown.
+              #
+              def self.[](name)
+                self::TYPES.fetch(name) do
+                  raise(ArgumentError,"unknown MIPS64 (little-endian) type: #{name.inspect}")
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/support/binary/ctypes/arch/mips64.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# ronin-support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/support/binary/ctypes/big_endian'
+
+module Ronin
+  module Support
+    module Binary
+      module CTypes
+        module Arch
+          module MIPS64
+            include BigEndian
+
+            # The size of a pointer in bytes on MIPS64.
+            ADDRESS_SIZE = 8
+
+            # The `long` type.
+            LONG = BigEndian::INT64
+
+            # The `unsigned long` type.
+            ULONG = BigEndian::UINT64
+
+            # The "machine word" type.
+            MACHINE_WORD = BigEndian::UINT64
+
+            # The `void *` type.
+            POINTER = MACHINE_WORD
+
+            # The MIPS64 types.
+            TYPES = BigEndian::TYPES.merge(
+              long:  self::LONG,
+              ulong: self::ULONG,
+
+              machine_word: self::MACHINE_WORD,
+              pointer:      self::POINTER
+            )
+
+            #
+            # Fetches the type from {TYPES}.
+            #
+            # @param [Symbol] name
+            #   The type name to lookup.
+            #
+            # @return [Type]
+            #   The type object from {TYPES}.
+            #
+            # @raise [ArgumentError]
+            #   The type name was unknown.
+            #
+            def self.[](name)
+              self::TYPES.fetch(name) do
+                raise(ArgumentError,"unknown MIPS64 type: #{name.inspect}")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/support/binary/ctypes/arch/ppc.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# ronin-support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/support/binary/ctypes/big_endian'
+
+module Ronin
+  module Support
+    module Binary
+      module CTypes
+        module Arch
+          module PPC
+            include BigEndian
+
+            # The size of a pointer in bytes on PPC.
+            ADDRESS_SIZE = 4
+
+            # The `long` type.
+            LONG = BigEndian::INT32
+
+            # The `unsigned long` type.
+            ULONG = BigEndian::UINT32
+
+            # The "machine word" type.
+            MACHINE_WORD = BigEndian::UINT32
+
+            # The `void *` type.
+            POINTER = MACHINE_WORD
+
+            # The PPC types.
+            TYPES = BigEndian::TYPES.merge(
+              long:  self::LONG,
+              ulong: self::ULONG,
+
+              machine_word: self::MACHINE_WORD,
+              pointer:      self::POINTER
+            )
+
+            #
+            # Fetches the type from {TYPES}.
+            #
+            # @param [Symbol] name
+            #   The type name to lookup.
+            #
+            # @return [Type]
+            #   The type object from {TYPES}.
+            #
+            # @raise [ArgumentError]
+            #   The type name was unknown.
+            #
+            def self.[](name)
+              TYPES.fetch(name) do
+                raise(ArgumentError,"unknown PPC type: #{name.inspect}")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/support/binary/ctypes/arch/ppc64.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# ronin-support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/support/binary/ctypes/big_endian'
+
+module Ronin
+  module Support
+    module Binary
+      module CTypes
+        module Arch
+          module PPC64
+            include BigEndian
+
+            # The size of a pointer in bytes on PPC64.
+            ADDRESS_SIZE = 8
+
+            # The `long` type.
+            LONG = BigEndian::INT64
+
+            # The `unsigned long` type.
+            ULONG = BigEndian::UINT64
+
+            # The "machine word" type.
+            MACHINE_WORD = BigEndian::UINT64
+
+            # The `void *` type.
+            POINTER = MACHINE_WORD
+
+            # The PPC64 types.
+            TYPES = BigEndian::TYPES.merge(
+              long:  self::LONG,
+              ulong: self::ULONG,
+
+              machine_word: self::MACHINE_WORD,
+              pointer:      self::POINTER
+            )
+
+            #
+            # Fetches the type from {TYPES}.
+            #
+            # @param [Symbol] name
+            #   The type name to lookup.
+            #
+            # @return [Type]
+            #   The type object from {TYPES}.
+            #
+            # @raise [ArgumentError]
+            #   The type name was unknown.
+            #
+            def self.[](name)
+              self::TYPES.fetch(name) do
+                raise(ArgumentError,"unknown PPC64 type: #{name.inspect}")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/support/binary/ctypes/arch/x86.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# ronin-support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/support/binary/ctypes/little_endian'
+
+module Ronin
+  module Support
+    module Binary
+      module CTypes
+        module Arch
+          module X86
+            include LittleEndian
+
+            # The size of a pointer in bytes on x86.
+            ADDRESS_SIZE = 4
+
+            # The `long` type.
+            LONG = LittleEndian::INT32
+
+            # The `unsigned long` type.
+            ULONG = LittleEndian::UINT32
+
+            # The "machine word" type.
+            MACHINE_WORD = LittleEndian::UINT32
+
+            # The `void *` type.
+            POINTER = MACHINE_WORD
+
+            # The x86 types.
+            TYPES = LittleEndian::TYPES.merge(
+              long:  self::LONG,
+              ulong: self::ULONG,
+
+              machine_word: self::MACHINE_WORD,
+              pointer:      self::POINTER
+            )
+
+            #
+            # Fetches the type from {TYPES}.
+            #
+            # @param [Symbol] name
+            #   The type name to lookup.
+            #
+            # @return [Type]
+            #   The type object from {TYPES}.
+            #
+            # @raise [ArgumentError]
+            #   The type name was unknown.
+            #
+            def self.[](name)
+              TYPES.fetch(name) do
+                raise(ArgumentError,"unknown x86 type: #{name.inspect}")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/support/binary/ctypes/arch/x86_64.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# ronin-support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/support/binary/ctypes/little_endian'
+
+module Ronin
+  module Support
+    module Binary
+      module CTypes
+        module Arch
+          module X86_64
+            include LittleEndian
+
+            # The size of a pointer in bytes on x86-64.
+            ADDRESS_SIZE = 8
+
+            # The `long` type.
+            LONG = LittleEndian::INT64
+
+            # The `unsigned long` type.
+            ULONG = LittleEndian::UINT64
+
+            # The "machine word" type.
+            MACHINE_WORD = LittleEndian::UINT64
+
+            # The `void *` type.
+            POINTER = MACHINE_WORD
+
+            # The x86-64 types.
+            TYPES = LittleEndian::TYPES.merge(
+              long:  self::LONG,
+              ulong: self::ULONG,
+
+              machine_word: self::MACHINE_WORD,
+              pointer:      self::POINTER
+            )
+
+            #
+            # Fetches the type from {TYPES}.
+            #
+            # @param [Symbol] name
+            #   The type name to lookup.
+            #
+            # @return [Type]
+            #   The type object from {TYPES}.
+            #
+            # @raise [ArgumentError]
+            #   The type name was unknown.
+            #
+            def self.[](name)
+              self::TYPES.fetch(name) do
+                raise(ArgumentError,"unknown x86-64 type: #{name.inspect}")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/support/binary/ctypes/arch.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# ronin-support 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/support/binary/ctypes/arch/x86'
+require 'ronin/support/binary/ctypes/arch/x86_64'
+require 'ronin/support/binary/ctypes/arch/ppc'
+require 'ronin/support/binary/ctypes/arch/ppc64'
+require 'ronin/support/binary/ctypes/arch/mips'
+require 'ronin/support/binary/ctypes/arch/mips/little_endian'
+require 'ronin/support/binary/ctypes/arch/mips64'
+require 'ronin/support/binary/ctypes/arch/mips64/little_endian'
+require 'ronin/support/binary/ctypes/arch/arm'
+require 'ronin/support/binary/ctypes/arch/arm/big_endian'
+require 'ronin/support/binary/ctypes/arch/arm64'
+require 'ronin/support/binary/ctypes/arch/arm64/big_endian'