# typed: true # rubocop:todo Sorbet/StrictSigil # frozen_string_literal: true require "macho" # {Pathname} extension for dealing with Mach-O files. module MachOShim extend Forwardable extend T::Helpers requires_ancestor { Pathname } delegate [:dylib_id] => :macho def initialize(*args) @macho = T.let(nil, T.nilable(MachO::MachOFile)) @mach_data = T.let(nil, T.nilable(T::Array[T::Hash[Symbol, T.untyped]])) super end def macho @macho ||= MachO.open(to_s) end private :macho sig { returns(T::Array[T::Hash[Symbol, T.untyped]]) } def mach_data @mach_data ||= begin machos = [] mach_data = [] if MachO::Utils.fat_magic?(macho.magic) machos = macho.machos else machos << macho end machos.each do |m| arch = case m.cputype when :x86_64, :i386, :ppc64, :arm64, :arm then m.cputype when :ppc then :ppc7400 else :dunno end type = case m.filetype when :dylib, :bundle then m.filetype when :execute then :executable else :dunno end mach_data << { arch:, type: } end mach_data rescue MachO::NotAMachOError # Silently ignore errors that indicate the file is not a Mach-O binary ... [] rescue # ... but complain about other (parse) errors for further investigation. onoe "Failed to read Mach-O binary: #{self}" raise if Homebrew::EnvConfig.developer? [] end end private :mach_data # TODO: See if the `#write!` call can be delayed until # we know we're not making any changes to the rpaths. def delete_rpath(rpath, **options) candidates = rpaths(resolve_variable_references: false).select do |r| resolve_variable_name(r) == resolve_variable_name(rpath) end # Delete the last instance to avoid changing the order in which rpaths are searched. rpath_to_delete = candidates.last options[:last] = true macho.delete_rpath(rpath_to_delete, options) macho.write! end def change_rpath(old, new, **options) macho.change_rpath(old, new, options) macho.write! end def change_dylib_id(id, **options) macho.change_dylib_id(id, options) macho.write! end def change_install_name(old, new, **options) macho.change_install_name(old, new, options) macho.write! end def dynamically_linked_libraries(except: :none, resolve_variable_references: true) lcs = macho.dylib_load_commands lcs.reject! { |lc| lc.flag?(except) } if except != :none names = lcs.map { |lc| lc.name.to_s }.uniq names.map! { resolve_variable_name(_1) } if resolve_variable_references names end def rpaths(resolve_variable_references: true) names = macho.rpaths # Don't recursively resolve rpaths to avoid infinite loops. names.map! { |name| resolve_variable_name(name, resolve_rpaths: false) } if resolve_variable_references names end def resolve_variable_name(name, resolve_rpaths: true) if name.start_with? "@loader_path" Pathname(name.sub("@loader_path", dirname)).cleanpath.to_s elsif name.start_with?("@executable_path") && binary_executable? Pathname(name.sub("@executable_path", dirname)).cleanpath.to_s elsif resolve_rpaths && name.start_with?("@rpath") && (target = resolve_rpath(name)).present? target else name end end def resolve_rpath(name) target = T.let(nil, T.nilable(String)) return unless rpaths(resolve_variable_references: true).find do |rpath| File.exist?(target = File.join(rpath, name.delete_prefix("@rpath"))) end target end def archs mach_data.map { |m| m.fetch :arch } end def arch case archs.length when 0 then :dunno when 1 then archs.first else :universal end end def universal? arch == :universal end def i386? arch == :i386 end def x86_64? arch == :x86_64 end def ppc7400? arch == :ppc7400 end def ppc64? arch == :ppc64 end def dylib? mach_data.any? { |m| m.fetch(:type) == :dylib } end def mach_o_executable? mach_data.any? { |m| m.fetch(:type) == :executable } end alias binary_executable? mach_o_executable? def mach_o_bundle? mach_data.any? { |m| m.fetch(:type) == :bundle } end end