ruby-macho 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f149c2c7085b336a2447513e28f10d59afc88062
-  data.tar.gz: 1f938c11b54535cc8b92a625235bff9a34572ceb
+  metadata.gz: 3c89073083ac031f2efa7e6a6f4d8f17185078c7
+  data.tar.gz: b49b996f5340a94e2baf58f10f05d21a251f6950
 SHA512:
-  metadata.gz: 09cd628c568572c632897f1799e784a2668b41ef1c476a84db7c8a438b96832cd54f85050fd4aef593def43b82c90af4cdacdf5a607eb56b4c607390ffdcaddf
-  data.tar.gz: f58bc28a331f6d9ec3d7c98e98d3d1d630788a31ec0fa7d82eef0bc43d254126726f8198581eb11c14f626078c92475fcf6de4742f5170008aa0553db9ffffc6
+  metadata.gz: 76490397fbbd8f1700dd460c973fa6cf4a6e55af84d9fca4dc27dbbb816e980f5641e6c6bb3db1eaa9530fd69f6e951674bbb88a3cbb85b3e386ef34f0f48a9f
+  data.tar.gz: 8beba2a551711b917b6a40744317ace5b8e92891b570f98e63f3948db1836ed689642e4adffe495076a0dcaee18ed539002b39f60011edbd406073a6a6bd4f05

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015 William Woodruff <william @ tuffbizz.com>
+Copyright (c) 2015, 2016 William Woodruff <william @ tuffbizz.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+THE SOFTWARE.

data/README.md

@@ -2,7 +2,7 @@ ruby-macho
 ================
 
 [![Gem Version](https://badge.fury.io/rb/ruby-macho.svg)](http://badge.fury.io/rb/ruby-macho)
-[![Build Status](https://drone.io/github.com/woodruffw/ruby-macho/status.png)](https://drone.io/github.com/woodruffw/ruby-macho/latest)
+[![Build Status](https://travis-ci.org/Homebrew/ruby-macho.svg?branch=master)](https://travis-ci.org/Homebrew/ruby-macho)
 
 A Ruby library for examining and modifying Mach-O files.
 
@@ -21,14 +21,14 @@ A quick example of what ruby-macho can do:
 ```ruby
 require 'macho'
 
-file = MachO::MachOFile.open("/path/to/my/binary")
+file = MachO::MachOFile.new("/path/to/my/binary")
 
 # get the file's type (MH_OBJECT, MH_DYLIB, MH_EXECUTE, etc)
 file.filetype # => "MH_EXECUTE"
 
 # get all load commands in the file and print their offsets:
 file.load_commands.each do |lc|
-	puts "#{lc}: offset #{lc.offset}, size: #{lc.cmdsize}"
+  puts "#{lc}: offset #{lc.offset}, size: #{lc.cmdsize}"
 end
 
 # access a specific load command
@@ -38,17 +38,12 @@ puts lc_vers.version_string # => "10.10.0"
 
 ### What works?
 
-* Reading data from x86/x86_64 Mach-O files
+* Reading data from x86/x86_64/PPC Mach-O files
 * Changing the IDs of Mach-O and Fat dylibs
 * Changing install names in Mach-O and Fat files
 
-### What might work?
-
-* Reading *some* data from PPC Mach-O files.
-
 ### What doesn't work yet?
 
-* Reading data from any other architecure's Mach-O files (probably).
 * Adding, deleting, or modifying rpaths.
 
 ### What needs to be done?

data/lib/macho.rb

@@ -11,6 +11,6 @@ require "#{File.dirname(__FILE__)}/macho/tools"
 
 # The primary namespace for ruby-macho.
 module MachO
-	# release version
-	VERSION = "0.2.2".freeze
+  # release version
+  VERSION = "0.2.3".freeze
 end

data/lib/macho/exceptions.rb

@@ -1,85 +1,116 @@
 module MachO
-	# A generic Mach-O error in execution.
-	class MachOError < RuntimeError
-	end
+  # A generic Mach-O error in execution.
+  class MachOError < RuntimeError
+  end
 
-	# Raised when a file's magic bytes are not valid Mach-O magic.
-	class MagicError < MachOError
-		# @param num [Fixnum] the unknown number
-		def initialize(num)
-			super "Unrecognized Mach-O magic: 0x#{"%02x" % num}"
-		end
-	end
+  # Raised when a file is not a Mach-O.
+  class NotAMachOError < MachOError
+    # @param error [String] the error in question
+    def initialize(error)
+      super error
+    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"
-		end
-	end
+  # 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"
+    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"
-		end
-	end
+  # Raised when a file's magic bytes are not valid Mach-O magic.
+  class MagicError < NotAMachOError
+    # @param num [Fixnum] the unknown number
+    def initialize(num)
+      super "Unrecognized Mach-O magic: 0x#{"%02x" % num}"
+    end
+  end
 
-	# Raised when the CPU type is unknown.
-	class CPUTypeError < MachOError
-		# @param num [Fixnum] the unknown number
-		def initialize(num)
-			super "Unrecognized CPU type: 0x#{"%02x" % num}"
-		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"
+    end
+  end
 
-	# Raised when the CPU subtype is unknown.
-	class CPUSubtypeError < MachOError
-		# @param num [Fixnum] the unknown number
-		def initialize(num)
-			super "Unrecognized CPU sub-type: 0x#{"%02x" % num}"
-		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"
+    end
+  end
 
-	# Raised when a mach-o file's filetype field is unknown.
-	class FiletypeError < MachOError
-		# @param num [Fixnum] the unknown number
-		def initialize(num)
-			super "Unrecognized Mach-O filetype code: 0x#{"%02x" % num}"
-		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"
+    end
+  end
 
-	# Raised when an unknown load command is encountered.
-	class LoadCommandError < MachOError
-		# @param num [Fixnum] the unknown number
-		def initialize(num)
-			super "Unrecognized Mach-O load command: 0x#{"%02x" % num}"
-		end
-	end
+  # Raised when the CPU type is unknown.
+  class CPUTypeError < MachOError
+    # @param cputype [Fixnum] the unknown CPU type
+    def initialize(cputype)
+      super "Unrecognized CPU type: 0x#{"%08x" % cputype}"
+    end
+  end
 
-	# Raised when load commands are too large to fit in the current file.
-	class HeaderPadError < MachOError
-		# @param filename [String] the filename
-		def initialize(filename)
-			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"
-		end
-	end
+  # Raised when the CPU type/sub-type pair is unknown.
+  class CPUSubtypeError < MachOError
+    # @param cputype [Fixnum] the CPU type of the unknown pair
+    # @param cpusubtype [Fixnum] the CPU sub-type of the unknown pair
+    def initialize(cputype, cpusubtype)
+      super "Unrecognized CPU sub-type: 0x#{"%08x" % cpusubtype} (for CPU type: 0x#{"%08x" % cputype})"
+    end
+  end
 
-	# Raised when attempting to change a dylib name that doesn't exist.
-	class DylibUnknownError < MachOError
-		# @param dylib [String] the unknown shared library name
-		def initialize(dylib)
-			super "No such dylib name: #{dylib}"
-		end
-	end
+  # Raised when a mach-o file's filetype field is unknown.
+  class FiletypeError < MachOError
+    # @param num [Fixnum] the unknown number
+    def initialize(num)
+      super "Unrecognized Mach-O filetype code: 0x#{"%02x" % num}"
+    end
+  end
 
-	# Raised when attempting to change an rpath that doesn't exist.
-	class RpathUnknownError < MachOError
-		# @param path [String] the unknown runtime path
-		def initialize(path)
-			super "No such runtime path: #{path}"
-		end
-	end
+  # Raised when an unknown load command is encountered.
+  class LoadCommandError < MachOError
+    # @param num [Fixnum] the unknown number
+    def initialize(num)
+      super "Unrecognized Mach-O load command: 0x#{"%02x" % num}"
+    end
+  end
+
+  # Raised when load commands are too large to fit in the current file.
+  class HeaderPadError < MachOError
+    # @param filename [String] the filename
+    def initialize(filename)
+      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"
+    end
+  end
+
+  # Raised when attempting to change a dylib name that doesn't exist.
+  class DylibUnknownError < MachOError
+    # @param dylib [String] the unknown shared library name
+    def initialize(dylib)
+      super "No such dylib name: #{dylib}"
+    end
+  end
+
+  # Raised when attempting to change an rpath that doesn't exist.
+  class RpathUnknownError < MachOError
+    # @param path [String] the unknown runtime path
+    def initialize(path)
+      super "No such runtime path: #{path}"
+    end
+  end
+
+  # Raised whenever unfinished code is called.
+  class UnimplementedError < MachOError
+    # @param thing [String] the thing that is unimplemented
+    def initialize(thing)
+      super "Unimplemented: #{thing}"
+    end
+  end
 end

data/lib/macho/fat_file.rb

@@ -1,230 +1,275 @@
 module MachO
-	# Represents a "Fat" file, which contains a header, a listing of available
-	# architectures, and one or more Mach-O binaries.
-	# @see https://en.wikipedia.org/wiki/Mach-O#Multi-architecture_binaries
-	# @see MachO::MachOFile
-	class FatFile
-		# @return [MachO::FatHeader] the file's header
-		attr_reader :header
-
-		# @return [Array<MachO::FatArch>] an array of fat architectures
-		attr_reader :fat_archs
-
-		# @return [Array<MachO::MachOFile>] an array of Mach-O binaries
-		attr_reader :machos
-
-		# Creates a new FatFile from the given filename.
-		# @param filename [String] the fat file to load from
-		# @raise [ArgumentError] if the given filename does not exist
-		def initialize(filename)
-			raise ArgumentError.new("#{filetype}: no such file") unless File.exist?(filename)
-
-			@filename = filename
-			@raw_data = open(@filename, "rb") { |f| f.read }
-			@header = get_fat_header
-			@fat_archs = get_fat_archs
-			@machos = get_machos
-		end
-
-		# The file's raw fat data.
-		# @return [String] the raw fat data
-		def serialize
-			@raw_data
-		end
-
-		# @return [Boolean] true if the file is of type `MH_OBJECT`, false otherwise
-		def object?
-			machos.first.object?
-		end
-
-		# @return [Boolean] true if the file is of type `MH_EXECUTE`, false otherwise
-		def executable?
-			machos.first.executable?
-		end
-
-		# @return [Boolean] true if the file is of type `MH_FVMLIB`, false otherwise
-		def fvmlib?
-			machos.first.fvmlib?
-		end
-
-		# @return [Boolean] true if the file is of type `MH_CORE`, false otherwise
-		def core?
-			machos.first.core?
-		end
-
-		# @return [Boolean] true if the file is of type `MH_PRELOAD`, false otherwise
-		def preload?
-			machos.first.preload?
-		end
-
-		# @return [Boolean] true if the file is of type `MH_DYLIB`, false otherwise
-		def dylib?
-			machos.first.dylib?
-		end
-
-		# @return [Boolean] true if the file is of type `MH_DYLINKER`, false otherwise
-		def dylinker?
-			machos.first.dylinker?
-		end
-
-		# @return [Boolean] true if the file is of type `MH_BUNDLE`, false otherwise
-		def bundle?
-			machos.first.bundle?
-		end
-
-		# @return [Boolean] true if the file is of type `MH_DSYM`, false otherwise
-		def dsym?
-			machos.first.dsym?
-		end
-
-		# @return [Boolean] true if the file is of type `MH_KEXT_BUNDLE`, false otherwise
-		def kext?
-			machos.first.kext?
-		end
-
-		# @return [Fixnum] the file's magic number
-		def magic
-			header.magic
-		end
-
-		# @return [String] a string representation of the file's magic number
-		def magic_string
-			MH_MAGICS[magic]
-		end
-
-		# The file's type. Assumed to be the same for every Mach-O within.
-		# @return [String] the filetype
-		def filetype
-			machos.first.filetype
-		end
-
-		# The file's dylib ID. If the file is not a dylib, returns `nil`.
-		# @example
-		#  file.dylib_id # => 'libBar.dylib'
-		# @return [String, nil] the file's dylib ID
-		def dylib_id
-			machos.first.dylib_id
-		end
-
-		# Changes the file's dylib ID to `new_id`. If the file is not a dylib, does nothing.
-		# @example
-		#  file.dylib_id = 'libFoo.dylib'
-		# @param new_id [String] the new dylib ID
-		# @return [void]
-		# @raise [ArgumentError] if `new_id` is not a String
-		def dylib_id=(new_id)
-			if !new_id.is_a?(String)
-				raise ArgumentError.new("argument must be a String")
-			end
-
-			if !machos.all?(&:dylib?)
-				return nil
-			end
-
-			machos.each do |macho|
-				macho.dylib_id = new_id
-			end
-
-			synchronize_raw_data
-		end
-
-		# All shared libraries linked to the file's Mach-Os.
-		# @return [Array<String>] an array of all shared libraries
-		def linked_dylibs
-			# can machos inside fat binaries have different dylibs?
-			machos.flat_map(&:linked_dylibs).uniq
-		end
-
-		# Changes all dependent shared library install names from `old_name` to `new_name`.
-		# In a fat file, this changes install names in all internal Mach-Os.
-		# @example
-		#  file.change_install_name('/usr/lib/libFoo.dylib', '/usr/lib/libBar.dylib')
-		# @param old_name [String] the shared library name being changed
-		# @param new_name [String] the new name
-		# @todo incomplete
-		def change_install_name(old_name, new_name)
-			machos.each do |macho|
-				macho.change_install_name(old_name, new_name)
-			end
-
-			synchronize_raw_data
-		end
-
-		alias :change_dylib :change_install_name
-
-		# Extract a Mach-O with the given CPU type from the file.
-		# @example
-		#  file.extract("CPU_TYPE_I386") # => MachO::MachOFile
-		# @param cputype [String] the CPU type of the Mach-O being extracted
-		# @return [MachO::MachOFile, nil] the extracted Mach-O or nil if no Mach-O has the given CPU type
-		def extract(cputype)
-			machos.select { |macho| macho.cputype == cputype }.first
-		end
-
-		# Write all (fat) data to the given filename.
-		# @param filename [String] the file to write to
-		def write(filename)
-			File.open(filename, "wb") { |f| f.write(@raw_data) }
-		end
-
-		# Write all (fat) data to the file used to initialize the instance.
-		# @note Overwrites all data in the file!
-		def write!
-			File.open(@filename, "wb") { |f| f.write(@raw_data) }
-		end
-
-		private
-
-		# Obtain the fat header from raw file data.
-		# @return [MachO::FatHeader] the fat header
-		# @raise [MachO::MagicError] if the magic is not valid Mach-O magic
-		# @raise [MachO::MachOBinaryError] if the magic is for a non-fat Mach-O file
-		# @private
-		def get_fat_header
-			magic, nfat_arch = @raw_data[0..7].unpack("N2")
-
-			raise MagicError.new(magic) unless MachO.magic?(magic)
-			raise MachOBinaryError.new unless MachO.fat_magic?(magic)
-
-			FatHeader.new(magic, nfat_arch)
-		end
-
-		# Obtain an array of fat architectures from raw file data.
-		# @return [Array<MachO::FatArch>] an array of fat architectures
-		# @private
-		def get_fat_archs
-			archs = []
-
-			header.nfat_arch.times do |i|
-				fields = @raw_data[8 + (FatArch.bytesize * i), FatArch.bytesize].unpack("N5")
-				archs << FatArch.new(*fields)
-			end
-
-			archs
-		end
-
-		# Obtain an array of Mach-O blobs from raw file data.
-		# @return [Array<MachO::MachOFile>] an array of Mach-Os
-		# @private
-		def get_machos
-			machos = []
-
-			fat_archs.each do |arch|
-				machos << MachOFile.new_from_bin(@raw_data[arch.offset, arch.size])
-			end
-
-			machos
-		end
-
-		# @todo this needs to be redesigned. arch[:offset] and arch[:size] are
-		# already out-of-date, and the header needs to be synchronized as well.
-		# @private
-		def synchronize_raw_data
-			machos.each_with_index do |macho, i|
-				arch = fat_archs[i]
-
-				@raw_data[arch.offset, arch.size] = macho.serialize
-			end
-		end
-	end
+  # Represents a "Fat" file, which contains a header, a listing of available
+  # architectures, and one or more Mach-O binaries.
+  # @see https://en.wikipedia.org/wiki/Mach-O#Multi-architecture_binaries
+  # @see MachO::MachOFile
+  class FatFile
+    # @return [String] the filename loaded from, or nil if loaded from a binary string
+    attr_accessor :filename
+
+    # @return [MachO::FatHeader] the file's header
+    attr_reader :header
+
+    # @return [Array<MachO::FatArch>] an array of fat architectures
+    attr_reader :fat_archs
+
+    # @return [Array<MachO::MachOFile>] an array of Mach-O binaries
+    attr_reader :machos
+
+    # Creates a new FatFile instance from a binary string.
+    # @param bin [String] a binary string containing raw Mach-O data
+    # @return [MachO::FatFile] a new FatFile
+    def self.new_from_bin(bin)
+      instance = allocate
+      instance.initialize_from_bin(bin)
+
+      instance
+    end
+
+    # Creates a new FatFile from the given filename.
+    # @param filename [String] the fat file to load from
+    # @raise [ArgumentError] if the given file does not exist
+    def initialize(filename)
+      raise ArgumentError.new("#{filename}: no such file") unless File.file?(filename)
+
+      @filename = filename
+      @raw_data = File.open(@filename, "rb") { |f| f.read }
+      @header = get_fat_header
+      @fat_archs = get_fat_archs
+      @machos = get_machos
+    end
+
+    # @api private
+    def initialize_from_bin(bin)
+      @filename = nil
+      @raw_data = bin
+      @header = get_fat_header
+      @fat_archs = get_fat_archs
+      @machos = get_machos
+    end
+
+    # The file's raw fat data.
+    # @return [String] the raw fat data
+    def serialize
+      @raw_data
+    end
+
+    # @return [Boolean] true if the file is of type `MH_OBJECT`, false otherwise
+    def object?
+      machos.first.object?
+    end
+
+    # @return [Boolean] true if the file is of type `MH_EXECUTE`, false otherwise
+    def executable?
+      machos.first.executable?
+    end
+
+    # @return [Boolean] true if the file is of type `MH_FVMLIB`, false otherwise
+    def fvmlib?
+      machos.first.fvmlib?
+    end
+
+    # @return [Boolean] true if the file is of type `MH_CORE`, false otherwise
+    def core?
+      machos.first.core?
+    end
+
+    # @return [Boolean] true if the file is of type `MH_PRELOAD`, false otherwise
+    def preload?
+      machos.first.preload?
+    end
+
+    # @return [Boolean] true if the file is of type `MH_DYLIB`, false otherwise
+    def dylib?
+      machos.first.dylib?
+    end
+
+    # @return [Boolean] true if the file is of type `MH_DYLINKER`, false otherwise
+    def dylinker?
+      machos.first.dylinker?
+    end
+
+    # @return [Boolean] true if the file is of type `MH_BUNDLE`, false otherwise
+    def bundle?
+      machos.first.bundle?
+    end
+
+    # @return [Boolean] true if the file is of type `MH_DSYM`, false otherwise
+    def dsym?
+      machos.first.dsym?
+    end
+
+    # @return [Boolean] true if the file is of type `MH_KEXT_BUNDLE`, false otherwise
+    def kext?
+      machos.first.kext?
+    end
+
+    # @return [Fixnum] the file's magic number
+    def magic
+      header.magic
+    end
+
+    # @return [String] a string representation of the file's magic number
+    def magic_string
+      MH_MAGICS[magic]
+    end
+
+    # The file's type. Assumed to be the same for every Mach-O within.
+    # @return [String] the filetype
+    def filetype
+      machos.first.filetype
+    end
+
+    # The file's dylib ID. If the file is not a dylib, returns `nil`.
+    # @example
+    #  file.dylib_id # => 'libBar.dylib'
+    # @return [String, nil] the file's dylib ID
+    def dylib_id
+      machos.first.dylib_id
+    end
+
+    # Changes the file's dylib ID to `new_id`. If the file is not a dylib, does nothing.
+    # @example
+    #  file.dylib_id = 'libFoo.dylib'
+    # @param new_id [String] the new dylib ID
+    # @return [void]
+    # @raise [ArgumentError] if `new_id` is not a String
+    def dylib_id=(new_id)
+      if !new_id.is_a?(String)
+        raise ArgumentError.new("argument must be a String")
+      end
+
+      if !machos.all?(&:dylib?)
+        return nil
+      end
+
+      machos.each do |macho|
+        macho.dylib_id = new_id
+      end
+
+      synchronize_raw_data
+    end
+
+    # All shared libraries linked to the file's Mach-Os.
+    # @return [Array<String>] an array of all shared libraries
+    def linked_dylibs
+      # Individual architectures in a fat binary can link to different subsets
+      # of libraries, but at this point we want to have the full picture, i.e.
+      # the union of all libraries used by all architectures.
+      machos.map(&:linked_dylibs).flatten.uniq
+    end
+
+    # Changes all dependent shared library install names from `old_name` to `new_name`.
+    # In a fat file, this changes install names in all internal Mach-Os.
+    # @example
+    #  file.change_install_name('/usr/lib/libFoo.dylib', '/usr/lib/libBar.dylib')
+    # @param old_name [String] the shared library name being changed
+    # @param new_name [String] the new name
+    # @todo incomplete
+    def change_install_name(old_name, new_name)
+      machos.each do |macho|
+        macho.change_install_name(old_name, new_name)
+      end
+
+      synchronize_raw_data
+    end
+
+    alias :change_dylib :change_install_name
+
+    # Extract a Mach-O with the given CPU type from the file.
+    # @example
+    #  file.extract(:i386) # => MachO::MachOFile
+    # @param cputype [Symbol] the CPU type of the Mach-O being extracted
+    # @return [MachO::MachOFile, nil] the extracted Mach-O or nil if no Mach-O has the given CPU type
+    def extract(cputype)
+      machos.select { |macho| macho.cputype == cputype }.first
+    end
+
+    # Write all (fat) data to the given filename.
+    # @param filename [String] the file to write to
+    def write(filename)
+      File.open(filename, "wb") { |f| f.write(@raw_data) }
+    end
+
+    # Write all (fat) data to the file used to initialize the instance.
+    # @return [void]
+    # @raise [MachO::MachOError] if the instance was initialized without a file
+    # @note Overwrites all data in the file!
+    def write!
+      if filename.nil?
+        raise MachOError.new("cannot write to a default file when initialized from a binary string")
+      else
+        File.open(@filename, "wb") { |f| f.write(@raw_data) }
+      end
+    end
+
+    private
+
+    # Obtain the fat header from raw file data.
+    # @return [MachO::FatHeader] the fat header
+    # @raise [MachO::TruncatedFileError] if the file is too small to have a valid header
+    # @raise [MachO::MagicError] if the magic is not valid Mach-O magic
+    # @raise [MachO::MachOBinaryError] if the magic is for a non-fat Mach-O file
+    # @raise [MachO::JavaClassFileError] if the file is a Java classfile
+    # @private
+    def get_fat_header
+      # the smallest fat Mach-O header is 8 bytes
+      raise TruncatedFileError.new if @raw_data.size < 8
+
+      fh = FatHeader.new_from_bin(:big, @raw_data[0, FatHeader.bytesize])
+
+      raise MagicError.new(fh.magic) unless MachO.magic?(fh.magic)
+      raise MachOBinaryError.new unless MachO.fat_magic?(fh.magic)
+
+      # Rationale: Java classfiles have the same magic as big-endian fat
+      # Mach-Os. Classfiles encode their version at the same offset as
+      # `nfat_arch` and the lowest version number is 43, so we error out
+      # if a file claims to have over 30 internal architectures. It's
+      # technically possible for a fat Mach-O to have over 30 architectures,
+      # but this is extremely unlikely and in practice distinguishes the two
+      # formats.
+      raise JavaClassFileError.new if fh.nfat_arch > 30
+
+      fh
+    end
+
+    # Obtain an array of fat architectures from raw file data.
+    # @return [Array<MachO::FatArch>] an array of fat architectures
+    # @private
+    def get_fat_archs
+      archs = []
+
+      fa_off = FatHeader.bytesize
+      fa_len = FatArch.bytesize
+      header.nfat_arch.times do |i|
+        archs << FatArch.new_from_bin(:big, @raw_data[fa_off + (fa_len * i), fa_len])
+      end
+
+      archs
+    end
+
+    # Obtain an array of Mach-O blobs from raw file data.
+    # @return [Array<MachO::MachOFile>] an array of Mach-Os
+    # @private
+    def get_machos
+      machos = []
+
+      fat_archs.each do |arch|
+        machos << MachOFile.new_from_bin(@raw_data[arch.offset, arch.size])
+      end
+
+      machos
+    end
+
+    # @todo this needs to be redesigned. arch[:offset] and arch[:size] are
+    # already out-of-date, and the header needs to be synchronized as well.
+    # @private
+    def synchronize_raw_data
+      machos.each_with_index do |macho, i|
+        arch = fat_archs[i]
+
+        @raw_data[arch.offset, arch.size] = macho.serialize
+      end
+    end
+  end
 end