1 /*
2 * Copyright © 2018 Valve Corporation
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
13 * Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
21 * IN THE SOFTWARE.
22 *
23 */
24
25 #include "aco_ir.h"
26
27 #ifdef LLVM_AVAILABLE
28 #if defined(_MSC_VER) && defined(restrict)
29 #undef restrict
30 #endif
31 #include "llvm/ac_llvm_util.h"
32
33 #include "llvm-c/Disassembler.h"
34 #include <llvm/ADT/StringRef.h>
35 #include <llvm/MC/MCDisassembler/MCDisassembler.h>
36 #endif
37
38 #include <array>
39 #include <iomanip>
40 #include <vector>
41
42 namespace aco {
43 namespace {
44
45 std::vector<bool>
get_referenced_blocks(Program * program)46 get_referenced_blocks(Program* program)
47 {
48 std::vector<bool> referenced_blocks(program->blocks.size());
49 referenced_blocks[0] = true;
50 for (Block& block : program->blocks) {
51 for (unsigned succ : block.linear_succs)
52 referenced_blocks[succ] = true;
53 }
54 return referenced_blocks;
55 }
56
57 void
print_block_markers(FILE * output,Program * program,const std::vector<bool> & referenced_blocks,unsigned * next_block,unsigned pos)58 print_block_markers(FILE* output, Program* program, const std::vector<bool>& referenced_blocks,
59 unsigned* next_block, unsigned pos)
60 {
61 while (*next_block < program->blocks.size() && pos == program->blocks[*next_block].offset) {
62 if (referenced_blocks[*next_block])
63 fprintf(output, "BB%u:\n", *next_block);
64 (*next_block)++;
65 }
66 }
67
68 void
print_instr(FILE * output,const std::vector<uint32_t> & binary,char * instr,unsigned size,unsigned pos)69 print_instr(FILE* output, const std::vector<uint32_t>& binary, char* instr, unsigned size,
70 unsigned pos)
71 {
72 fprintf(output, "%-60s ;", instr);
73
74 for (unsigned i = 0; i < size; i++)
75 fprintf(output, " %.8x", binary[pos + i]);
76 fputc('\n', output);
77 }
78
79 void
print_constant_data(FILE * output,Program * program)80 print_constant_data(FILE* output, Program* program)
81 {
82 if (program->constant_data.empty())
83 return;
84
85 fputs("\n/* constant data */\n", output);
86 for (unsigned i = 0; i < program->constant_data.size(); i += 32) {
87 fprintf(output, "[%.6u]", i);
88 unsigned line_size = std::min<size_t>(program->constant_data.size() - i, 32);
89 for (unsigned j = 0; j < line_size; j += 4) {
90 unsigned size = std::min<size_t>(program->constant_data.size() - (i + j), 4);
91 uint32_t v = 0;
92 memcpy(&v, &program->constant_data[i + j], size);
93 fprintf(output, " %.8x", v);
94 }
95 fputc('\n', output);
96 }
97 }
98
99 /**
100 * Determines the GPU type to use for CLRXdisasm
101 */
102 const char*
to_clrx_device_name(amd_gfx_level gfx_level,radeon_family family)103 to_clrx_device_name(amd_gfx_level gfx_level, radeon_family family)
104 {
105 switch (gfx_level) {
106 case GFX6:
107 switch (family) {
108 case CHIP_TAHITI: return "tahiti";
109 case CHIP_PITCAIRN: return "pitcairn";
110 case CHIP_VERDE: return "capeverde";
111 case CHIP_OLAND: return "oland";
112 case CHIP_HAINAN: return "hainan";
113 default: return nullptr;
114 }
115 case GFX7:
116 switch (family) {
117 case CHIP_BONAIRE: return "bonaire";
118 case CHIP_KAVERI: return "gfx700";
119 case CHIP_HAWAII: return "hawaii";
120 default: return nullptr;
121 }
122 case GFX8:
123 switch (family) {
124 case CHIP_TONGA: return "tonga";
125 case CHIP_ICELAND: return "iceland";
126 case CHIP_CARRIZO: return "carrizo";
127 case CHIP_FIJI: return "fiji";
128 case CHIP_STONEY: return "stoney";
129 case CHIP_POLARIS10: return "polaris10";
130 case CHIP_POLARIS11: return "polaris11";
131 case CHIP_POLARIS12: return "polaris12";
132 case CHIP_VEGAM: return "polaris11";
133 default: return nullptr;
134 }
135 case GFX9:
136 switch (family) {
137 case CHIP_VEGA10: return "vega10";
138 case CHIP_VEGA12: return "vega12";
139 case CHIP_VEGA20: return "vega20";
140 case CHIP_RAVEN: return "raven";
141 default: return nullptr;
142 }
143 case GFX10:
144 switch (family) {
145 case CHIP_NAVI10: return "gfx1010";
146 case CHIP_NAVI12: return "gfx1011";
147 default: return nullptr;
148 }
149 case GFX10_3:
150 case GFX11: return nullptr;
151 default: unreachable("Invalid chip class!"); return nullptr;
152 }
153 }
154
155 bool
get_branch_target(char ** output,Program * program,const std::vector<bool> & referenced_blocks,char ** line_start)156 get_branch_target(char** output, Program* program, const std::vector<bool>& referenced_blocks,
157 char** line_start)
158 {
159 unsigned pos;
160 if (sscanf(*line_start, ".L%d_0", &pos) != 1)
161 return false;
162 pos /= 4;
163 *line_start = strchr(*line_start, '_') + 2;
164
165 for (Block& block : program->blocks) {
166 if (referenced_blocks[block.index] && block.offset == pos) {
167 *output += sprintf(*output, "BB%u", block.index);
168 return true;
169 }
170 }
171 return false;
172 }
173
174 bool
print_asm_clrx(Program * program,std::vector<uint32_t> & binary,unsigned exec_size,FILE * output)175 print_asm_clrx(Program* program, std::vector<uint32_t>& binary, unsigned exec_size, FILE* output)
176 {
177 #ifdef _WIN32
178 return true;
179 #else
180 char path[] = "/tmp/fileXXXXXX";
181 char line[2048], command[128];
182 FILE* p;
183 int fd;
184
185 const char* gpu_type = to_clrx_device_name(program->gfx_level, program->family);
186
187 /* Dump the binary into a temporary file. */
188 fd = mkstemp(path);
189 if (fd < 0)
190 return true;
191
192 for (unsigned i = 0; i < exec_size; i++) {
193 if (write(fd, &binary[i], 4) == -1)
194 goto fail;
195 }
196
197 sprintf(command, "clrxdisasm --gpuType=%s -r %s", gpu_type, path);
198
199 p = popen(command, "r");
200 if (p) {
201 if (!fgets(line, sizeof(line), p)) {
202 fprintf(output, "clrxdisasm not found\n");
203 pclose(p);
204 goto fail;
205 }
206
207 std::vector<bool> referenced_blocks = get_referenced_blocks(program);
208 unsigned next_block = 0;
209
210 char prev_instr[2048];
211 unsigned prev_pos = 0;
212 do {
213 char* line_start = line;
214 if (strncmp(line_start, "/*", 2))
215 continue;
216
217 unsigned pos;
218 if (sscanf(line_start, "/*%x*/", &pos) != 1)
219 continue;
220 pos /= 4u; /* get the dword position */
221
222 while (strncmp(line_start, "*/", 2))
223 line_start++;
224 line_start += 2;
225
226 while (line_start[0] == ' ')
227 line_start++;
228 *strchr(line_start, '\n') = 0;
229
230 if (*line_start == 0)
231 continue; /* not an instruction, only a comment */
232
233 if (pos != prev_pos) {
234 /* Print the previous instruction, now that we know the encoding size. */
235 print_instr(output, binary, prev_instr, pos - prev_pos, prev_pos);
236 prev_pos = pos;
237 }
238
239 print_block_markers(output, program, referenced_blocks, &next_block, pos);
240
241 char* dest = prev_instr;
242 *(dest++) = '\t';
243 while (*line_start) {
244 if (!strncmp(line_start, ".L", 2) &&
245 get_branch_target(&dest, program, referenced_blocks, &line_start))
246 continue;
247 *(dest++) = *(line_start++);
248 }
249 *(dest++) = 0;
250 } while (fgets(line, sizeof(line), p));
251
252 if (prev_pos != exec_size)
253 print_instr(output, binary, prev_instr, exec_size - prev_pos, prev_pos);
254
255 pclose(p);
256
257 print_constant_data(output, program);
258 }
259
260 return false;
261
262 fail:
263 close(fd);
264 unlink(path);
265 return true;
266 #endif
267 }
268
269 #ifdef LLVM_AVAILABLE
270 std::pair<bool, size_t>
disasm_instr(amd_gfx_level gfx_level,LLVMDisasmContextRef disasm,uint32_t * binary,unsigned exec_size,size_t pos,char * outline,unsigned outline_size)271 disasm_instr(amd_gfx_level gfx_level, LLVMDisasmContextRef disasm, uint32_t* binary,
272 unsigned exec_size, size_t pos, char* outline, unsigned outline_size)
273 {
274 size_t l =
275 LLVMDisasmInstruction(disasm, (uint8_t*)&binary[pos], (exec_size - pos) * sizeof(uint32_t),
276 pos * 4, outline, outline_size);
277
278 if (gfx_level >= GFX10 && l == 8 && ((binary[pos] & 0xffff0000) == 0xd7610000) &&
279 ((binary[pos + 1] & 0x1ff) == 0xff)) {
280 /* v_writelane with literal uses 3 dwords but llvm consumes only 2 */
281 l += 4;
282 }
283
284 bool invalid = false;
285 size_t size;
286 if (!l &&
287 ((gfx_level >= GFX9 &&
288 (binary[pos] & 0xffff8000) == 0xd1348000) || /* v_add_u32_e64 + clamp */
289 (gfx_level >= GFX10 &&
290 (binary[pos] & 0xffff8000) == 0xd7038000) || /* v_add_u16_e64 + clamp */
291 (gfx_level <= GFX9 &&
292 (binary[pos] & 0xffff8000) == 0xd1268000) || /* v_add_u16_e64 + clamp */
293 (gfx_level >= GFX10 && (binary[pos] & 0xffff8000) == 0xd76d8000) || /* v_add3_u32 + clamp */
294 (gfx_level == GFX9 && (binary[pos] & 0xffff8000) == 0xd1ff8000)) /* v_add3_u32 + clamp */) {
295 strcpy(outline, "\tinteger addition + clamp");
296 bool has_literal = gfx_level >= GFX10 && (((binary[pos + 1] & 0x1ff) == 0xff) ||
297 (((binary[pos + 1] >> 9) & 0x1ff) == 0xff));
298 size = 2 + has_literal;
299 } else if (gfx_level >= GFX10 && l == 4 && ((binary[pos] & 0xfe0001ff) == 0x020000f9)) {
300 strcpy(outline, "\tv_cndmask_b32 + sdwa");
301 size = 2;
302 } else if (!l) {
303 strcpy(outline, "(invalid instruction)");
304 size = 1;
305 invalid = true;
306 } else {
307 assert(l % 4 == 0);
308 size = l / 4;
309 }
310
311 #if LLVM_VERSION_MAJOR <= 14
312 /* See: https://github.com/GPUOpen-Tools/radeon_gpu_profiler/issues/65 and
313 * https://github.com/llvm/llvm-project/issues/38652
314 */
315 if (invalid) {
316 /* do nothing */
317 } else if (gfx_level == GFX9 && (binary[pos] & 0xfc024000) == 0xc0024000) {
318 /* SMEM with IMM=1 and SOE=1: LLVM ignores SOFFSET */
319 size_t len = strlen(outline);
320
321 char imm[16] = {0};
322 while (outline[--len] != ' ') ;
323 strncpy(imm, outline + len + 1, sizeof(imm) - 1);
324
325 snprintf(outline + len, outline_size - len, " s%u offset:%s", binary[pos + 1] >> 25, imm);
326 } else if (gfx_level >= GFX10 && (binary[pos] & 0xfc000000) == 0xf4000000 &&
327 (binary[pos + 1] & 0xfe000000) != 0xfa000000) {
328 /* SMEM non-NULL SOFFSET: LLVM ignores OFFSET */
329 uint32_t offset = binary[pos + 1] & 0x1fffff;
330 if (offset) {
331 size_t len = strlen(outline);
332 snprintf(outline + len, outline_size - len, " offset:0x%x", offset);
333 }
334 }
335 #endif
336
337 return std::make_pair(invalid, size);
338 }
339
340 bool
print_asm_llvm(Program * program,std::vector<uint32_t> & binary,unsigned exec_size,FILE * output)341 print_asm_llvm(Program* program, std::vector<uint32_t>& binary, unsigned exec_size, FILE* output)
342 {
343 std::vector<bool> referenced_blocks = get_referenced_blocks(program);
344
345 std::vector<llvm::SymbolInfoTy> symbols;
346 std::vector<std::array<char, 16>> block_names;
347 block_names.reserve(program->blocks.size());
348 for (Block& block : program->blocks) {
349 if (!referenced_blocks[block.index])
350 continue;
351 std::array<char, 16> name;
352 sprintf(name.data(), "BB%u", block.index);
353 block_names.push_back(name);
354 symbols.emplace_back(block.offset * 4,
355 llvm::StringRef(block_names[block_names.size() - 1].data()), 0);
356 }
357
358 const char* features = "";
359 if (program->gfx_level >= GFX10 && program->wave_size == 64) {
360 features = "+wavefrontsize64";
361 }
362
363 LLVMDisasmContextRef disasm =
364 LLVMCreateDisasmCPUFeatures("amdgcn-mesa-mesa3d", ac_get_llvm_processor_name(program->family),
365 features, &symbols, 0, NULL, NULL);
366
367 size_t pos = 0;
368 bool invalid = false;
369 unsigned next_block = 0;
370
371 unsigned prev_size = 0;
372 unsigned prev_pos = 0;
373 unsigned repeat_count = 0;
374 while (pos < exec_size) {
375 bool new_block =
376 next_block < program->blocks.size() && pos == program->blocks[next_block].offset;
377 if (pos + prev_size <= exec_size && prev_pos != pos && !new_block &&
378 memcmp(&binary[prev_pos], &binary[pos], prev_size * 4) == 0) {
379 repeat_count++;
380 pos += prev_size;
381 continue;
382 } else {
383 if (repeat_count)
384 fprintf(output, "\t(then repeated %u times)\n", repeat_count);
385 repeat_count = 0;
386 }
387
388 print_block_markers(output, program, referenced_blocks, &next_block, pos);
389
390 char outline[1024];
391 std::pair<bool, size_t> res = disasm_instr(program->gfx_level, disasm, binary.data(),
392 exec_size, pos, outline, sizeof(outline));
393 invalid |= res.first;
394
395 print_instr(output, binary, outline, res.second, pos);
396
397 prev_size = res.second;
398 prev_pos = pos;
399 pos += res.second;
400 }
401 assert(next_block == program->blocks.size());
402
403 LLVMDisasmDispose(disasm);
404
405 print_constant_data(output, program);
406
407 return invalid;
408 }
409 #endif /* LLVM_AVAILABLE */
410
411 } /* end namespace */
412
413 bool
check_print_asm_support(Program * program)414 check_print_asm_support(Program* program)
415 {
416 #ifdef LLVM_AVAILABLE
417 if (program->gfx_level >= GFX8) {
418 /* LLVM disassembler only supports GFX8+ */
419 const char* name = ac_get_llvm_processor_name(program->family);
420 const char* triple = "amdgcn--";
421 LLVMTargetRef target = ac_get_llvm_target(triple);
422
423 LLVMTargetMachineRef tm = LLVMCreateTargetMachine(
424 target, triple, name, "", LLVMCodeGenLevelDefault, LLVMRelocDefault, LLVMCodeModelDefault);
425
426 bool supported = ac_is_llvm_processor_supported(tm, name);
427 LLVMDisposeTargetMachine(tm);
428
429 if (supported)
430 return true;
431 }
432 #endif
433
434 #ifndef _WIN32
435 /* Check if CLRX disassembler binary is available and can disassemble the program */
436 return to_clrx_device_name(program->gfx_level, program->family) &&
437 system("clrxdisasm --version") == 0;
438 #else
439 return false;
440 #endif
441 }
442
443 /* Returns true on failure */
444 bool
print_asm(Program * program,std::vector<uint32_t> & binary,unsigned exec_size,FILE * output)445 print_asm(Program* program, std::vector<uint32_t>& binary, unsigned exec_size, FILE* output)
446 {
447 #ifdef LLVM_AVAILABLE
448 if (program->gfx_level >= GFX8) {
449 return print_asm_llvm(program, binary, exec_size, output);
450 }
451 #endif
452
453 return print_asm_clrx(program, binary, exec_size, output);
454 }
455
456 } // namespace aco
457