1 //===-- X86InstComments.cpp - Generate verbose-asm comments for instrs ----===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This defines functionality used to emit comments about X86 instructions to
10 // an output stream for -fverbose-asm.
11 //
12 //===----------------------------------------------------------------------===//
13
14 #include "X86InstComments.h"
15 #include "X86ATTInstPrinter.h"
16 #include "X86BaseInfo.h"
17 #include "X86MCTargetDesc.h"
18 #include "Utils/X86ShuffleDecode.h"
19 #include "llvm/MC/MCInst.h"
20 #include "llvm/MC/MCInstrInfo.h"
21 #include "llvm/Support/raw_ostream.h"
22
23 using namespace llvm;
24
25 #define CASE_SSE_INS_COMMON(Inst, src) \
26 case X86::Inst##src:
27
28 #define CASE_AVX_INS_COMMON(Inst, Suffix, src) \
29 case X86::V##Inst##Suffix##src:
30
31 #define CASE_MASK_INS_COMMON(Inst, Suffix, src) \
32 case X86::V##Inst##Suffix##src##k:
33
34 #define CASE_MASKZ_INS_COMMON(Inst, Suffix, src) \
35 case X86::V##Inst##Suffix##src##kz:
36
37 #define CASE_AVX512_INS_COMMON(Inst, Suffix, src) \
38 CASE_AVX_INS_COMMON(Inst, Suffix, src) \
39 CASE_MASK_INS_COMMON(Inst, Suffix, src) \
40 CASE_MASKZ_INS_COMMON(Inst, Suffix, src)
41
42 #define CASE_MOVDUP(Inst, src) \
43 CASE_AVX512_INS_COMMON(Inst, Z, r##src) \
44 CASE_AVX512_INS_COMMON(Inst, Z256, r##src) \
45 CASE_AVX512_INS_COMMON(Inst, Z128, r##src) \
46 CASE_AVX_INS_COMMON(Inst, , r##src) \
47 CASE_AVX_INS_COMMON(Inst, Y, r##src) \
48 CASE_SSE_INS_COMMON(Inst, r##src)
49
50 #define CASE_MASK_MOVDUP(Inst, src) \
51 CASE_MASK_INS_COMMON(Inst, Z, r##src) \
52 CASE_MASK_INS_COMMON(Inst, Z256, r##src) \
53 CASE_MASK_INS_COMMON(Inst, Z128, r##src)
54
55 #define CASE_MASKZ_MOVDUP(Inst, src) \
56 CASE_MASKZ_INS_COMMON(Inst, Z, r##src) \
57 CASE_MASKZ_INS_COMMON(Inst, Z256, r##src) \
58 CASE_MASKZ_INS_COMMON(Inst, Z128, r##src)
59
60 #define CASE_PMOVZX(Inst, src) \
61 CASE_AVX512_INS_COMMON(Inst, Z, r##src) \
62 CASE_AVX512_INS_COMMON(Inst, Z256, r##src) \
63 CASE_AVX512_INS_COMMON(Inst, Z128, r##src) \
64 CASE_AVX_INS_COMMON(Inst, , r##src) \
65 CASE_AVX_INS_COMMON(Inst, Y, r##src) \
66 CASE_SSE_INS_COMMON(Inst, r##src)
67
68 #define CASE_MASK_PMOVZX(Inst, src) \
69 CASE_MASK_INS_COMMON(Inst, Z, r##src) \
70 CASE_MASK_INS_COMMON(Inst, Z256, r##src) \
71 CASE_MASK_INS_COMMON(Inst, Z128, r##src)
72
73 #define CASE_MASKZ_PMOVZX(Inst, src) \
74 CASE_MASKZ_INS_COMMON(Inst, Z, r##src) \
75 CASE_MASKZ_INS_COMMON(Inst, Z256, r##src) \
76 CASE_MASKZ_INS_COMMON(Inst, Z128, r##src)
77
78 #define CASE_UNPCK(Inst, src) \
79 CASE_AVX512_INS_COMMON(Inst, Z, r##src) \
80 CASE_AVX512_INS_COMMON(Inst, Z256, r##src) \
81 CASE_AVX512_INS_COMMON(Inst, Z128, r##src) \
82 CASE_AVX_INS_COMMON(Inst, , r##src) \
83 CASE_AVX_INS_COMMON(Inst, Y, r##src) \
84 CASE_SSE_INS_COMMON(Inst, r##src)
85
86 #define CASE_MASK_UNPCK(Inst, src) \
87 CASE_MASK_INS_COMMON(Inst, Z, r##src) \
88 CASE_MASK_INS_COMMON(Inst, Z256, r##src) \
89 CASE_MASK_INS_COMMON(Inst, Z128, r##src)
90
91 #define CASE_MASKZ_UNPCK(Inst, src) \
92 CASE_MASKZ_INS_COMMON(Inst, Z, r##src) \
93 CASE_MASKZ_INS_COMMON(Inst, Z256, r##src) \
94 CASE_MASKZ_INS_COMMON(Inst, Z128, r##src)
95
96 #define CASE_SHUF(Inst, suf) \
97 CASE_AVX512_INS_COMMON(Inst, Z, suf) \
98 CASE_AVX512_INS_COMMON(Inst, Z256, suf) \
99 CASE_AVX512_INS_COMMON(Inst, Z128, suf) \
100 CASE_AVX_INS_COMMON(Inst, , suf) \
101 CASE_AVX_INS_COMMON(Inst, Y, suf) \
102 CASE_SSE_INS_COMMON(Inst, suf)
103
104 #define CASE_MASK_SHUF(Inst, src) \
105 CASE_MASK_INS_COMMON(Inst, Z, r##src##i) \
106 CASE_MASK_INS_COMMON(Inst, Z256, r##src##i) \
107 CASE_MASK_INS_COMMON(Inst, Z128, r##src##i)
108
109 #define CASE_MASKZ_SHUF(Inst, src) \
110 CASE_MASKZ_INS_COMMON(Inst, Z, r##src##i) \
111 CASE_MASKZ_INS_COMMON(Inst, Z256, r##src##i) \
112 CASE_MASKZ_INS_COMMON(Inst, Z128, r##src##i)
113
114 #define CASE_VPERMILPI(Inst, src) \
115 CASE_AVX512_INS_COMMON(Inst, Z, src##i) \
116 CASE_AVX512_INS_COMMON(Inst, Z256, src##i) \
117 CASE_AVX512_INS_COMMON(Inst, Z128, src##i) \
118 CASE_AVX_INS_COMMON(Inst, , src##i) \
119 CASE_AVX_INS_COMMON(Inst, Y, src##i)
120
121 #define CASE_MASK_VPERMILPI(Inst, src) \
122 CASE_MASK_INS_COMMON(Inst, Z, src##i) \
123 CASE_MASK_INS_COMMON(Inst, Z256, src##i) \
124 CASE_MASK_INS_COMMON(Inst, Z128, src##i)
125
126 #define CASE_MASKZ_VPERMILPI(Inst, src) \
127 CASE_MASKZ_INS_COMMON(Inst, Z, src##i) \
128 CASE_MASKZ_INS_COMMON(Inst, Z256, src##i) \
129 CASE_MASKZ_INS_COMMON(Inst, Z128, src##i)
130
131 #define CASE_VPERM(Inst, src) \
132 CASE_AVX512_INS_COMMON(Inst, Z, src##i) \
133 CASE_AVX512_INS_COMMON(Inst, Z256, src##i) \
134 CASE_AVX_INS_COMMON(Inst, Y, src##i)
135
136 #define CASE_MASK_VPERM(Inst, src) \
137 CASE_MASK_INS_COMMON(Inst, Z, src##i) \
138 CASE_MASK_INS_COMMON(Inst, Z256, src##i)
139
140 #define CASE_MASKZ_VPERM(Inst, src) \
141 CASE_MASKZ_INS_COMMON(Inst, Z, src##i) \
142 CASE_MASKZ_INS_COMMON(Inst, Z256, src##i)
143
144 #define CASE_VSHUF(Inst, src) \
145 CASE_AVX512_INS_COMMON(SHUFF##Inst, Z, r##src##i) \
146 CASE_AVX512_INS_COMMON(SHUFI##Inst, Z, r##src##i) \
147 CASE_AVX512_INS_COMMON(SHUFF##Inst, Z256, r##src##i) \
148 CASE_AVX512_INS_COMMON(SHUFI##Inst, Z256, r##src##i)
149
150 #define CASE_MASK_VSHUF(Inst, src) \
151 CASE_MASK_INS_COMMON(SHUFF##Inst, Z, r##src##i) \
152 CASE_MASK_INS_COMMON(SHUFI##Inst, Z, r##src##i) \
153 CASE_MASK_INS_COMMON(SHUFF##Inst, Z256, r##src##i) \
154 CASE_MASK_INS_COMMON(SHUFI##Inst, Z256, r##src##i)
155
156 #define CASE_MASKZ_VSHUF(Inst, src) \
157 CASE_MASKZ_INS_COMMON(SHUFF##Inst, Z, r##src##i) \
158 CASE_MASKZ_INS_COMMON(SHUFI##Inst, Z, r##src##i) \
159 CASE_MASKZ_INS_COMMON(SHUFF##Inst, Z256, r##src##i) \
160 CASE_MASKZ_INS_COMMON(SHUFI##Inst, Z256, r##src##i)
161
162 #define CASE_AVX512_FMA(Inst, suf) \
163 CASE_AVX512_INS_COMMON(Inst, Z, suf) \
164 CASE_AVX512_INS_COMMON(Inst, Z256, suf) \
165 CASE_AVX512_INS_COMMON(Inst, Z128, suf)
166
167 #define CASE_FMA(Inst, suf) \
168 CASE_AVX512_FMA(Inst, suf) \
169 CASE_AVX_INS_COMMON(Inst, , suf) \
170 CASE_AVX_INS_COMMON(Inst, Y, suf)
171
172 #define CASE_FMA_PACKED_REG(Inst) \
173 CASE_FMA(Inst##PD, r) \
174 CASE_FMA(Inst##PS, r)
175
176 #define CASE_FMA_PACKED_MEM(Inst) \
177 CASE_FMA(Inst##PD, m) \
178 CASE_FMA(Inst##PS, m) \
179 CASE_AVX512_FMA(Inst##PD, mb) \
180 CASE_AVX512_FMA(Inst##PS, mb)
181
182 #define CASE_FMA_SCALAR_REG(Inst) \
183 CASE_AVX_INS_COMMON(Inst##SD, , r) \
184 CASE_AVX_INS_COMMON(Inst##SS, , r) \
185 CASE_AVX_INS_COMMON(Inst##SD, , r_Int) \
186 CASE_AVX_INS_COMMON(Inst##SS, , r_Int) \
187 CASE_AVX_INS_COMMON(Inst##SD, Z, r) \
188 CASE_AVX_INS_COMMON(Inst##SS, Z, r) \
189 CASE_AVX512_INS_COMMON(Inst##SD, Z, r_Int) \
190 CASE_AVX512_INS_COMMON(Inst##SS, Z, r_Int)
191
192 #define CASE_FMA_SCALAR_MEM(Inst) \
193 CASE_AVX_INS_COMMON(Inst##SD, , m) \
194 CASE_AVX_INS_COMMON(Inst##SS, , m) \
195 CASE_AVX_INS_COMMON(Inst##SD, , m_Int) \
196 CASE_AVX_INS_COMMON(Inst##SS, , m_Int) \
197 CASE_AVX_INS_COMMON(Inst##SD, Z, m) \
198 CASE_AVX_INS_COMMON(Inst##SS, Z, m) \
199 CASE_AVX512_INS_COMMON(Inst##SD, Z, m_Int) \
200 CASE_AVX512_INS_COMMON(Inst##SS, Z, m_Int)
201
getVectorRegSize(unsigned RegNo)202 static unsigned getVectorRegSize(unsigned RegNo) {
203 if (X86::ZMM0 <= RegNo && RegNo <= X86::ZMM31)
204 return 512;
205 if (X86::YMM0 <= RegNo && RegNo <= X86::YMM31)
206 return 256;
207 if (X86::XMM0 <= RegNo && RegNo <= X86::XMM31)
208 return 128;
209 if (X86::MM0 <= RegNo && RegNo <= X86::MM7)
210 return 64;
211
212 llvm_unreachable("Unknown vector reg!");
213 }
214
getRegOperandNumElts(const MCInst * MI,unsigned ScalarSize,unsigned OperandIndex)215 static unsigned getRegOperandNumElts(const MCInst *MI, unsigned ScalarSize,
216 unsigned OperandIndex) {
217 unsigned OpReg = MI->getOperand(OperandIndex).getReg();
218 return getVectorRegSize(OpReg) / ScalarSize;
219 }
220
getRegName(unsigned Reg)221 static const char *getRegName(unsigned Reg) {
222 return X86ATTInstPrinter::getRegisterName(Reg);
223 }
224
225 /// Wraps the destination register name with AVX512 mask/maskz filtering.
printMasking(raw_ostream & OS,const MCInst * MI,const MCInstrInfo & MCII)226 static void printMasking(raw_ostream &OS, const MCInst *MI,
227 const MCInstrInfo &MCII) {
228 const MCInstrDesc &Desc = MCII.get(MI->getOpcode());
229 uint64_t TSFlags = Desc.TSFlags;
230
231 if (!(TSFlags & X86II::EVEX_K))
232 return;
233
234 bool MaskWithZero = (TSFlags & X86II::EVEX_Z);
235 unsigned MaskOp = Desc.getNumDefs();
236
237 if (Desc.getOperandConstraint(MaskOp, MCOI::TIED_TO) != -1)
238 ++MaskOp;
239
240 const char *MaskRegName = getRegName(MI->getOperand(MaskOp).getReg());
241
242 // MASK: zmmX {%kY}
243 OS << " {%" << MaskRegName << "}";
244
245 // MASKZ: zmmX {%kY} {z}
246 if (MaskWithZero)
247 OS << " {z}";
248 }
249
printFMA3Comments(const MCInst * MI,raw_ostream & OS)250 static bool printFMA3Comments(const MCInst *MI, raw_ostream &OS) {
251 const char *Mul1Name = nullptr, *Mul2Name = nullptr, *AccName = nullptr;
252 unsigned NumOperands = MI->getNumOperands();
253 bool RegForm = false;
254 bool Negate = false;
255 StringRef AccStr = "+";
256
257 // The operands for FMA instructions without rounding fall into two forms.
258 // dest, src1, src2, src3
259 // dest, src1, mask, src2, src3
260 // Where src3 is either a register or 5 memory address operands. So to find
261 // dest and src1 we can index from the front. To find src2 and src3 we can
262 // index from the end by taking into account memory vs register form when
263 // finding src2.
264
265 switch (MI->getOpcode()) {
266 default:
267 return false;
268 CASE_FMA_PACKED_REG(FMADD132)
269 CASE_FMA_SCALAR_REG(FMADD132)
270 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
271 RegForm = true;
272 LLVM_FALLTHROUGH;
273 CASE_FMA_PACKED_MEM(FMADD132)
274 CASE_FMA_SCALAR_MEM(FMADD132)
275 AccName = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
276 Mul1Name = getRegName(MI->getOperand(1).getReg());
277 break;
278
279 CASE_FMA_PACKED_REG(FMADD213)
280 CASE_FMA_SCALAR_REG(FMADD213)
281 AccName = getRegName(MI->getOperand(NumOperands - 1).getReg());
282 RegForm = true;
283 LLVM_FALLTHROUGH;
284 CASE_FMA_PACKED_MEM(FMADD213)
285 CASE_FMA_SCALAR_MEM(FMADD213)
286 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
287 Mul2Name = getRegName(MI->getOperand(1).getReg());
288 break;
289
290 CASE_FMA_PACKED_REG(FMADD231)
291 CASE_FMA_SCALAR_REG(FMADD231)
292 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
293 RegForm = true;
294 LLVM_FALLTHROUGH;
295 CASE_FMA_PACKED_MEM(FMADD231)
296 CASE_FMA_SCALAR_MEM(FMADD231)
297 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
298 AccName = getRegName(MI->getOperand(1).getReg());
299 break;
300
301 CASE_FMA_PACKED_REG(FMSUB132)
302 CASE_FMA_SCALAR_REG(FMSUB132)
303 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
304 RegForm = true;
305 LLVM_FALLTHROUGH;
306 CASE_FMA_PACKED_MEM(FMSUB132)
307 CASE_FMA_SCALAR_MEM(FMSUB132)
308 AccName = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
309 Mul1Name = getRegName(MI->getOperand(1).getReg());
310 AccStr = "-";
311 break;
312
313 CASE_FMA_PACKED_REG(FMSUB213)
314 CASE_FMA_SCALAR_REG(FMSUB213)
315 AccName = getRegName(MI->getOperand(NumOperands - 1).getReg());
316 RegForm = true;
317 LLVM_FALLTHROUGH;
318 CASE_FMA_PACKED_MEM(FMSUB213)
319 CASE_FMA_SCALAR_MEM(FMSUB213)
320 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
321 Mul2Name = getRegName(MI->getOperand(1).getReg());
322 AccStr = "-";
323 break;
324
325 CASE_FMA_PACKED_REG(FMSUB231)
326 CASE_FMA_SCALAR_REG(FMSUB231)
327 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
328 RegForm = true;
329 LLVM_FALLTHROUGH;
330 CASE_FMA_PACKED_MEM(FMSUB231)
331 CASE_FMA_SCALAR_MEM(FMSUB231)
332 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
333 AccName = getRegName(MI->getOperand(1).getReg());
334 AccStr = "-";
335 break;
336
337 CASE_FMA_PACKED_REG(FNMADD132)
338 CASE_FMA_SCALAR_REG(FNMADD132)
339 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
340 RegForm = true;
341 LLVM_FALLTHROUGH;
342 CASE_FMA_PACKED_MEM(FNMADD132)
343 CASE_FMA_SCALAR_MEM(FNMADD132)
344 AccName = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
345 Mul1Name = getRegName(MI->getOperand(1).getReg());
346 Negate = true;
347 break;
348
349 CASE_FMA_PACKED_REG(FNMADD213)
350 CASE_FMA_SCALAR_REG(FNMADD213)
351 AccName = getRegName(MI->getOperand(NumOperands - 1).getReg());
352 RegForm = true;
353 LLVM_FALLTHROUGH;
354 CASE_FMA_PACKED_MEM(FNMADD213)
355 CASE_FMA_SCALAR_MEM(FNMADD213)
356 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
357 Mul2Name = getRegName(MI->getOperand(1).getReg());
358 Negate = true;
359 break;
360
361 CASE_FMA_PACKED_REG(FNMADD231)
362 CASE_FMA_SCALAR_REG(FNMADD231)
363 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
364 RegForm = true;
365 LLVM_FALLTHROUGH;
366 CASE_FMA_PACKED_MEM(FNMADD231)
367 CASE_FMA_SCALAR_MEM(FNMADD231)
368 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
369 AccName = getRegName(MI->getOperand(1).getReg());
370 Negate = true;
371 break;
372
373 CASE_FMA_PACKED_REG(FNMSUB132)
374 CASE_FMA_SCALAR_REG(FNMSUB132)
375 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
376 RegForm = true;
377 LLVM_FALLTHROUGH;
378 CASE_FMA_PACKED_MEM(FNMSUB132)
379 CASE_FMA_SCALAR_MEM(FNMSUB132)
380 AccName = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
381 Mul1Name = getRegName(MI->getOperand(1).getReg());
382 AccStr = "-";
383 Negate = true;
384 break;
385
386 CASE_FMA_PACKED_REG(FNMSUB213)
387 CASE_FMA_SCALAR_REG(FNMSUB213)
388 AccName = getRegName(MI->getOperand(NumOperands - 1).getReg());
389 RegForm = true;
390 LLVM_FALLTHROUGH;
391 CASE_FMA_PACKED_MEM(FNMSUB213)
392 CASE_FMA_SCALAR_MEM(FNMSUB213)
393 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
394 Mul2Name = getRegName(MI->getOperand(1).getReg());
395 AccStr = "-";
396 Negate = true;
397 break;
398
399 CASE_FMA_PACKED_REG(FNMSUB231)
400 CASE_FMA_SCALAR_REG(FNMSUB231)
401 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
402 RegForm = true;
403 LLVM_FALLTHROUGH;
404 CASE_FMA_PACKED_MEM(FNMSUB231)
405 CASE_FMA_SCALAR_MEM(FNMSUB231)
406 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
407 AccName = getRegName(MI->getOperand(1).getReg());
408 AccStr = "-";
409 Negate = true;
410 break;
411
412 CASE_FMA_PACKED_REG(FMADDSUB132)
413 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
414 RegForm = true;
415 LLVM_FALLTHROUGH;
416 CASE_FMA_PACKED_MEM(FMADDSUB132)
417 AccName = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
418 Mul1Name = getRegName(MI->getOperand(1).getReg());
419 AccStr = "+/-";
420 break;
421
422 CASE_FMA_PACKED_REG(FMADDSUB213)
423 AccName = getRegName(MI->getOperand(NumOperands - 1).getReg());
424 RegForm = true;
425 LLVM_FALLTHROUGH;
426 CASE_FMA_PACKED_MEM(FMADDSUB213)
427 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
428 Mul2Name = getRegName(MI->getOperand(1).getReg());
429 AccStr = "+/-";
430 break;
431
432 CASE_FMA_PACKED_REG(FMADDSUB231)
433 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
434 RegForm = true;
435 LLVM_FALLTHROUGH;
436 CASE_FMA_PACKED_MEM(FMADDSUB231)
437 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
438 AccName = getRegName(MI->getOperand(1).getReg());
439 AccStr = "+/-";
440 break;
441
442 CASE_FMA_PACKED_REG(FMSUBADD132)
443 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
444 RegForm = true;
445 LLVM_FALLTHROUGH;
446 CASE_FMA_PACKED_MEM(FMSUBADD132)
447 AccName = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
448 Mul1Name = getRegName(MI->getOperand(1).getReg());
449 AccStr = "-/+";
450 break;
451
452 CASE_FMA_PACKED_REG(FMSUBADD213)
453 AccName = getRegName(MI->getOperand(NumOperands - 1).getReg());
454 RegForm = true;
455 LLVM_FALLTHROUGH;
456 CASE_FMA_PACKED_MEM(FMSUBADD213)
457 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
458 Mul2Name = getRegName(MI->getOperand(1).getReg());
459 AccStr = "-/+";
460 break;
461
462 CASE_FMA_PACKED_REG(FMSUBADD231)
463 Mul2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
464 RegForm = true;
465 LLVM_FALLTHROUGH;
466 CASE_FMA_PACKED_MEM(FMSUBADD231)
467 Mul1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
468 AccName = getRegName(MI->getOperand(1).getReg());
469 AccStr = "-/+";
470 break;
471 }
472
473 const char *DestName = getRegName(MI->getOperand(0).getReg());
474
475 if (!Mul1Name) Mul1Name = "mem";
476 if (!Mul2Name) Mul2Name = "mem";
477 if (!AccName) AccName = "mem";
478
479 OS << DestName << " = ";
480 // TODO: Print masking information?
481
482 if (Negate)
483 OS << '-';
484
485 OS << '(' << Mul1Name << " * " << Mul2Name << ") " << AccStr << ' '
486 << AccName;
487
488 return true;
489 }
490
491
492 //===----------------------------------------------------------------------===//
493 // Top Level Entrypoint
494 //===----------------------------------------------------------------------===//
495
496 /// EmitAnyX86InstComments - This function decodes x86 instructions and prints
497 /// newline terminated strings to the specified string if desired. This
498 /// information is shown in disassembly dumps when verbose assembly is enabled.
EmitAnyX86InstComments(const MCInst * MI,raw_ostream & OS,const MCInstrInfo & MCII)499 bool llvm::EmitAnyX86InstComments(const MCInst *MI, raw_ostream &OS,
500 const MCInstrInfo &MCII) {
501 // If this is a shuffle operation, the switch should fill in this state.
502 SmallVector<int, 8> ShuffleMask;
503 const char *DestName = nullptr, *Src1Name = nullptr, *Src2Name = nullptr;
504 unsigned NumOperands = MI->getNumOperands();
505 bool RegForm = false;
506
507 if (printFMA3Comments(MI, OS))
508 return true;
509
510 switch (MI->getOpcode()) {
511 default:
512 // Not an instruction for which we can decode comments.
513 return false;
514
515 case X86::BLENDPDrri:
516 case X86::VBLENDPDrri:
517 case X86::VBLENDPDYrri:
518 Src2Name = getRegName(MI->getOperand(2).getReg());
519 LLVM_FALLTHROUGH;
520 case X86::BLENDPDrmi:
521 case X86::VBLENDPDrmi:
522 case X86::VBLENDPDYrmi:
523 if (MI->getOperand(NumOperands - 1).isImm())
524 DecodeBLENDMask(getRegOperandNumElts(MI, 64, 0),
525 MI->getOperand(NumOperands - 1).getImm(),
526 ShuffleMask);
527 Src1Name = getRegName(MI->getOperand(1).getReg());
528 DestName = getRegName(MI->getOperand(0).getReg());
529 break;
530
531 case X86::BLENDPSrri:
532 case X86::VBLENDPSrri:
533 case X86::VBLENDPSYrri:
534 Src2Name = getRegName(MI->getOperand(2).getReg());
535 LLVM_FALLTHROUGH;
536 case X86::BLENDPSrmi:
537 case X86::VBLENDPSrmi:
538 case X86::VBLENDPSYrmi:
539 if (MI->getOperand(NumOperands - 1).isImm())
540 DecodeBLENDMask(getRegOperandNumElts(MI, 32, 0),
541 MI->getOperand(NumOperands - 1).getImm(),
542 ShuffleMask);
543 Src1Name = getRegName(MI->getOperand(1).getReg());
544 DestName = getRegName(MI->getOperand(0).getReg());
545 break;
546
547 case X86::PBLENDWrri:
548 case X86::VPBLENDWrri:
549 case X86::VPBLENDWYrri:
550 Src2Name = getRegName(MI->getOperand(2).getReg());
551 LLVM_FALLTHROUGH;
552 case X86::PBLENDWrmi:
553 case X86::VPBLENDWrmi:
554 case X86::VPBLENDWYrmi:
555 if (MI->getOperand(NumOperands - 1).isImm())
556 DecodeBLENDMask(getRegOperandNumElts(MI, 16, 0),
557 MI->getOperand(NumOperands - 1).getImm(),
558 ShuffleMask);
559 Src1Name = getRegName(MI->getOperand(1).getReg());
560 DestName = getRegName(MI->getOperand(0).getReg());
561 break;
562
563 case X86::VPBLENDDrri:
564 case X86::VPBLENDDYrri:
565 Src2Name = getRegName(MI->getOperand(2).getReg());
566 LLVM_FALLTHROUGH;
567 case X86::VPBLENDDrmi:
568 case X86::VPBLENDDYrmi:
569 if (MI->getOperand(NumOperands - 1).isImm())
570 DecodeBLENDMask(getRegOperandNumElts(MI, 32, 0),
571 MI->getOperand(NumOperands - 1).getImm(),
572 ShuffleMask);
573 Src1Name = getRegName(MI->getOperand(1).getReg());
574 DestName = getRegName(MI->getOperand(0).getReg());
575 break;
576
577 case X86::INSERTPSrr:
578 case X86::VINSERTPSrr:
579 case X86::VINSERTPSZrr:
580 Src2Name = getRegName(MI->getOperand(2).getReg());
581 LLVM_FALLTHROUGH;
582 case X86::INSERTPSrm:
583 case X86::VINSERTPSrm:
584 case X86::VINSERTPSZrm:
585 DestName = getRegName(MI->getOperand(0).getReg());
586 Src1Name = getRegName(MI->getOperand(1).getReg());
587 if (MI->getOperand(NumOperands - 1).isImm())
588 DecodeINSERTPSMask(MI->getOperand(NumOperands - 1).getImm(),
589 ShuffleMask);
590 break;
591
592 case X86::MOVLHPSrr:
593 case X86::VMOVLHPSrr:
594 case X86::VMOVLHPSZrr:
595 Src2Name = getRegName(MI->getOperand(2).getReg());
596 Src1Name = getRegName(MI->getOperand(1).getReg());
597 DestName = getRegName(MI->getOperand(0).getReg());
598 DecodeMOVLHPSMask(2, ShuffleMask);
599 break;
600
601 case X86::MOVHLPSrr:
602 case X86::VMOVHLPSrr:
603 case X86::VMOVHLPSZrr:
604 Src2Name = getRegName(MI->getOperand(2).getReg());
605 Src1Name = getRegName(MI->getOperand(1).getReg());
606 DestName = getRegName(MI->getOperand(0).getReg());
607 DecodeMOVHLPSMask(2, ShuffleMask);
608 break;
609
610 case X86::MOVHPDrm:
611 case X86::VMOVHPDrm:
612 case X86::VMOVHPDZ128rm:
613 Src1Name = getRegName(MI->getOperand(1).getReg());
614 DestName = getRegName(MI->getOperand(0).getReg());
615 DecodeInsertElementMask(2, 1, 1, ShuffleMask);
616 break;
617
618 case X86::MOVHPSrm:
619 case X86::VMOVHPSrm:
620 case X86::VMOVHPSZ128rm:
621 Src1Name = getRegName(MI->getOperand(1).getReg());
622 DestName = getRegName(MI->getOperand(0).getReg());
623 DecodeInsertElementMask(4, 2, 2, ShuffleMask);
624 break;
625
626 case X86::MOVLPDrm:
627 case X86::VMOVLPDrm:
628 case X86::VMOVLPDZ128rm:
629 Src1Name = getRegName(MI->getOperand(1).getReg());
630 DestName = getRegName(MI->getOperand(0).getReg());
631 DecodeInsertElementMask(2, 0, 1, ShuffleMask);
632 break;
633
634 case X86::MOVLPSrm:
635 case X86::VMOVLPSrm:
636 case X86::VMOVLPSZ128rm:
637 Src1Name = getRegName(MI->getOperand(1).getReg());
638 DestName = getRegName(MI->getOperand(0).getReg());
639 DecodeInsertElementMask(4, 0, 2, ShuffleMask);
640 break;
641
642 CASE_MOVDUP(MOVSLDUP, r)
643 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
644 LLVM_FALLTHROUGH;
645
646 CASE_MOVDUP(MOVSLDUP, m)
647 DestName = getRegName(MI->getOperand(0).getReg());
648 DecodeMOVSLDUPMask(getRegOperandNumElts(MI, 32, 0), ShuffleMask);
649 break;
650
651 CASE_MOVDUP(MOVSHDUP, r)
652 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
653 LLVM_FALLTHROUGH;
654
655 CASE_MOVDUP(MOVSHDUP, m)
656 DestName = getRegName(MI->getOperand(0).getReg());
657 DecodeMOVSHDUPMask(getRegOperandNumElts(MI, 32, 0), ShuffleMask);
658 break;
659
660 CASE_MOVDUP(MOVDDUP, r)
661 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
662 LLVM_FALLTHROUGH;
663
664 CASE_MOVDUP(MOVDDUP, m)
665 DestName = getRegName(MI->getOperand(0).getReg());
666 DecodeMOVDDUPMask(getRegOperandNumElts(MI, 64, 0), ShuffleMask);
667 break;
668
669 case X86::PSLLDQri:
670 case X86::VPSLLDQri:
671 case X86::VPSLLDQYri:
672 case X86::VPSLLDQZ128rr:
673 case X86::VPSLLDQZ256rr:
674 case X86::VPSLLDQZrr:
675 Src1Name = getRegName(MI->getOperand(1).getReg());
676 LLVM_FALLTHROUGH;
677 case X86::VPSLLDQZ128rm:
678 case X86::VPSLLDQZ256rm:
679 case X86::VPSLLDQZrm:
680 DestName = getRegName(MI->getOperand(0).getReg());
681 if (MI->getOperand(NumOperands - 1).isImm())
682 DecodePSLLDQMask(getRegOperandNumElts(MI, 8, 0),
683 MI->getOperand(NumOperands - 1).getImm(),
684 ShuffleMask);
685 break;
686
687 case X86::PSRLDQri:
688 case X86::VPSRLDQri:
689 case X86::VPSRLDQYri:
690 case X86::VPSRLDQZ128rr:
691 case X86::VPSRLDQZ256rr:
692 case X86::VPSRLDQZrr:
693 Src1Name = getRegName(MI->getOperand(1).getReg());
694 LLVM_FALLTHROUGH;
695 case X86::VPSRLDQZ128rm:
696 case X86::VPSRLDQZ256rm:
697 case X86::VPSRLDQZrm:
698 DestName = getRegName(MI->getOperand(0).getReg());
699 if (MI->getOperand(NumOperands - 1).isImm())
700 DecodePSRLDQMask(getRegOperandNumElts(MI, 8, 0),
701 MI->getOperand(NumOperands - 1).getImm(),
702 ShuffleMask);
703 break;
704
705 CASE_SHUF(PALIGNR, rri)
706 Src1Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
707 RegForm = true;
708 LLVM_FALLTHROUGH;
709
710 CASE_SHUF(PALIGNR, rmi)
711 Src2Name = getRegName(MI->getOperand(NumOperands-(RegForm?3:7)).getReg());
712 DestName = getRegName(MI->getOperand(0).getReg());
713 if (MI->getOperand(NumOperands - 1).isImm())
714 DecodePALIGNRMask(getRegOperandNumElts(MI, 8, 0),
715 MI->getOperand(NumOperands - 1).getImm(),
716 ShuffleMask);
717 break;
718
719 CASE_AVX512_INS_COMMON(ALIGNQ, Z, rri)
720 CASE_AVX512_INS_COMMON(ALIGNQ, Z256, rri)
721 CASE_AVX512_INS_COMMON(ALIGNQ, Z128, rri)
722 Src1Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
723 RegForm = true;
724 LLVM_FALLTHROUGH;
725
726 CASE_AVX512_INS_COMMON(ALIGNQ, Z, rmi)
727 CASE_AVX512_INS_COMMON(ALIGNQ, Z256, rmi)
728 CASE_AVX512_INS_COMMON(ALIGNQ, Z128, rmi)
729 Src2Name = getRegName(MI->getOperand(NumOperands-(RegForm?3:7)).getReg());
730 DestName = getRegName(MI->getOperand(0).getReg());
731 if (MI->getOperand(NumOperands - 1).isImm())
732 DecodeVALIGNMask(getRegOperandNumElts(MI, 64, 0),
733 MI->getOperand(NumOperands - 1).getImm(),
734 ShuffleMask);
735 break;
736
737 CASE_AVX512_INS_COMMON(ALIGND, Z, rri)
738 CASE_AVX512_INS_COMMON(ALIGND, Z256, rri)
739 CASE_AVX512_INS_COMMON(ALIGND, Z128, rri)
740 Src1Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
741 RegForm = true;
742 LLVM_FALLTHROUGH;
743
744 CASE_AVX512_INS_COMMON(ALIGND, Z, rmi)
745 CASE_AVX512_INS_COMMON(ALIGND, Z256, rmi)
746 CASE_AVX512_INS_COMMON(ALIGND, Z128, rmi)
747 Src2Name = getRegName(MI->getOperand(NumOperands-(RegForm?3:7)).getReg());
748 DestName = getRegName(MI->getOperand(0).getReg());
749 if (MI->getOperand(NumOperands - 1).isImm())
750 DecodeVALIGNMask(getRegOperandNumElts(MI, 32, 0),
751 MI->getOperand(NumOperands - 1).getImm(),
752 ShuffleMask);
753 break;
754
755 CASE_SHUF(PSHUFD, ri)
756 Src1Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
757 LLVM_FALLTHROUGH;
758
759 CASE_SHUF(PSHUFD, mi)
760 DestName = getRegName(MI->getOperand(0).getReg());
761 if (MI->getOperand(NumOperands - 1).isImm())
762 DecodePSHUFMask(getRegOperandNumElts(MI, 32, 0), 32,
763 MI->getOperand(NumOperands - 1).getImm(),
764 ShuffleMask);
765 break;
766
767 CASE_SHUF(PSHUFHW, ri)
768 Src1Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
769 LLVM_FALLTHROUGH;
770
771 CASE_SHUF(PSHUFHW, mi)
772 DestName = getRegName(MI->getOperand(0).getReg());
773 if (MI->getOperand(NumOperands - 1).isImm())
774 DecodePSHUFHWMask(getRegOperandNumElts(MI, 16, 0),
775 MI->getOperand(NumOperands - 1).getImm(),
776 ShuffleMask);
777 break;
778
779 CASE_SHUF(PSHUFLW, ri)
780 Src1Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
781 LLVM_FALLTHROUGH;
782
783 CASE_SHUF(PSHUFLW, mi)
784 DestName = getRegName(MI->getOperand(0).getReg());
785 if (MI->getOperand(NumOperands - 1).isImm())
786 DecodePSHUFLWMask(getRegOperandNumElts(MI, 16, 0),
787 MI->getOperand(NumOperands - 1).getImm(),
788 ShuffleMask);
789 break;
790
791 case X86::MMX_PSHUFWri:
792 Src1Name = getRegName(MI->getOperand(1).getReg());
793 LLVM_FALLTHROUGH;
794
795 case X86::MMX_PSHUFWmi:
796 DestName = getRegName(MI->getOperand(0).getReg());
797 if (MI->getOperand(NumOperands - 1).isImm())
798 DecodePSHUFMask(4, 16, MI->getOperand(NumOperands - 1).getImm(),
799 ShuffleMask);
800 break;
801
802 case X86::PSWAPDrr:
803 Src1Name = getRegName(MI->getOperand(1).getReg());
804 LLVM_FALLTHROUGH;
805
806 case X86::PSWAPDrm:
807 DestName = getRegName(MI->getOperand(0).getReg());
808 DecodePSWAPMask(2, ShuffleMask);
809 break;
810
811 CASE_UNPCK(PUNPCKHBW, r)
812 case X86::MMX_PUNPCKHBWirr:
813 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
814 RegForm = true;
815 LLVM_FALLTHROUGH;
816
817 CASE_UNPCK(PUNPCKHBW, m)
818 case X86::MMX_PUNPCKHBWirm:
819 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
820 DestName = getRegName(MI->getOperand(0).getReg());
821 DecodeUNPCKHMask(getRegOperandNumElts(MI, 8, 0), 8, ShuffleMask);
822 break;
823
824 CASE_UNPCK(PUNPCKHWD, r)
825 case X86::MMX_PUNPCKHWDirr:
826 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
827 RegForm = true;
828 LLVM_FALLTHROUGH;
829
830 CASE_UNPCK(PUNPCKHWD, m)
831 case X86::MMX_PUNPCKHWDirm:
832 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
833 DestName = getRegName(MI->getOperand(0).getReg());
834 DecodeUNPCKHMask(getRegOperandNumElts(MI, 16, 0), 16, ShuffleMask);
835 break;
836
837 CASE_UNPCK(PUNPCKHDQ, r)
838 case X86::MMX_PUNPCKHDQirr:
839 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
840 RegForm = true;
841 LLVM_FALLTHROUGH;
842
843 CASE_UNPCK(PUNPCKHDQ, m)
844 case X86::MMX_PUNPCKHDQirm:
845 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
846 DestName = getRegName(MI->getOperand(0).getReg());
847 DecodeUNPCKHMask(getRegOperandNumElts(MI, 32, 0), 32, ShuffleMask);
848 break;
849
850 CASE_UNPCK(PUNPCKHQDQ, r)
851 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
852 RegForm = true;
853 LLVM_FALLTHROUGH;
854
855 CASE_UNPCK(PUNPCKHQDQ, m)
856 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
857 DestName = getRegName(MI->getOperand(0).getReg());
858 DecodeUNPCKHMask(getRegOperandNumElts(MI, 64, 0), 64, ShuffleMask);
859 break;
860
861 CASE_UNPCK(PUNPCKLBW, r)
862 case X86::MMX_PUNPCKLBWirr:
863 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
864 RegForm = true;
865 LLVM_FALLTHROUGH;
866
867 CASE_UNPCK(PUNPCKLBW, m)
868 case X86::MMX_PUNPCKLBWirm:
869 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
870 DestName = getRegName(MI->getOperand(0).getReg());
871 DecodeUNPCKLMask(getRegOperandNumElts(MI, 8, 0), 8, ShuffleMask);
872 break;
873
874 CASE_UNPCK(PUNPCKLWD, r)
875 case X86::MMX_PUNPCKLWDirr:
876 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
877 RegForm = true;
878 LLVM_FALLTHROUGH;
879
880 CASE_UNPCK(PUNPCKLWD, m)
881 case X86::MMX_PUNPCKLWDirm:
882 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
883 DestName = getRegName(MI->getOperand(0).getReg());
884 DecodeUNPCKLMask(getRegOperandNumElts(MI, 16, 0), 16, ShuffleMask);
885 break;
886
887 CASE_UNPCK(PUNPCKLDQ, r)
888 case X86::MMX_PUNPCKLDQirr:
889 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
890 RegForm = true;
891 LLVM_FALLTHROUGH;
892
893 CASE_UNPCK(PUNPCKLDQ, m)
894 case X86::MMX_PUNPCKLDQirm:
895 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
896 DestName = getRegName(MI->getOperand(0).getReg());
897 DecodeUNPCKLMask(getRegOperandNumElts(MI, 32, 0), 32, ShuffleMask);
898 break;
899
900 CASE_UNPCK(PUNPCKLQDQ, r)
901 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
902 RegForm = true;
903 LLVM_FALLTHROUGH;
904
905 CASE_UNPCK(PUNPCKLQDQ, m)
906 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
907 DestName = getRegName(MI->getOperand(0).getReg());
908 DecodeUNPCKLMask(getRegOperandNumElts(MI, 64, 0), 64, ShuffleMask);
909 break;
910
911 CASE_SHUF(SHUFPD, rri)
912 Src2Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
913 RegForm = true;
914 LLVM_FALLTHROUGH;
915
916 CASE_SHUF(SHUFPD, rmi)
917 if (MI->getOperand(NumOperands - 1).isImm())
918 DecodeSHUFPMask(getRegOperandNumElts(MI, 64, 0), 64,
919 MI->getOperand(NumOperands - 1).getImm(), ShuffleMask);
920 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?3:7)).getReg());
921 DestName = getRegName(MI->getOperand(0).getReg());
922 break;
923
924 CASE_SHUF(SHUFPS, rri)
925 Src2Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
926 RegForm = true;
927 LLVM_FALLTHROUGH;
928
929 CASE_SHUF(SHUFPS, rmi)
930 if (MI->getOperand(NumOperands - 1).isImm())
931 DecodeSHUFPMask(getRegOperandNumElts(MI, 32, 0), 32,
932 MI->getOperand(NumOperands - 1).getImm(),
933 ShuffleMask);
934 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?3:7)).getReg());
935 DestName = getRegName(MI->getOperand(0).getReg());
936 break;
937
938 CASE_VSHUF(64X2, r)
939 Src2Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
940 RegForm = true;
941 LLVM_FALLTHROUGH;
942
943 CASE_VSHUF(64X2, m)
944 decodeVSHUF64x2FamilyMask(getRegOperandNumElts(MI, 64, 0), 64,
945 MI->getOperand(NumOperands - 1).getImm(),
946 ShuffleMask);
947 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?3:7)).getReg());
948 DestName = getRegName(MI->getOperand(0).getReg());
949 break;
950
951 CASE_VSHUF(32X4, r)
952 Src2Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
953 RegForm = true;
954 LLVM_FALLTHROUGH;
955
956 CASE_VSHUF(32X4, m)
957 decodeVSHUF64x2FamilyMask(getRegOperandNumElts(MI, 32, 0), 32,
958 MI->getOperand(NumOperands - 1).getImm(),
959 ShuffleMask);
960 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?3:7)).getReg());
961 DestName = getRegName(MI->getOperand(0).getReg());
962 break;
963
964 CASE_UNPCK(UNPCKLPD, r)
965 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
966 RegForm = true;
967 LLVM_FALLTHROUGH;
968
969 CASE_UNPCK(UNPCKLPD, m)
970 DecodeUNPCKLMask(getRegOperandNumElts(MI, 64, 0), 64, ShuffleMask);
971 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
972 DestName = getRegName(MI->getOperand(0).getReg());
973 break;
974
975 CASE_UNPCK(UNPCKLPS, r)
976 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
977 RegForm = true;
978 LLVM_FALLTHROUGH;
979
980 CASE_UNPCK(UNPCKLPS, m)
981 DecodeUNPCKLMask(getRegOperandNumElts(MI, 32, 0), 32, ShuffleMask);
982 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
983 DestName = getRegName(MI->getOperand(0).getReg());
984 break;
985
986 CASE_UNPCK(UNPCKHPD, r)
987 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
988 RegForm = true;
989 LLVM_FALLTHROUGH;
990
991 CASE_UNPCK(UNPCKHPD, m)
992 DecodeUNPCKHMask(getRegOperandNumElts(MI, 64, 0), 64, ShuffleMask);
993 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
994 DestName = getRegName(MI->getOperand(0).getReg());
995 break;
996
997 CASE_UNPCK(UNPCKHPS, r)
998 Src2Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
999 RegForm = true;
1000 LLVM_FALLTHROUGH;
1001
1002 CASE_UNPCK(UNPCKHPS, m)
1003 DecodeUNPCKHMask(getRegOperandNumElts(MI, 32, 0), 32, ShuffleMask);
1004 Src1Name = getRegName(MI->getOperand(NumOperands-(RegForm?2:6)).getReg());
1005 DestName = getRegName(MI->getOperand(0).getReg());
1006 break;
1007
1008 CASE_VPERMILPI(PERMILPS, r)
1009 Src1Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
1010 LLVM_FALLTHROUGH;
1011
1012 CASE_VPERMILPI(PERMILPS, m)
1013 if (MI->getOperand(NumOperands - 1).isImm())
1014 DecodePSHUFMask(getRegOperandNumElts(MI, 32, 0), 32,
1015 MI->getOperand(NumOperands - 1).getImm(),
1016 ShuffleMask);
1017 DestName = getRegName(MI->getOperand(0).getReg());
1018 break;
1019
1020 CASE_VPERMILPI(PERMILPD, r)
1021 Src1Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
1022 LLVM_FALLTHROUGH;
1023
1024 CASE_VPERMILPI(PERMILPD, m)
1025 if (MI->getOperand(NumOperands - 1).isImm())
1026 DecodePSHUFMask(getRegOperandNumElts(MI, 64, 0), 64,
1027 MI->getOperand(NumOperands - 1).getImm(),
1028 ShuffleMask);
1029 DestName = getRegName(MI->getOperand(0).getReg());
1030 break;
1031
1032 case X86::VPERM2F128rr:
1033 case X86::VPERM2I128rr:
1034 Src2Name = getRegName(MI->getOperand(2).getReg());
1035 LLVM_FALLTHROUGH;
1036
1037 case X86::VPERM2F128rm:
1038 case X86::VPERM2I128rm:
1039 // For instruction comments purpose, assume the 256-bit vector is v4i64.
1040 if (MI->getOperand(NumOperands - 1).isImm())
1041 DecodeVPERM2X128Mask(4, MI->getOperand(NumOperands - 1).getImm(),
1042 ShuffleMask);
1043 Src1Name = getRegName(MI->getOperand(1).getReg());
1044 DestName = getRegName(MI->getOperand(0).getReg());
1045 break;
1046
1047 CASE_VPERM(PERMPD, r)
1048 Src1Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
1049 LLVM_FALLTHROUGH;
1050
1051 CASE_VPERM(PERMPD, m)
1052 if (MI->getOperand(NumOperands - 1).isImm())
1053 DecodeVPERMMask(getRegOperandNumElts(MI, 64, 0),
1054 MI->getOperand(NumOperands - 1).getImm(),
1055 ShuffleMask);
1056 DestName = getRegName(MI->getOperand(0).getReg());
1057 break;
1058
1059 CASE_VPERM(PERMQ, r)
1060 Src1Name = getRegName(MI->getOperand(NumOperands - 2).getReg());
1061 LLVM_FALLTHROUGH;
1062
1063 CASE_VPERM(PERMQ, m)
1064 if (MI->getOperand(NumOperands - 1).isImm())
1065 DecodeVPERMMask(getRegOperandNumElts(MI, 64, 0),
1066 MI->getOperand(NumOperands - 1).getImm(),
1067 ShuffleMask);
1068 DestName = getRegName(MI->getOperand(0).getReg());
1069 break;
1070
1071 case X86::MOVSDrr:
1072 case X86::VMOVSDrr:
1073 case X86::VMOVSDZrr:
1074 Src2Name = getRegName(MI->getOperand(2).getReg());
1075 Src1Name = getRegName(MI->getOperand(1).getReg());
1076 LLVM_FALLTHROUGH;
1077
1078 case X86::MOVSDrm_alt:
1079 case X86::MOVSDrm:
1080 case X86::VMOVSDrm_alt:
1081 case X86::VMOVSDrm:
1082 case X86::VMOVSDZrm:
1083 case X86::VMOVSDZrm_alt:
1084 DecodeScalarMoveMask(2, nullptr == Src2Name, ShuffleMask);
1085 DestName = getRegName(MI->getOperand(0).getReg());
1086 break;
1087
1088 case X86::MOVSSrr:
1089 case X86::VMOVSSrr:
1090 case X86::VMOVSSZrr:
1091 Src2Name = getRegName(MI->getOperand(2).getReg());
1092 Src1Name = getRegName(MI->getOperand(1).getReg());
1093 LLVM_FALLTHROUGH;
1094
1095 case X86::MOVSSrm:
1096 case X86::MOVSSrm_alt:
1097 case X86::VMOVSSrm:
1098 case X86::VMOVSSrm_alt:
1099 case X86::VMOVSSZrm:
1100 case X86::VMOVSSZrm_alt:
1101 DecodeScalarMoveMask(4, nullptr == Src2Name, ShuffleMask);
1102 DestName = getRegName(MI->getOperand(0).getReg());
1103 break;
1104
1105 case X86::MOVPQI2QIrr:
1106 case X86::MOVZPQILo2PQIrr:
1107 case X86::VMOVPQI2QIrr:
1108 case X86::VMOVPQI2QIZrr:
1109 case X86::VMOVZPQILo2PQIrr:
1110 case X86::VMOVZPQILo2PQIZrr:
1111 Src1Name = getRegName(MI->getOperand(1).getReg());
1112 LLVM_FALLTHROUGH;
1113
1114 case X86::MOVQI2PQIrm:
1115 case X86::VMOVQI2PQIrm:
1116 case X86::VMOVQI2PQIZrm:
1117 DecodeZeroMoveLowMask(2, ShuffleMask);
1118 DestName = getRegName(MI->getOperand(0).getReg());
1119 break;
1120
1121 case X86::MOVDI2PDIrm:
1122 case X86::VMOVDI2PDIrm:
1123 case X86::VMOVDI2PDIZrm:
1124 DecodeZeroMoveLowMask(4, ShuffleMask);
1125 DestName = getRegName(MI->getOperand(0).getReg());
1126 break;
1127
1128 case X86::EXTRQI:
1129 if (MI->getOperand(2).isImm() &&
1130 MI->getOperand(3).isImm())
1131 DecodeEXTRQIMask(16, 8, MI->getOperand(2).getImm(),
1132 MI->getOperand(3).getImm(), ShuffleMask);
1133
1134 DestName = getRegName(MI->getOperand(0).getReg());
1135 Src1Name = getRegName(MI->getOperand(1).getReg());
1136 break;
1137
1138 case X86::INSERTQI:
1139 if (MI->getOperand(3).isImm() &&
1140 MI->getOperand(4).isImm())
1141 DecodeINSERTQIMask(16, 8, MI->getOperand(3).getImm(),
1142 MI->getOperand(4).getImm(), ShuffleMask);
1143
1144 DestName = getRegName(MI->getOperand(0).getReg());
1145 Src1Name = getRegName(MI->getOperand(1).getReg());
1146 Src2Name = getRegName(MI->getOperand(2).getReg());
1147 break;
1148
1149 case X86::VBROADCASTF128:
1150 case X86::VBROADCASTI128:
1151 CASE_AVX512_INS_COMMON(BROADCASTF64X2, Z128, rm)
1152 CASE_AVX512_INS_COMMON(BROADCASTI64X2, Z128, rm)
1153 DecodeSubVectorBroadcast(4, 2, ShuffleMask);
1154 DestName = getRegName(MI->getOperand(0).getReg());
1155 break;
1156 CASE_AVX512_INS_COMMON(BROADCASTF64X2, , rm)
1157 CASE_AVX512_INS_COMMON(BROADCASTI64X2, , rm)
1158 DecodeSubVectorBroadcast(8, 2, ShuffleMask);
1159 DestName = getRegName(MI->getOperand(0).getReg());
1160 break;
1161 CASE_AVX512_INS_COMMON(BROADCASTF64X4, , rm)
1162 CASE_AVX512_INS_COMMON(BROADCASTI64X4, , rm)
1163 DecodeSubVectorBroadcast(8, 4, ShuffleMask);
1164 DestName = getRegName(MI->getOperand(0).getReg());
1165 break;
1166 CASE_AVX512_INS_COMMON(BROADCASTF32X4, Z256, rm)
1167 CASE_AVX512_INS_COMMON(BROADCASTI32X4, Z256, rm)
1168 DecodeSubVectorBroadcast(8, 4, ShuffleMask);
1169 DestName = getRegName(MI->getOperand(0).getReg());
1170 break;
1171 CASE_AVX512_INS_COMMON(BROADCASTF32X4, , rm)
1172 CASE_AVX512_INS_COMMON(BROADCASTI32X4, , rm)
1173 DecodeSubVectorBroadcast(16, 4, ShuffleMask);
1174 DestName = getRegName(MI->getOperand(0).getReg());
1175 break;
1176 CASE_AVX512_INS_COMMON(BROADCASTF32X8, , rm)
1177 CASE_AVX512_INS_COMMON(BROADCASTI32X8, , rm)
1178 DecodeSubVectorBroadcast(16, 8, ShuffleMask);
1179 DestName = getRegName(MI->getOperand(0).getReg());
1180 break;
1181 CASE_AVX512_INS_COMMON(BROADCASTI32X2, Z128, r)
1182 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
1183 LLVM_FALLTHROUGH;
1184 CASE_AVX512_INS_COMMON(BROADCASTI32X2, Z128, m)
1185 DecodeSubVectorBroadcast(4, 2, ShuffleMask);
1186 DestName = getRegName(MI->getOperand(0).getReg());
1187 break;
1188 CASE_AVX512_INS_COMMON(BROADCASTF32X2, Z256, r)
1189 CASE_AVX512_INS_COMMON(BROADCASTI32X2, Z256, r)
1190 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
1191 LLVM_FALLTHROUGH;
1192 CASE_AVX512_INS_COMMON(BROADCASTF32X2, Z256, m)
1193 CASE_AVX512_INS_COMMON(BROADCASTI32X2, Z256, m)
1194 DecodeSubVectorBroadcast(8, 2, ShuffleMask);
1195 DestName = getRegName(MI->getOperand(0).getReg());
1196 break;
1197 CASE_AVX512_INS_COMMON(BROADCASTF32X2, Z, r)
1198 CASE_AVX512_INS_COMMON(BROADCASTI32X2, Z, r)
1199 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
1200 LLVM_FALLTHROUGH;
1201 CASE_AVX512_INS_COMMON(BROADCASTF32X2, Z, m)
1202 CASE_AVX512_INS_COMMON(BROADCASTI32X2, Z, m)
1203 DecodeSubVectorBroadcast(16, 2, ShuffleMask);
1204 DestName = getRegName(MI->getOperand(0).getReg());
1205 break;
1206
1207 CASE_PMOVZX(PMOVZXBW, r)
1208 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
1209 LLVM_FALLTHROUGH;
1210 CASE_PMOVZX(PMOVZXBW, m)
1211 DecodeZeroExtendMask(8, 16, getRegOperandNumElts(MI, 16, 0), false,
1212 ShuffleMask);
1213 DestName = getRegName(MI->getOperand(0).getReg());
1214 break;
1215
1216 CASE_PMOVZX(PMOVZXBD, r)
1217 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
1218 LLVM_FALLTHROUGH;
1219 CASE_PMOVZX(PMOVZXBD, m)
1220 DecodeZeroExtendMask(8, 32, getRegOperandNumElts(MI, 32, 0), false,
1221 ShuffleMask);
1222 DestName = getRegName(MI->getOperand(0).getReg());
1223 break;
1224
1225 CASE_PMOVZX(PMOVZXBQ, r)
1226 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
1227 LLVM_FALLTHROUGH;
1228 CASE_PMOVZX(PMOVZXBQ, m)
1229 DecodeZeroExtendMask(8, 64, getRegOperandNumElts(MI, 64, 0), false,
1230 ShuffleMask);
1231 DestName = getRegName(MI->getOperand(0).getReg());
1232 break;
1233
1234 CASE_PMOVZX(PMOVZXWD, r)
1235 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
1236 LLVM_FALLTHROUGH;
1237 CASE_PMOVZX(PMOVZXWD, m)
1238 DecodeZeroExtendMask(16, 32, getRegOperandNumElts(MI, 32, 0), false,
1239 ShuffleMask);
1240 DestName = getRegName(MI->getOperand(0).getReg());
1241 break;
1242
1243 CASE_PMOVZX(PMOVZXWQ, r)
1244 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
1245 LLVM_FALLTHROUGH;
1246 CASE_PMOVZX(PMOVZXWQ, m)
1247 DecodeZeroExtendMask(16, 64, getRegOperandNumElts(MI, 64, 0), false,
1248 ShuffleMask);
1249 DestName = getRegName(MI->getOperand(0).getReg());
1250 break;
1251
1252 CASE_PMOVZX(PMOVZXDQ, r)
1253 Src1Name = getRegName(MI->getOperand(NumOperands - 1).getReg());
1254 LLVM_FALLTHROUGH;
1255 CASE_PMOVZX(PMOVZXDQ, m)
1256 DecodeZeroExtendMask(32, 64, getRegOperandNumElts(MI, 64, 0), false,
1257 ShuffleMask);
1258 DestName = getRegName(MI->getOperand(0).getReg());
1259 break;
1260 }
1261
1262 // The only comments we decode are shuffles, so give up if we were unable to
1263 // decode a shuffle mask.
1264 if (ShuffleMask.empty())
1265 return false;
1266
1267 if (!DestName) DestName = Src1Name;
1268 if (DestName) {
1269 OS << DestName;
1270 printMasking(OS, MI, MCII);
1271 } else
1272 OS << "mem";
1273
1274 OS << " = ";
1275
1276 // If the two sources are the same, canonicalize the input elements to be
1277 // from the first src so that we get larger element spans.
1278 if (Src1Name == Src2Name) {
1279 for (unsigned i = 0, e = ShuffleMask.size(); i != e; ++i) {
1280 if ((int)ShuffleMask[i] >= 0 && // Not sentinel.
1281 ShuffleMask[i] >= (int)e) // From second mask.
1282 ShuffleMask[i] -= e;
1283 }
1284 }
1285
1286 // The shuffle mask specifies which elements of the src1/src2 fill in the
1287 // destination, with a few sentinel values. Loop through and print them
1288 // out.
1289 for (unsigned i = 0, e = ShuffleMask.size(); i != e; ++i) {
1290 if (i != 0)
1291 OS << ',';
1292 if (ShuffleMask[i] == SM_SentinelZero) {
1293 OS << "zero";
1294 continue;
1295 }
1296
1297 // Otherwise, it must come from src1 or src2. Print the span of elements
1298 // that comes from this src.
1299 bool isSrc1 = ShuffleMask[i] < (int)ShuffleMask.size();
1300 const char *SrcName = isSrc1 ? Src1Name : Src2Name;
1301 OS << (SrcName ? SrcName : "mem") << '[';
1302 bool IsFirst = true;
1303 while (i != e && (int)ShuffleMask[i] != SM_SentinelZero &&
1304 (ShuffleMask[i] < (int)ShuffleMask.size()) == isSrc1) {
1305 if (!IsFirst)
1306 OS << ',';
1307 else
1308 IsFirst = false;
1309 if (ShuffleMask[i] == SM_SentinelUndef)
1310 OS << "u";
1311 else
1312 OS << ShuffleMask[i] % ShuffleMask.size();
1313 ++i;
1314 }
1315 OS << ']';
1316 --i; // For loop increments element #.
1317 }
1318 OS << '\n';
1319
1320 // We successfully added a comment to this instruction.
1321 return true;
1322 }
1323