Class: MachO::LoadCommands::LoadCommand::LCStr

Inherits:

Object

• Object
• MachO::LoadCommands::LoadCommand::LCStr

Defined in:

lib/macho/load_commands.rb

Overview

Represents a Load Command string. A rough analogue to the lc_str struct used internally by OS X. This class allows ruby-macho to pretend that strings stored in LCs are immediately available without explicit operations on the raw Mach-O data.

Instance Method Summary

• #initialize(lc, lc_str) ⇒ LCStr constructor private

  A new instance of LCStr.

• #to_i ⇒ Fixnum

  The offset to the beginning of the string in the load command.

• #to_s ⇒ String

  A string representation of the LCStr.

Constructor Details

#initialize(lc, lc_str) ⇒ LCStr

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.

TODO:

devise a solution such that the lc_str parameter is not interpreted differently depending on lc.view. The current behavior is a hack to allow viewless load command creation.

Returns a new instance of LCStr.

Raises:

• (MachO::LCStrMalformedError) —

  if the string is malformed

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

def initialize(lc, lc_str)
  view = lc.view

  if view
    lc_str_abs = view.offset + lc_str
    lc_end = view.offset + lc.cmdsize - 1
    raw_string = view.raw_data.slice(lc_str_abs..lc_end)
    @string, null_byte, _padding = raw_string.partition("\x00")
    raise LCStrMalformedError, lc if null_byte.empty?
    @string_offset = lc_str
  else
    @string = lc_str
    @string_offset = 0
  end
end

Instance Method Details

#to_i ⇒ Fixnum

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

def to_i
  @string_offset
end

#to_s ⇒ String

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

def to_s
  @string
end