Class: Indis::Target

Inherits:

Object

• Object
• Indis::Target

show all

Defined in:

lib/indis-core/target.rb

Overview

Instance Attribute Summary (collapse)

• - (Indis::BinaryArchitecture::Arcitecture) architecture readonly

  Binary architecture of the target.

• - (Indis::BinaryFormat::Format) format readonly

  Binary format of the target.

• - (IO) io readonly

  IO object for target binary.

• - (Array<Indis::Segment>) segments

  List of all processed segments.

• - (Array<Indis::Symbol>) symbols

  List of all processed symbols.

• - (Indis::VMMap) vmmap readonly

  Virtual memory map.

Instance Method Summary (collapse)

• - (Target) initialize(filename) constructor

  A new instance of Target.

• - (Object) load

  Perform format load and set up a vm map.

• - (Boolean) meta?

  A target can consist of several other targets (e.g. fat mach-o).

• - (Object) publish_event(event, *args)

  Post an event with optional payload.

• - (Indis::Symbol^?) resolve_symbol_at_address(vmaddr)

  Resolves a symbol at given virtual address.

• - (Object) subscribe_for_event(event, listener)

  External class can subscribe for events happening with target.

44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

# File 'lib/indis-core/target.rb', line 44

def initialize(filename)
  raise ArgumentError, "File does not exist" unless FileTest.file?(filename)
  @filename = filename
  @io = StringIO.new(File.open(filename).read().force_encoding('BINARY'))
  
  magic = @io.read(4).unpack('V')[0]
  @io.seek(-4, IO::SEEK_CUR)

  fmts = BinaryFormat.known_formats.map { |f| f if f.magic == magic }.compact
  
  raise RuntimeError, "Unknown format for magic #{magic.to_s(16)}" if fmts.length == 0
  raise RuntimeError, "Several possible formats: #{fmts}" if fmts.length > 1
  
  @format_class = fmts.first
  @format_load_complete = false
end

33
34
35

# File 'lib/indis-core/target.rb', line 33

def architecture
  @architecture
end

31
32
33

# File 'lib/indis-core/target.rb', line 31

def format
  @format
end

29
30
31

# File 'lib/indis-core/target.rb', line 29

def io
  @io
end

37
38
39

# File 'lib/indis-core/target.rb', line 37

def segments
  @segments
end

39
40
41

# File 'lib/indis-core/target.rb', line 39

def symbols
  @symbols
end

35
36
37

# File 'lib/indis-core/target.rb', line 35

def vmmap
  @vmmap
end

62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

# File 'lib/indis-core/target.rb', line 62

def load
  raise RuntimeError, "Already loaded" unless @format_class
  @format = @format_class.new(self, @io)
  @format_class = nil
  
  archClass = BinaryArchitecture.known_archs[@format.architecture]
  raise RuntimeError, "Architecture not defined" unless archClass
  @architecture = archClass.new(self)
  
  @vmmap = VMMap.new(self)

  @format_load_complete = true
  replay_queue
  publish_event :target_load_complete
  
  self
end

85
86
87

# File 'lib/indis-core/target.rb', line 85

def meta?
  @subtargets && @subtargets.length > 0
end

100
101
102
103
104
105
106

# File 'lib/indis-core/target.rb', line 100

def publish_event(event, *args)
  if @format_load_complete == true
    subscriptions_array(event).each { |s| s.send(event, *args) }
  else
    enqueue_event(event, args)
  end
end

114
115
116
117
118
119
120

# File 'lib/indis-core/target.rb', line 114

def resolve_symbol_at_address(vmaddr)
  s = @symbols.find { |sym| sym.vmaddr == vmaddr }
  return s if s
  s = @format.resolve_symbol_at_address(vmaddr) if @format.respond_to?(:resolve_symbol_at_address)
  @symbols << s if s
  s
end

93
94
95

# File 'lib/indis-core/target.rb', line 93

def subscribe_for_event(event, listener)
  subscriptions_array(event) << listener
end