module MachO

The primary namespace for ruby-macho.

Constants

VERSION: release version

Public Class Methods

codesign!(filename) click to toggle source

Signs the dylib using an ad-hoc identity. Necessary after making any changes to a dylib, since otherwise changing a signed file invalidates its signature. @param filename [String] the file being opened @return [void] @raise [ModificationError] if the operation fails

# File lib/macho.rb, line 51
def self.codesign!(filename)
  raise ArgumentError, "codesign binary is not available on Linux" if RUBY_PLATFORM !~ /darwin/
  raise ArgumentError, "#{filename}: no such file" unless File.file?(filename)

  _, _, status = Open3.capture3("codesign", "--sign", "-", "--force",
                                "--preserve-metadata=entitlements,requirements,flags,runtime",
                                filename)

  raise CodeSigningError, "#{filename}: signing failed!" unless status.success?
end

open(filename) click to toggle source

Opens the given filename as a MachOFile or FatFile, depending on its magic. @param filename [String] the file being opened @return [MachOFile] if the file is a Mach-O @return [FatFile] if the file is a Fat file @raise [ArgumentError] if the given file does not exist @raise [TruncatedFileError] if the file is too small to have a valid header @raise [MagicError] if the file’s magic is not valid Mach-O magic

# File lib/macho.rb, line 28
def self.open(filename)
  raise ArgumentError, "#{filename}: no such file" unless File.file?(filename)
  raise TruncatedFileError unless File.stat(filename).size >= 4

  magic = File.open(filename, "rb") { |f| f.read(4) }.unpack1("N")

  if Utils.fat_magic?(magic)
    file = FatFile.new(filename)
  elsif Utils.magic?(magic)
    file = MachOFile.new(filename)
  else
    raise MagicError, magic
  end

  file
end