ruby-macho 4.1.0 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf1e87b27661d19099f8a7160c774dab716e37be7dec050f84c701e9fc6c1ea6
-  data.tar.gz: 18d7705d4204bd10bd593b7ab8759058d2cea94eadeed9d7edce06b96d303a9b
+  metadata.gz: 848be7615c0a26614ffc950ffd7a70b3efe594a4c2608aeb776d2f7a0fca472d
+  data.tar.gz: e8e084691a090ddd084196567ee80848b2cb546f9bff70ec9d43b8a8a45b0cef
 SHA512:
-  metadata.gz: 0c6007d3ef6a175bf58c6b900a42aacdfd557d1f283f3e144828c25a3207f4791ef031c3313ace7a4f807b62ecf05ffb7944ca39d746d6446d23d20c0c4a6166
-  data.tar.gz: d7345efc2941999717f803ae9740067ee4a53cec738fd44c0ea5cee610f1b7d28bac8bf572f5558ff02f63a590ce323f024b9e2fd6e55977fc521dcb39ca2c03
+  metadata.gz: 2117ef6313e528a636b43b5c45c17729627cfae074957c6bfc7486040daf4c10b3f6ce74dc48a72a8375821f77de34d723c6c586eda27a5d0cc71d47a33cc42b
+  data.tar.gz: cc3a7f948e6d9f6ae71b7f0f96eef0945d5269c8e59ab09239a61ce8f8564c9faa8b4484940907dc6bb299435f54d9a1c5b89714c692b15a048b0c0c49f6f955

data/README.md

@@ -3,7 +3,7 @@ ruby-macho
 
 [![Gem Version](https://badge.fury.io/rb/ruby-macho.svg)](http://badge.fury.io/rb/ruby-macho)
 [![CI](https://github.com/Homebrew/ruby-macho/actions/workflows/tests.yml/badge.svg)](https://github.com/Homebrew/ruby-macho/actions/workflows/tests.yml)
-[![Coverage Status](https://codecov.io/gh/Homebrew/ruby-macho/branch/master/graph/badge.svg)](https://codecov.io/gh/Homebrew/ruby-macho)
+[![Coverage Status](https://codecov.io/gh/Homebrew/ruby-macho/branch/main/graph/badge.svg)](https://codecov.io/gh/Homebrew/ruby-macho)
 
 A Ruby library for examining and modifying Mach-O files.
 

data/lib/macho/exceptions.rb

@@ -37,7 +37,7 @@ module MachO
   # Raised when a file is too short to be a valid Mach-O file.
   class TruncatedFileError < NotAMachOError
     def initialize
-      super "File is too short to be a valid Mach-O"
+      super("File is too short to be a valid Mach-O")
     end
   end
 
@@ -45,21 +45,21 @@ module MachO
   class MagicError < NotAMachOError
     # @param num [Integer] the unknown number
     def initialize(magic)
-      super "Unrecognized Mach-O magic: 0x%02<magic>x" % { :magic => magic }
+      super("Unrecognized Mach-O magic: 0x%02<magic>x" % { :magic => magic })
     end
   end
 
   # Raised when a file is a Java classfile instead of a fat Mach-O.
   class JavaClassFileError < NotAMachOError
     def initialize
-      super "File is a Java class file"
+      super("File is a Java class file")
     end
   end
 
   # Raised when a a fat Mach-O file has zero architectures
   class ZeroArchitectureError < NotAMachOError
     def initialize
-      super "Fat file has zero internal architectures"
+      super("Fat file has zero internal architectures")
     end
   end
 
@@ -71,24 +71,24 @@ module MachO
       # @param cpusubtype_fat [Integer] the CPU subtype in the fat header
       # @param cputype_macho [Integer] the CPU type in the macho header
       # @param cpusubtype_macho [Integer] the CPU subtype in the macho header
-      super ("Mismatch between cputypes >> 0x%08<fat_cputype>x and 0x%08<macho_cputype>x\n" \
-             "and/or cpusubtypes >> 0x%08<fat_cpusubtype>x and 0x%08<macho_cpusubtype>x" %
-            { :fat_cputype => fat_cputype, :macho_cputype => macho_cputype,
-              :fat_cpusubtype => fat_cpusubtype, :macho_cpusubtype => macho_cpusubtype })
+      super("Mismatch between cputypes >> 0x%08<fat_cputype>x and 0x%08<macho_cputype>x\n" \
+            "and/or cpusubtypes >> 0x%08<fat_cpusubtype>x and 0x%08<macho_cpusubtype>x" %
+        { :fat_cputype => fat_cputype, :macho_cputype => macho_cputype,
+          :fat_cpusubtype => fat_cpusubtype, :macho_cpusubtype => macho_cpusubtype })
     end
   end
 
   # Raised when a fat binary is loaded with MachOFile.
   class FatBinaryError < MachOError
     def initialize
-      super "Fat binaries must be loaded with MachO::FatFile"
+      super("Fat binaries must be loaded with MachO::FatFile")
     end
   end
 
   # Raised when a Mach-O is loaded with FatFile.
   class MachOBinaryError < MachOError
     def initialize
-      super "Normal binaries must be loaded with MachO::MachOFile"
+      super("Normal binaries must be loaded with MachO::MachOFile")
     end
   end
 
@@ -96,7 +96,7 @@ module MachO
   class CPUTypeError < MachOError
     # @param cputype [Integer] the unknown CPU type
     def initialize(cputype)
-      super "Unrecognized CPU type: 0x%08<cputype>x" % { :cputype => cputype }
+      super("Unrecognized CPU type: 0x%08<cputype>x" % { :cputype => cputype })
     end
   end
 
@@ -105,8 +105,8 @@ module MachO
     # @param cputype [Integer] the CPU type of the unknown pair
     # @param cpusubtype [Integer] the CPU sub-type of the unknown pair
     def initialize(cputype, cpusubtype)
-      super "Unrecognized CPU sub-type: 0x%08<cpusubtype>x " \
-            "(for CPU type: 0x%08<cputype>x" % { :cputype => cputype, :cpusubtype => cpusubtype }
+      super("Unrecognized CPU sub-type: 0x%08<cpusubtype>x " \
+            "(for CPU type: 0x%08<cputype>x" % { :cputype => cputype, :cpusubtype => cpusubtype })
     end
   end
 
@@ -114,7 +114,7 @@ module MachO
   class FiletypeError < MachOError
     # @param num [Integer] the unknown number
     def initialize(num)
-      super "Unrecognized Mach-O filetype code: 0x%02<num>x" % { :num => num }
+      super("Unrecognized Mach-O filetype code: 0x%02<num>x" % { :num => num })
     end
   end
 
@@ -122,7 +122,7 @@ module MachO
   class LoadCommandError < MachOError
     # @param num [Integer] the unknown number
     def initialize(num)
-      super "Unrecognized Mach-O load command: 0x%02<num>x" % { :num => num }
+      super("Unrecognized Mach-O load command: 0x%02<num>x" % { :num => num })
     end
   end
 
@@ -130,7 +130,7 @@ module MachO
   class LoadCommandNotCreatableError < MachOError
     # @param cmd_sym [Symbol] the uncreatable load command's symbol
     def initialize(cmd_sym)
-      super "Load commands of type #{cmd_sym} cannot be created manually"
+      super("Load commands of type #{cmd_sym} cannot be created manually")
     end
   end
 
@@ -141,8 +141,8 @@ module MachO
     # @param expected_arity [Integer] the number of arguments expected
     # @param actual_arity [Integer] the number of arguments received
     def initialize(cmd_sym, expected_arity, actual_arity)
-      super "Expected #{expected_arity} arguments for #{cmd_sym} creation, " \
-            "got #{actual_arity}"
+      super("Expected #{expected_arity} arguments for #{cmd_sym} creation, " \
+            "got #{actual_arity}")
     end
   end
 
@@ -150,7 +150,7 @@ module MachO
   class LoadCommandNotSerializableError < MachOError
     # @param cmd_sym [Symbol] the load command's symbol
     def initialize(cmd_sym)
-      super "Load commands of type #{cmd_sym} cannot be serialized"
+      super("Load commands of type #{cmd_sym} cannot be serialized")
     end
   end
 
@@ -158,8 +158,8 @@ module MachO
   class LCStrMalformedError < MachOError
     # @param lc [MachO::LoadCommand] the load command containing the string
     def initialize(lc)
-      super "Load command #{lc.type} at offset #{lc.view.offset} contains a " \
-            "malformed string"
+      super("Load command #{lc.type} at offset #{lc.view.offset} contains a " \
+            "malformed string")
     end
   end
 
@@ -167,7 +167,7 @@ module MachO
   class OffsetInsertionError < ModificationError
     # @param offset [Integer] the invalid offset
     def initialize(offset)
-      super "Insertion at offset #{offset} is not valid"
+      super("Insertion at offset #{offset} is not valid")
     end
   end
 
@@ -175,9 +175,9 @@ module MachO
   class HeaderPadError < ModificationError
     # @param filename [String] the filename
     def initialize(filename)
-      super "Updated load commands do not fit in the header of " \
+      super("Updated load commands do not fit in the header of " \
             "#{filename}. #{filename} needs to be relinked, possibly with " \
-            "-headerpad or -headerpad_max_install_names"
+            "-headerpad or -headerpad_max_install_names")
     end
   end
 
@@ -185,14 +185,14 @@ module MachO
   class DylibUnknownError < RecoverableModificationError
     # @param dylib [String] the unknown shared library name
     def initialize(dylib)
-      super "No such dylib name: #{dylib}"
+      super("No such dylib name: #{dylib}")
     end
   end
 
   # Raised when a dylib is missing an ID
   class DylibIdMissingError < RecoverableModificationError
     def initialize
-      super "Dylib is missing a dylib ID"
+      super("Dylib is missing a dylib ID")
     end
   end
 
@@ -200,7 +200,7 @@ module MachO
   class RpathUnknownError < RecoverableModificationError
     # @param path [String] the unknown runtime path
     def initialize(path)
-      super "No such runtime path: #{path}"
+      super("No such runtime path: #{path}")
     end
   end
 
@@ -208,7 +208,7 @@ module MachO
   class RpathExistsError < RecoverableModificationError
     # @param path [String] the extant path
     def initialize(path)
-      super "#{path} already exists"
+      super("#{path} already exists")
     end
   end
 
@@ -216,7 +216,7 @@ module MachO
   class UnimplementedError < MachOError
     # @param thing [String] the thing that is unimplemented
     def initialize(thing)
-      super "Unimplemented: #{thing}"
+      super("Unimplemented: #{thing}")
     end
   end
 
@@ -225,8 +225,8 @@ module MachO
   class FatArchOffsetOverflowError < MachOError
     # @param offset [Integer] the offending offset
     def initialize(offset)
-      super "Offset #{offset} exceeds the 32-bit width of a fat_arch offset. " \
-            "Consider merging with `fat64: true`"
+      super("Offset #{offset} exceeds the 32-bit width of a fat_arch offset. " \
+            "Consider merging with `fat64: true`")
     end
   end
 

data/lib/macho/headers.rb

@@ -60,14 +60,14 @@ module MachO
       MH_CIGAM_64 => "MH_CIGAM_64",
     }.freeze
 
-    # mask for CPUs with 64-bit architectures (when running a 64-bit ABI?)
+    # mask for 64-bit CPU architectures with 64-bit types
     # @api private
     CPU_ARCH_ABI64 = 0x01000000
 
-    # mask for CPUs with 64-bit architectures (when running a 32-bit ABI?)
+    # mask for 64-bit CPU architectures with 32-bit types (ILP32)
     # @see https://github.com/Homebrew/ruby-macho/issues/113
     # @api private
-    CPU_ARCH_ABI32 = 0x02000000
+    CPU_ARCH_ABI64_32 = 0x02000000
 
     # any CPU (unused?)
     # @api private
@@ -97,9 +97,10 @@ module MachO
     # @api private
     CPU_TYPE_ARM64 = (CPU_TYPE_ARM | CPU_ARCH_ABI64)
 
-    # 64-bit ARM compatible CPUs (running in 32-bit mode?)
+    # 64-bit ARM compatible CPUs (with 32-bit types)
     # @see https://github.com/Homebrew/ruby-macho/issues/113
-    CPU_TYPE_ARM64_32 = (CPU_TYPE_ARM | CPU_ARCH_ABI32)
+    # @api private
+    CPU_TYPE_ARM64_32 = (CPU_TYPE_ARM | CPU_ARCH_ABI64_32)
 
     # PowerPC compatible CPUs
     # @api private
@@ -450,6 +451,14 @@ module MachO
     # @api private
     MH_FILESET = 0xc
 
+    # gpu program
+    # @api private
+    MH_GPU_EXECUTE = 0xd
+
+    # gpu support functions
+    # @api private
+    MH_GPU_DYLIB = 0xe
+
     # association of filetypes to Symbol representations
     # @api private
     MH_FILETYPES = {
@@ -465,6 +474,8 @@ module MachO
       MH_DSYM => :dsym,
       MH_KEXT_BUNDLE => :kext_bundle,
       MH_FILESET => :fileset,
+      MH_GPU_EXECUTE => :gpu_execute,
+      MH_GPU_DYLIB => :gpu_dylib,
     }.freeze
 
     # association of mach header flag symbols to values
@@ -480,7 +491,7 @@ module MachO
       :MH_TWOLEVEL => 0x80,
       :MH_FORCE_FLAT => 0x100,
       :MH_NOMULTIDEFS => 0x200,
-      :MH_NOPREFIXBINDING => 0x400,
+      :MH_NOFIXPREBINDING => 0x400,
       :MH_PREBINDABLE => 0x800,
       :MH_ALLMODSBOUND => 0x1000,
       :MH_SUBSECTIONS_VIA_SYMBOLS => 0x2000,
@@ -495,9 +506,10 @@ module MachO
       :MH_DEAD_STRIPPABLE_DYLIB => 0x400000,
       :MH_HAS_TLV_DESCRIPTORS => 0x800000,
       :MH_NO_HEAP_EXECUTION => 0x1000000,
-      :MH_APP_EXTENSION_SAFE => 0x02000000,
-      :MH_NLIST_OUTOFSYNC_WITH_DYLDINFO => 0x04000000,
-      :MH_SIM_SUPPORT => 0x08000000,
+      :MH_APP_EXTENSION_SAFE => 0x2000000,
+      :MH_NLIST_OUTOFSYNC_WITH_DYLDINFO => 0x4000000,
+      :MH_SIM_SUPPORT => 0x8000000,
+      :MH_IMPLICIT_PAGEZERO => 0x10000000,
       :MH_DYLIB_IN_CACHE => 0x80000000,
     }.freeze
 

data/lib/macho/load_commands.rb

@@ -66,6 +66,9 @@ module MachO
       (LC_REQ_DYLD | 0x34) => :LC_DYLD_CHAINED_FIXUPS,
       (LC_REQ_DYLD | 0x35) => :LC_FILESET_ENTRY,
       0x36 => :LC_ATOM_INFO,
+      0x37 => :LC_FUNCTION_VARIANTS,
+      0x38 => :LC_FUNCTION_VARIANT_FIXUPS,
+      0x39 => :LC_TARGET_TRIPLE,
     }.freeze
 
     # association of symbol representations to load command constants
@@ -155,6 +158,9 @@ module MachO
       :LC_DYLD_CHAINED_FIXUPS => "LinkeditDataCommand",
       :LC_FILESET_ENTRY => "FilesetEntryCommand",
       :LC_ATOM_INFO => "LinkeditDataCommand",
+      :LC_FUNCTION_VARIANTS => "LinkeditDataCommand",
+      :LC_FUNCTION_VARIANT_FIXUPS => "LinkeditDataCommand",
+      :LC_TARGET_TRIPLE => "TargetTripleCommand",
     }.freeze
 
     # association of segment name symbols to names
@@ -488,7 +494,7 @@ module MachO
         align = 0
         segalign = 1
 
-        while (segalign & vmaddr).zero?
+        while segalign.nobits?(vmaddr)
           segalign <<= 1
           align += 1
         end
@@ -610,7 +616,7 @@ module MachO
 
         if dylib_command.timestamp == DYLIB_USE_MARKER &&
            dylib_command.name.to_i == DylibUseCommand.bytesize
-          super(view)
+          super
         else
           dylib_command
         end
@@ -1053,11 +1059,26 @@ module MachO
       end
     end
 
+    # A load command containing the target triple used when compiling the binary.
+    # Corresponds to LC_TARGET_TRIPLE.
+    class TargetTripleCommand < LoadCommand
+      # @return [LCStr] the target triple used when compiling the binary
+      field :triple, :lcstr, :to_s => true
+
+      # @return [Hash] a hash representation of this {TargetTripleCommand}
+      def to_h
+        {
+          "triple" => triple.to_h,
+        }.merge super
+      end
+    end
+
     # A load command representing the offsets and sizes of a blob of data in
     # the __LINKEDIT segment. Corresponds to LC_CODE_SIGNATURE,
     # LC_SEGMENT_SPLIT_INFO, LC_FUNCTION_STARTS, LC_DATA_IN_CODE,
     # LC_DYLIB_CODE_SIGN_DRS, LC_LINKER_OPTIMIZATION_HINT, LC_DYLD_EXPORTS_TRIE,
-    # LC_DYLD_CHAINED_FIXUPS, or LC_ATOM_INFO.
+    # LC_DYLD_CHAINED_FIXUPS, LC_ATOM_INFO, LC_FUNCTION_VARIANTS,
+    # or LC_FUNCTION_VARIANT_FIXUPS.
     class LinkeditDataCommand < LoadCommand
       # @return [Integer] offset to the data in the __LINKEDIT segment
       field :dataoff, :uint32

data/lib/macho/structure.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module MachO
-  # A general purpose pseudo-structure. Described in detail in docs/machostructure-dsl.md.
+  # A general purpose pseudo-structure. Described in detail in machostructure-dsl-docs.md.
   # @abstract
   class MachOStructure
     # Constants used for parsing MachOStructure fields

data/lib/macho.rb

@@ -16,7 +16,7 @@ require_relative "macho/tools"
 # The primary namespace for ruby-macho.
 module MachO
   # release version
-  VERSION = "4.1.0"
+  VERSION = "5.0.0"
 
   # Opens the given filename as a MachOFile or FatFile, depending on its magic.
   # @param filename [String] the file being opened

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ruby-macho
 version: !ruby/object:Gem::Version
-  version: 4.1.0
+  version: 5.0.0
 platform: ruby
 authors:
 - William Woodruff
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-06-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: A library for viewing and manipulating Mach-O files in Ruby.
 email: william@yossarian.net
@@ -35,7 +34,7 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message: 
+  funding_uri: https://github.com/sponsors/Homebrew
 rdoc_options: []
 require_paths:
 - lib
@@ -43,15 +42,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.6'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key: 
+rubygems_version: 4.0.3
 specification_version: 4
 summary: ruby-macho - Mach-O file analyzer.
 test_files: []