Class: MachO::LoadCommands::DylibUseCommand

Inherits:
DylibCommand show all
Defined in:
lib/macho/load_commands.rb

Overview

The newer format of load command representing some aspect of shared libraries, depending on filetype. Corresponds to LC_LOAD_DYLIB or LC_LOAD_WEAK_DYLIB.

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from DylibCommand

#compatibility_version, #current_version, #name, #timestamp

Methods inherited from LoadCommand

#cmd, #cmdsize, create, #offset, #serializable?, #to_s, #type, #view

Methods inherited from MachOStructure

bytesize, format, #initialize

Constructor Details

This class inherits a constructor from MachO::MachOStructure

Class Method Details

.new_from_bin(view) ⇒ DylibCommand

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Instantiates a new DylibCommand or DylibUseCommand. macOS 15 and later use a new format for dylib commands (DylibUseCommand), which is determined based on a special timestamp and the name offset.



608
609
610
611
612
613
614
615
616
617
 
# File 'lib/macho/load_commands.rb', line 608

def self.new_from_bin(view)
  dylib_command = DylibCommand.new_from_bin(view)

  if dylib_command.timestamp == DYLIB_USE_MARKER &&
     dylib_command.name.to_i == DylibUseCommand.bytesize
    super(view)
  else
    dylib_command
  end
end

Instance Method Details

#flag?(flag) ⇒ Boolean

Returns true if flag applies to this dylib command.

Examples:

puts "this dylib is weakly loaded" if dylib_command.flag?(:DYLIB_USE_WEAK_LINK)



623
624
625
626
627
628
629
 
# File 'lib/macho/load_commands.rb', line 623

def flag?(flag)
  flag = DYLIB_USE_FLAGS[flag]

  return false if flag.nil?

  flags & flag == flag
end

#flags ⇒ Integer 



598
 
# File 'lib/macho/load_commands.rb', line 598

field :flags, :uint32

#serialize(context) ⇒ String

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns the serialized fields of the load command.



635
636
637
638
639
640
641
642
643
 
# File 'lib/macho/load_commands.rb', line 635

def serialize(context)
  format = Utils.specialize_format(self.class.format, context.endianness)
  string_payload, string_offsets = Utils.pack_strings(self.class.bytesize,
                                                      context.alignment,
                                                      :name => name.to_s)
  cmdsize = self.class.bytesize + string_payload.bytesize
  [cmd, cmdsize, string_offsets[:name], marker, current_version,
   compatibility_version, flags].pack(format) + string_payload
end

#to_h ⇒ Hash 



646
647
648
649
650
 
# File 'lib/macho/load_commands.rb', line 646

def to_h
  {
    "flags" => flags,
  }.merge super
end