1 //===-- PPCAsmPrinter.cpp - Print machine instrs to PowerPC assembly --------=//
3 // The LLVM Compiler Infrastructure
5 // This file was developed by the LLVM research group and is distributed under
6 // the University of Illinois Open Source License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file contains a printer that converts from our internal representation
11 // of machine-dependent LLVM code to PowerPC assembly language. This printer is
12 // the output mechanism used by `llc'.
14 // Documentation at http://developer.apple.com/documentation/DeveloperTools/
15 // Reference/Assembler/ASMIntroduction/chapter_1_section_1.html
17 //===----------------------------------------------------------------------===//
19 #define DEBUG_TYPE "asmprinter"
21 #include "PPCTargetMachine.h"
22 #include "PPCSubtarget.h"
23 #include "llvm/Constants.h"
24 #include "llvm/DerivedTypes.h"
25 #include "llvm/Module.h"
26 #include "llvm/Assembly/Writer.h"
27 #include "llvm/CodeGen/AsmPrinter.h"
28 #include "llvm/CodeGen/MachineConstantPool.h"
29 #include "llvm/CodeGen/MachineFunctionPass.h"
30 #include "llvm/CodeGen/MachineInstr.h"
31 #include "llvm/CodeGen/ValueTypes.h"
32 #include "llvm/Support/Mangler.h"
33 #include "llvm/Support/MathExtras.h"
34 #include "llvm/Support/CommandLine.h"
35 #include "llvm/Support/Debug.h"
36 #include "llvm/Target/MRegisterInfo.h"
37 #include "llvm/Target/TargetInstrInfo.h"
38 #include "llvm/ADT/Statistic.h"
39 #include "llvm/ADT/StringExtras.h"
44 Statistic<> EmittedInsts("asm-printer", "Number of machine instrs printed");
46 struct PPCAsmPrinter : public AsmPrinter {
47 std::set<std::string> FnStubs, GVStubs, LinkOnceStubs;
49 PPCAsmPrinter(std::ostream &O, TargetMachine &TM)
50 : AsmPrinter(O, TM), LabelNumber(0) {}
52 /// Unique incrementer for label values for referencing Global values.
56 virtual const char *getPassName() const {
57 return "PowerPC Assembly Printer";
60 PPCTargetMachine &getTM() {
61 return static_cast<PPCTargetMachine&>(TM);
64 unsigned enumRegToMachineReg(unsigned enumReg) {
66 default: assert(0 && "Unhandled register!"); break;
67 case PPC::CR0: return 0;
68 case PPC::CR1: return 1;
69 case PPC::CR2: return 2;
70 case PPC::CR3: return 3;
71 case PPC::CR4: return 4;
72 case PPC::CR5: return 5;
73 case PPC::CR6: return 6;
74 case PPC::CR7: return 7;
79 /// printInstruction - This method is automatically generated by tablegen
80 /// from the instruction set description. This method returns true if the
81 /// machine instruction was sufficiently described to print it, otherwise it
83 bool printInstruction(const MachineInstr *MI);
85 void printMachineInstruction(const MachineInstr *MI);
86 void printOp(const MachineOperand &MO, bool IsCallOp = false);
88 void printOperand(const MachineInstr *MI, unsigned OpNo, MVT::ValueType VT){
89 const MachineOperand &MO = MI->getOperand(OpNo);
90 if (MO.getType() == MachineOperand::MO_MachineRegister) {
91 assert(MRegisterInfo::isPhysicalRegister(MO.getReg())&&"Not physreg??");
92 O << TM.getRegisterInfo()->get(MO.getReg()).Name;
93 } else if (MO.isImmediate()) {
94 O << MO.getImmedValue();
100 void printU5ImmOperand(const MachineInstr *MI, unsigned OpNo,
102 unsigned char value = MI->getOperand(OpNo).getImmedValue();
103 assert(value <= 31 && "Invalid u5imm argument!");
104 O << (unsigned int)value;
106 void printU6ImmOperand(const MachineInstr *MI, unsigned OpNo,
108 unsigned char value = MI->getOperand(OpNo).getImmedValue();
109 assert(value <= 63 && "Invalid u6imm argument!");
110 O << (unsigned int)value;
112 void printS16ImmOperand(const MachineInstr *MI, unsigned OpNo,
114 O << (short)MI->getOperand(OpNo).getImmedValue();
116 void printU16ImmOperand(const MachineInstr *MI, unsigned OpNo,
118 O << (unsigned short)MI->getOperand(OpNo).getImmedValue();
120 void printS16X4ImmOperand(const MachineInstr *MI, unsigned OpNo,
122 O << (short)MI->getOperand(OpNo).getImmedValue()*4;
124 void printBranchOperand(const MachineInstr *MI, unsigned OpNo,
126 // Branches can take an immediate operand. This is used by the branch
127 // selection pass to print $+8, an eight byte displacement from the PC.
128 if (MI->getOperand(OpNo).isImmediate()) {
129 O << "$+" << MI->getOperand(OpNo).getImmedValue();
131 printOp(MI->getOperand(OpNo),
132 TM.getInstrInfo()->isCall(MI->getOpcode()));
135 void printPICLabel(const MachineInstr *MI, unsigned OpNo,
137 // FIXME: should probably be converted to cout.width and cout.fill
138 O << "\"L0000" << LabelNumber << "$pb\"\n";
139 O << "\"L0000" << LabelNumber << "$pb\":";
141 void printSymbolHi(const MachineInstr *MI, unsigned OpNo,
143 if (MI->getOperand(OpNo).isImmediate()) {
144 printS16ImmOperand(MI, OpNo, VT);
147 printOp(MI->getOperand(OpNo));
149 O << "-\"L0000" << LabelNumber << "$pb\")";
154 void printSymbolLo(const MachineInstr *MI, unsigned OpNo,
156 if (MI->getOperand(OpNo).isImmediate()) {
157 printS16ImmOperand(MI, OpNo, VT);
160 printOp(MI->getOperand(OpNo));
162 O << "-\"L0000" << LabelNumber << "$pb\")";
167 void printcrbitm(const MachineInstr *MI, unsigned OpNo,
169 unsigned CCReg = MI->getOperand(OpNo).getReg();
170 unsigned RegNo = enumRegToMachineReg(CCReg);
171 O << (0x80 >> RegNo);
174 virtual void printConstantPool(MachineConstantPool *MCP) = 0;
175 virtual bool runOnMachineFunction(MachineFunction &F) = 0;
176 virtual bool doFinalization(Module &M) = 0;
179 /// DarwinAsmPrinter - PowerPC assembly printer, customized for Darwin/Mac OS
182 struct DarwinAsmPrinter : public PPCAsmPrinter {
184 DarwinAsmPrinter(std::ostream &O, TargetMachine &TM)
185 : PPCAsmPrinter(O, TM) {
188 ZeroDirective = "\t.space\t"; // ".space N" emits N zeros.
189 Data64bitsDirective = 0; // we can't emit a 64-bit unit
190 AlignmentIsInBytes = false; // Alignment is by power of 2.
193 virtual const char *getPassName() const {
194 return "Darwin PPC Assembly Printer";
197 void printConstantPool(MachineConstantPool *MCP);
198 bool runOnMachineFunction(MachineFunction &F);
199 bool doInitialization(Module &M);
200 bool doFinalization(Module &M);
203 /// AIXAsmPrinter - PowerPC assembly printer, customized for AIX
205 struct AIXAsmPrinter : public PPCAsmPrinter {
206 /// Map for labels corresponding to global variables
208 std::map<const GlobalVariable*,std::string> GVToLabelMap;
210 AIXAsmPrinter(std::ostream &O, TargetMachine &TM)
211 : PPCAsmPrinter(O, TM) {
214 ZeroDirective = "\t.space\t"; // ".space N" emits N zeros.
215 Data64bitsDirective = 0; // we can't emit a 64-bit unit
216 AlignmentIsInBytes = false; // Alignment is by power of 2.
219 virtual const char *getPassName() const {
220 return "AIX PPC Assembly Printer";
223 void printConstantPool(MachineConstantPool *MCP);
224 bool runOnMachineFunction(MachineFunction &F);
225 bool doInitialization(Module &M);
226 bool doFinalization(Module &M);
228 } // end of anonymous namespace
230 // SwitchSection - Switch to the specified section of the executable if we are
231 // not already in it!
233 static void SwitchSection(std::ostream &OS, std::string &CurSection,
234 const char *NewSection) {
235 if (CurSection != NewSection) {
236 CurSection = NewSection;
237 if (!CurSection.empty())
238 OS << "\t" << NewSection << "\n";
242 /// createDarwinAsmPrinterPass - Returns a pass that prints the PPC assembly
243 /// code for a MachineFunction to the given output stream, in a format that the
244 /// Darwin assembler can deal with.
246 FunctionPass *llvm::createDarwinAsmPrinter(std::ostream &o, TargetMachine &tm) {
247 return new DarwinAsmPrinter(o, tm);
250 /// createAIXAsmPrinterPass - Returns a pass that prints the PPC assembly code
251 /// for a MachineFunction to the given output stream, in a format that the
252 /// AIX 5L assembler can deal with.
254 FunctionPass *llvm::createAIXAsmPrinter(std::ostream &o, TargetMachine &tm) {
255 return new AIXAsmPrinter(o, tm);
258 // Include the auto-generated portion of the assembly writer
259 #include "PPCGenAsmWriter.inc"
261 void PPCAsmPrinter::printOp(const MachineOperand &MO, bool IsCallOp) {
262 const MRegisterInfo &RI = *TM.getRegisterInfo();
265 switch (MO.getType()) {
266 case MachineOperand::MO_VirtualRegister:
267 if (Value *V = MO.getVRegValueOrNull()) {
268 O << "<" << V->getName() << ">";
272 case MachineOperand::MO_MachineRegister:
273 case MachineOperand::MO_CCRegister:
274 O << RI.get(MO.getReg()).Name;
277 case MachineOperand::MO_SignExtendedImmed:
278 case MachineOperand::MO_UnextendedImmed:
279 std::cerr << "printOp() does not handle immediate values\n";
283 case MachineOperand::MO_PCRelativeDisp:
284 std::cerr << "Shouldn't use addPCDisp() when building PPC MachineInstrs";
288 case MachineOperand::MO_MachineBasicBlock: {
289 MachineBasicBlock *MBBOp = MO.getMachineBasicBlock();
290 O << "LBB" << Mang->getValueName(MBBOp->getParent()->getFunction())
291 << "_" << MBBOp->getNumber() << "\t; "
292 << MBBOp->getBasicBlock()->getName();
296 case MachineOperand::MO_ConstantPoolIndex:
297 O << "LCPI" << CurrentFnName << "_" << MO.getConstantPoolIndex();
300 case MachineOperand::MO_ExternalSymbol:
302 std::string Name(GlobalPrefix); Name += MO.getSymbolName();
303 FnStubs.insert(Name);
304 O << "L" << Name << "$stub";
307 O << GlobalPrefix << MO.getSymbolName();
310 case MachineOperand::MO_GlobalAddress: {
311 GlobalValue *GV = MO.getGlobal();
312 std::string Name = Mang->getValueName(GV);
314 // Dynamically-resolved functions need a stub for the function. Be
315 // wary however not to output $stub for external functions whose addresses
316 // are taken. Those should be emitted as $non_lazy_ptr below.
317 Function *F = dyn_cast<Function>(GV);
318 if (F && IsCallOp && F->isExternal()) {
319 FnStubs.insert(Name);
320 O << "L" << Name << "$stub";
324 // External or weakly linked global variables need non-lazily-resolved stubs
325 if ((GV->isExternal() || GV->hasWeakLinkage() || GV->hasLinkOnceLinkage())){
326 if (GV->hasLinkOnceLinkage())
327 LinkOnceStubs.insert(Name);
329 GVStubs.insert(Name);
330 O << "L" << Name << "$non_lazy_ptr";
334 O << Mang->getValueName(GV);
339 O << "<unknown operand type: " << MO.getType() << ">";
344 /// printMachineInstruction -- Print out a single PowerPC MI in Darwin syntax to
345 /// the current output stream.
347 void PPCAsmPrinter::printMachineInstruction(const MachineInstr *MI) {
350 // Check for slwi/srwi mnemonics.
351 if (MI->getOpcode() == PPC::RLWINM) {
352 bool FoundMnemonic = false;
353 unsigned char SH = MI->getOperand(2).getImmedValue();
354 unsigned char MB = MI->getOperand(3).getImmedValue();
355 unsigned char ME = MI->getOperand(4).getImmedValue();
356 if (SH <= 31 && MB == 0 && ME == (31-SH)) {
357 O << "slwi "; FoundMnemonic = true;
359 if (SH <= 31 && MB == (32-SH) && ME == 31) {
360 O << "srwi "; FoundMnemonic = true;
364 printOperand(MI, 0, MVT::i64);
366 printOperand(MI, 1, MVT::i64);
367 O << ", " << (unsigned int)SH << "\n";
372 if (printInstruction(MI))
373 return; // Printer was automatically generated
375 assert(0 && "Unhandled instruction in asm writer!");
380 /// runOnMachineFunction - This uses the printMachineInstruction()
381 /// method to print assembly for each instruction.
383 bool DarwinAsmPrinter::runOnMachineFunction(MachineFunction &MF) {
384 setupMachineFunction(MF);
387 // Print out constants referenced by the function
388 printConstantPool(MF.getConstantPool());
390 // Print out labels for the function.
393 if (!MF.getFunction()->hasInternalLinkage())
394 O << "\t.globl\t" << CurrentFnName << "\n";
395 O << CurrentFnName << ":\n";
397 // Print out code for the function.
398 for (MachineFunction::const_iterator I = MF.begin(), E = MF.end();
400 // Print a label for the basic block.
401 if (I != MF.begin()) {
402 O << "LBB" << CurrentFnName << "_" << I->getNumber() << ":\t";
403 if (!I->getBasicBlock()->getName().empty())
404 O << CommentString << " " << I->getBasicBlock()->getName();
407 for (MachineBasicBlock::const_iterator II = I->begin(), E = I->end();
409 // Print the assembly for the instruction.
411 printMachineInstruction(II);
416 // We didn't modify anything.
420 /// printConstantPool - Print to the current output stream assembly
421 /// representations of the constants in the constant pool MCP. This is
422 /// used to print out constants which have been "spilled to memory" by
423 /// the code generator.
425 void DarwinAsmPrinter::printConstantPool(MachineConstantPool *MCP) {
426 const std::vector<Constant*> &CP = MCP->getConstants();
427 const TargetData &TD = TM.getTargetData();
429 if (CP.empty()) return;
431 for (unsigned i = 0, e = CP.size(); i != e; ++i) {
433 // FIXME: force doubles to be naturally aligned. We should handle this
434 // more correctly in the future.
435 if (Type::DoubleTy == CP[i]->getType())
438 emitAlignment(TD.getTypeAlignmentShift(CP[i]->getType()));
439 O << "LCPI" << CurrentFnName << "_" << i << ":\t\t\t\t\t" << CommentString
441 emitGlobalConstant(CP[i]);
445 bool DarwinAsmPrinter::doInitialization(Module &M) {
446 if (TM.getSubtarget<PPCSubtarget>().isGigaProcessor())
447 O << "\t.machine ppc970\n";
448 AsmPrinter::doInitialization(M);
452 bool DarwinAsmPrinter::doFinalization(Module &M) {
453 const TargetData &TD = TM.getTargetData();
454 std::string CurSection;
456 // Print out module-level global variables here.
457 for (Module::const_global_iterator I = M.global_begin(), E = M.global_end(); I != E; ++I)
458 if (I->hasInitializer()) { // External global require no code
460 std::string name = Mang->getValueName(I);
461 Constant *C = I->getInitializer();
462 unsigned Size = TD.getTypeSize(C->getType());
463 unsigned Align = TD.getTypeAlignmentShift(C->getType());
465 if (C->isNullValue() && /* FIXME: Verify correct */
466 (I->hasInternalLinkage() || I->hasWeakLinkage() ||
467 I->hasLinkOnceLinkage())) {
468 SwitchSection(O, CurSection, ".data");
469 if (Size == 0) Size = 1; // .comm Foo, 0 is undefined, avoid it.
470 if (I->hasInternalLinkage())
471 O << ".lcomm " << name << "," << Size << "," << Align;
473 O << ".comm " << name << "," << Size;
474 O << "\t\t; '" << I->getName() << "'\n";
476 switch (I->getLinkage()) {
477 case GlobalValue::LinkOnceLinkage:
478 O << ".section __TEXT,__textcoal_nt,coalesced,no_toc\n"
479 << ".weak_definition " << name << '\n'
480 << ".private_extern " << name << '\n'
481 << ".section __DATA,__datacoal_nt,coalesced,no_toc\n";
482 LinkOnceStubs.insert(name);
484 case GlobalValue::WeakLinkage:
485 O << ".weak_definition " << name << '\n'
486 << ".private_extern " << name << '\n';
488 case GlobalValue::AppendingLinkage:
489 // FIXME: appending linkage variables should go into a section of
490 // their name or something. For now, just emit them as external.
491 case GlobalValue::ExternalLinkage:
492 // If external or appending, declare as a global symbol
493 O << "\t.globl " << name << "\n";
495 case GlobalValue::InternalLinkage:
496 SwitchSection(O, CurSection, ".data");
498 case GlobalValue::GhostLinkage:
499 std::cerr << "Error: unmaterialized (GhostLinkage) function in asm!";
503 emitAlignment(Align);
504 O << name << ":\t\t\t\t; '" << I->getName() << "'\n";
505 emitGlobalConstant(C);
509 // Output stubs for dynamically-linked functions
510 for (std::set<std::string>::iterator i = FnStubs.begin(), e = FnStubs.end();
515 O << ".section __TEXT,__picsymbolstub1,symbol_stubs,pure_instructions,32\n";
517 O << "L" << *i << "$stub:\n";
518 O << "\t.indirect_symbol " << *i << "\n";
520 O << "\tbcl 20,31,L0$" << *i << "\n";
521 O << "L0$" << *i << ":\n";
523 O << "\taddis r11,r11,ha16(L" << *i << "$lazy_ptr-L0$" << *i << ")\n";
525 O << "\tlwzu r12,lo16(L" << *i << "$lazy_ptr-L0$" << *i << ")(r11)\n";
526 O << "\tmtctr r12\n";
529 O << ".lazy_symbol_pointer\n";
530 O << "L" << *i << "$lazy_ptr:\n";
531 O << "\t.indirect_symbol " << *i << "\n";
532 O << "\t.long dyld_stub_binding_helper\n";
534 O << "\t.section __TEXT,__symbol_stub1,symbol_stubs,pure_instructions,16\n";
536 O << "L" << *i << "$stub:\n";
537 O << "\t.indirect_symbol " << *i << "\n";
538 O << "\tlis r11,ha16(L" << *i << "$lazy_ptr)\n";
539 O << "\tlwzu r12,lo16(L" << *i << "$lazy_ptr)(r11)\n";
540 O << "\tmtctr r12\n";
542 O << "\t.lazy_symbol_pointer\n";
543 O << "L" << *i << "$lazy_ptr:\n";
544 O << "\t.indirect_symbol " << *i << "\n";
545 O << "\t.long dyld_stub_binding_helper\n";
551 // Output stubs for external global variables
552 if (GVStubs.begin() != GVStubs.end())
553 O << ".data\n.non_lazy_symbol_pointer\n";
554 for (std::set<std::string>::iterator i = GVStubs.begin(), e = GVStubs.end();
556 O << "L" << *i << "$non_lazy_ptr:\n";
557 O << "\t.indirect_symbol " << *i << "\n";
561 // Output stubs for link-once variables
562 if (LinkOnceStubs.begin() != LinkOnceStubs.end())
563 O << ".data\n.align 2\n";
564 for (std::set<std::string>::iterator i = LinkOnceStubs.begin(),
565 e = LinkOnceStubs.end(); i != e; ++i) {
566 O << "L" << *i << "$non_lazy_ptr:\n"
567 << "\t.long\t" << *i << '\n';
570 AsmPrinter::doFinalization(M);
571 return false; // success
574 /// runOnMachineFunction - This uses the printMachineInstruction()
575 /// method to print assembly for each instruction.
577 bool AIXAsmPrinter::runOnMachineFunction(MachineFunction &MF) {
578 CurrentFnName = MF.getFunction()->getName();
580 // Print out constants referenced by the function
581 printConstantPool(MF.getConstantPool());
583 // Print out header for the function.
584 O << "\t.csect .text[PR]\n"
586 << "\t.globl " << CurrentFnName << '\n'
587 << "\t.globl ." << CurrentFnName << '\n'
588 << "\t.csect " << CurrentFnName << "[DS],3\n"
589 << CurrentFnName << ":\n"
590 << "\t.llong ." << CurrentFnName << ", TOC[tc0], 0\n"
591 << "\t.csect .text[PR]\n"
592 << '.' << CurrentFnName << ":\n";
594 // Print out code for the function.
595 for (MachineFunction::const_iterator I = MF.begin(), E = MF.end();
597 // Print a label for the basic block.
598 O << "LBB" << CurrentFnName << "_" << I->getNumber() << ":\t# "
599 << I->getBasicBlock()->getName() << "\n";
600 for (MachineBasicBlock::const_iterator II = I->begin(), E = I->end();
602 // Print the assembly for the instruction.
604 printMachineInstruction(II);
609 O << "LT.." << CurrentFnName << ":\n"
611 << "\t.byte 0,0,32,65,128,0,0,0\n"
612 << "\t.long LT.." << CurrentFnName << "-." << CurrentFnName << '\n'
614 << "\t.byte \"" << CurrentFnName << "\"\n"
617 // We didn't modify anything.
621 /// printConstantPool - Print to the current output stream assembly
622 /// representations of the constants in the constant pool MCP. This is
623 /// used to print out constants which have been "spilled to memory" by
624 /// the code generator.
626 void AIXAsmPrinter::printConstantPool(MachineConstantPool *MCP) {
627 const std::vector<Constant*> &CP = MCP->getConstants();
628 const TargetData &TD = TM.getTargetData();
630 if (CP.empty()) return;
632 for (unsigned i = 0, e = CP.size(); i != e; ++i) {
634 O << "\t.align " << (unsigned)TD.getTypeAlignment(CP[i]->getType())
636 O << "LCPI" << CurrentFnName << "_" << i << ":\t\t\t\t\t;"
638 emitGlobalConstant(CP[i]);
642 bool AIXAsmPrinter::doInitialization(Module &M) {
643 const TargetData &TD = TM.getTargetData();
644 std::string CurSection;
646 O << "\t.machine \"ppc64\"\n"
648 << "\t.csect .text[PR]\n";
650 // Print out module-level global variables
651 for (Module::const_global_iterator I = M.global_begin(), E = M.global_end();
653 if (!I->hasInitializer())
656 std::string Name = I->getName();
657 Constant *C = I->getInitializer();
658 // N.B.: We are defaulting to writable strings
659 if (I->hasExternalLinkage()) {
660 O << "\t.globl " << Name << '\n'
661 << "\t.csect .data[RW],3\n";
663 O << "\t.csect _global.rw_c[RW],3\n";
666 emitGlobalConstant(C);
669 // Output labels for globals
670 if (M.global_begin() != M.global_end()) O << "\t.toc\n";
671 for (Module::const_global_iterator I = M.global_begin(), E = M.global_end();
673 const GlobalVariable *GV = I;
674 // Do not output labels for unused variables
675 if (GV->isExternal() && GV->use_begin() == GV->use_end())
678 std::string Name = GV->getName();
679 std::string Label = "LC.." + utostr(LabelNumber++);
680 GVToLabelMap[GV] = Label;
682 << "\t.tc " << Name << "[TC]," << Name;
683 if (GV->isExternal()) O << "[RW]";
687 Mang = new Mangler(M, ".");
688 return false; // success
691 bool AIXAsmPrinter::doFinalization(Module &M) {
692 const TargetData &TD = TM.getTargetData();
693 // Print out module-level global variables
694 for (Module::const_global_iterator I = M.global_begin(), E = M.global_end();
696 if (I->hasInitializer() || I->hasExternalLinkage())
699 std::string Name = I->getName();
700 if (I->hasInternalLinkage()) {
701 O << "\t.lcomm " << Name << ",16,_global.bss_c";
703 O << "\t.comm " << Name << "," << TD.getTypeSize(I->getType())
704 << "," << Log2_32((unsigned)TD.getTypeAlignment(I->getType()));
707 WriteAsOperand(O, I, false, true, &M);
711 O << "_section_.text:\n"
712 << "\t.csect .data[RW],3\n"
713 << "\t.llong _section_.text\n";
716 return false; // success