Class: MachO::LoadCommand

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

Overview

Mach-O load command structure This is the most generic load command - only cmd ID and size are represented, and no actual data. Used when a more specific class isn't available/implemented.

Defined Under Namespace

Classes: LCStr

Constant Summary collapse

FORMAT = 
"L=2"
SIZEOF = 
8

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from MachOStructure

bytesize

Constructor Details

#initialize(raw_data, offset, cmd, cmdsize) ⇒ LoadCommand

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 a new instance of LoadCommand.

Parameters:

  • raw_data (String) —

    the raw Mach-O data

  • offset (Fixnum) —

    the offset to initialize with

  • cmd (Fixnum) —

    the load command's identifying number

  • cmdsize (Fixnum) —

    the size of the load command in bytes



181
182
183
184
185
186
 
# File 'lib/macho/load_commands.rb', line 181

def initialize(raw_data, offset, cmd, cmdsize)
  @raw_data = raw_data
  @offset = offset
  @cmd = cmd
  @cmdsize = cmdsize
end

Instance Attribute Details

#cmd ⇒ Fixnum (readonly)

Returns the load command's identifying number.

Returns:

  • (Fixnum) —

    the load command's identifying number



155
156
157
 
# File 'lib/macho/load_commands.rb', line 155

def cmd
  @cmd
end

#cmdsize ⇒ Fixnum (readonly)

Returns the size of the load command, in bytes.

Returns:

  • (Fixnum) —

    the size of the load command, in bytes



158
159
160
 
# File 'lib/macho/load_commands.rb', line 158

def cmdsize
  @cmdsize
end

#offset ⇒ Fixnum (readonly)

Returns the offset in the file the command was created from.

Returns:

  • (Fixnum) —

    the offset in the file the command was created from



152
153
154
 
# File 'lib/macho/load_commands.rb', line 152

def offset
  @offset
end

Class Method Details

.new_from_bin(raw_data, endianness, offset, bin) ⇒ MachO::LoadCommand

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.

Creates a new LoadCommand given an offset and binary string

Parameters:

  • raw_data (String) —

    the raw Mach-O data

  • endianness (Symbol) —

    the endianness of the command (:big or :little)

  • offset (Fixnum) —

    the offset to initialize with

  • bin (String) —

    the binary string to initialize with

Returns:



170
171
172
173
174
 
# File 'lib/macho/load_commands.rb', line 170

def self.new_from_bin(raw_data, endianness, offset, bin)
  format = specialize_format(self::FORMAT, endianness)

  self.new(raw_data, offset, *bin.unpack(format))
end

Instance Method Details

#to_s ⇒ String

Returns a string representation of the load command's identifying number.

Returns:

  • (String) —

    a string representation of the load command's identifying number



196
197
198
 
# File 'lib/macho/load_commands.rb', line 196

def to_s
  type.to_s
end

#type ⇒ Symbol Also known as: to_sym

Returns a symbol representation of the load command's identifying number.

Returns:

  • (Symbol) —

    a symbol representation of the load command's identifying number



189
190
191
 
# File 'lib/macho/load_commands.rb', line 189

def type
  LOAD_COMMANDS[cmd]
end