/
disassemble_insn_properties.adb
244 lines (192 loc) · 8.42 KB
/
disassemble_insn_properties.adb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
------------------------------------------------------------------------------
-- --
-- GNATcoverage --
-- --
-- Copyright (C) 2014-2024, AdaCore --
-- --
-- GNATcoverage is free software; you can redistribute it and/or modify it --
-- under terms of the GNU General Public License as published by the Free --
-- Software Foundation; either version 3, or (at your option) any later --
-- version. This software is distributed in the hope that it will be useful --
-- but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHAN- --
-- TABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public --
-- License for more details. You should have received a copy of the GNU --
-- General Public License distributed with this software; see file --
-- COPYING3. If not, go to http://www.gnu.org/licenses for a complete copy --
-- of the license. --
------------------------------------------------------------------------------
with Ada.Characters.Handling;
with Ada.Text_IO; use Ada.Text_IO;
with Interfaces; use Interfaces;
with GNATCOLL.JSON; use GNATCOLL.JSON;
with Binary_Files; use Binary_Files;
with Disassemblers;
with Elf_Disassemblers;
with Hex_Images;
with Highlighting;
with Strings; use Strings;
with Traces_Elf; use Traces_Elf;
with Traces; use Traces;
package body Disassemble_Insn_Properties is
function "+" (PC : Pc_Type) return JSON_Value is
(Create ("0x" & Hex_Images.Hex_Image (PC)));
-- Shortcut to convert addresses to GNATCOLL.JSON strings "0x...". We
-- represent addresses as hexadecimal strings in order not to rely on JSON
-- libraries implementation constraints about abritrarily sized integers.
Branch_Kind_Strings : constant array (Branch_Kind) of Unbounded_String :=
(Br_None => +"none",
Br_Call => +"call",
Br_Ret => +"return",
Br_Jmp => +"jump");
-----------------
-- Disassemble --
-----------------
procedure Disassemble
(Exec_File_Name : String;
Locations : User_Locations;
Compact : Boolean)
is
Exec_Acc : Exe_File_Acc := Open_File (Exec_File_Name, 0);
Exec : Exe_File_Type'Class renames Exec_Acc.all;
Proc_Locs : Proc_Locations;
Section_Iter : Addresses_Iterator;
Section : Address_Info_Acc;
Disassembler : access Disassemblers.Disassembler'Class;
PC : Pc_Type;
Insns : Binary_Content;
Insn_Len : Integer;
Result : constant JSON_Value := Create_Object;
JSON_Section : JSON_Value := JSON_Null;
JSON_Insns : JSON_Array := Empty_Array;
function Create_Section (Section : Address_Info_Acc) return JSON_Value;
-- Create, initialize and return a JSON object for Section
function Create_Instruction (PC : Pc_Type) return JSON_Value;
-- Create, initialize and return the instruction at PC
--------------------
-- Create_Section --
--------------------
function Create_Section (Section : Address_Info_Acc) return JSON_Value
is
Result : constant JSON_Value := Create_Object;
begin
Result.Set_Field ("name", Section.Section_Name.all);
Result.Set_Field ("low", +Section.First);
Result.Set_Field ("high", +Section.Last);
return Result;
end Create_Section;
------------------------
-- Create_Instruction --
------------------------
function Create_Instruction (PC : Pc_Type) return JSON_Value
is
use Highlighting;
Result : constant JSON_Value := Create_Object;
JSON_Tokens : JSON_Array;
Insn : constant Binary_Content :=
Slice (Insns, PC, Insns.Last);
Buffer : Highlighting.Buffer_Type (128);
Branch : Branch_Kind;
Flag_Indir, Flag_Cond : Boolean;
Branch_Dest, FT_Dest : Disassemblers.Dest;
Mnemonic_Kind : Some_Token_Kind;
Cur : Cursor;
begin
-- Get disassembly tokens and instruction properties
Disassembler.Disassemble_Insn (Insn, PC, Buffer, Insn_Len, Exec);
Disassembler.Get_Insn_Properties
(Insn, PC,
Branch,
Flag_Indir, Flag_Cond,
Branch_Dest, FT_Dest);
Mnemonic_Kind :=
Disassemblers.Get_Mnemonic_Kind
(Branch, Flag_Cond);
-- Fill the JSON_Tokens array with all tokens
Cur := Buffer.First;
loop
exit when Cur = No_Element;
declare
use Ada.Characters.Handling;
JSON_Token : constant JSON_Value := Create_Object;
Token_Kind : constant Some_Token_Kind :=
(if Token (Cur) = Mnemonic
then Mnemonic_Kind
else Token (Cur));
begin
JSON_Token.Set_Field
("type",
To_Lower (Some_Token_Kind'Image (Token_Kind)));
JSON_Token.Set_Field ("text", Text (Cur));
Append (JSON_Tokens, JSON_Token);
end;
Next (Cur);
end loop;
-- Attach various information to the JSON result
Result.Set_Field ("asm", JSON_Tokens);
Result.Set_Field ("low", +PC);
Result.Set_Field
("high", +(PC + Pc_Type (Insn_Len) - 1));
Result.Set_Field ("type", Branch_Kind_Strings (Branch));
Result.Set_Field ("cond", Flag_Cond);
if Branch in Br_Call | Br_Jmp then
Result.Set_Field ("fallthrough-target", +FT_Dest.Target);
Result.Set_Field ("fallthrough-delay-slot", +FT_Dest.Delay_Slot);
Result.Set_Field ("indir", Flag_Indir);
if not Flag_Indir then
Result.Set_Field ("branch-target", +Branch_Dest.Target);
Result.Set_Field ("branch-delay-slot", +Branch_Dest.Delay_Slot);
end if;
end if;
return Result;
end Create_Instruction;
I_Ranges : Elf_Disassemblers.Insn_Set_Ranges_Cst_Acc;
Cache : Elf_Disassemblers.Insn_Set_Cache;
Insn_Set : Elf_Disassemblers.Insn_Set_Type;
-- Start of processing for Disassemble
begin
Build_Sections (Exec);
Build_Symbols (Exec);
Build_Debug_Lines (Exec);
Translate_Locations (Exec_Acc, Locations, Proc_Locs);
Init_Iterator (Exec, Section_Addresses, Section_Iter);
loop
Next_Iterator (Section_Iter, Section);
exit when Section = null;
Load_Section_Content (Exec, Section);
PC := Section.First;
Insns := Section.Section_Content;
JSON_Section := Create_Section (Section);
I_Ranges := Get_Insn_Set_Ranges (Exec, Section.Section_Sec_Idx);
Cache := Elf_Disassemblers.Empty_Cache;
while Elf_Disassemblers.Iterate_Over_Insns
(I_Ranges.all, Cache, Insns.Last, PC, Insn_Set)
loop
Disassembler := Elf_Disassemblers.Disa_For_Machine
(Machine, Insn_Set);
Insn_Len := Disassembler.
Get_Insn_Length (Slice (Insns, PC, Insns.Last));
if Matches_Locations (Exec_Acc, Proc_Locs, PC) then
Append (JSON_Insns, Create_Instruction (PC));
end if;
-- Get the address of the next instruction to disassemble and stop
-- when wrapping.
declare
Old_PC : constant Pc_Type := PC;
begin
PC := PC + Pc_Type (Insn_Len);
exit when PC < Old_PC;
end;
end loop;
Free (Section.Section_LS);
Section.Section_Content := Invalid_Binary_Content;
if not Is_Empty (JSON_Insns) then
JSON_Section.Set_Field ("insns", JSON_Insns);
Result.Set_Field (Section.Section_Name.all, JSON_Section);
JSON_Section := JSON_Null;
JSON_Insns := Empty_Array;
end if;
end loop;
Close_File (Exec_Acc);
Put_Line (Result.Write (Compact));
end Disassemble;
end Disassemble_Insn_Properties;