document SectionFlags::Named better and make it more easily greppable by
[oota-llvm.git] / lib / CodeGen / AsmPrinter / AsmPrinter.cpp
1 //===-- AsmPrinter.cpp - Common AsmPrinter code ---------------------------===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file implements the AsmPrinter class.
11 //
12 //===----------------------------------------------------------------------===//
13
14 #include "llvm/CodeGen/AsmPrinter.h"
15 #include "llvm/Assembly/Writer.h"
16 #include "llvm/DerivedTypes.h"
17 #include "llvm/Constants.h"
18 #include "llvm/Module.h"
19 #include "llvm/CodeGen/GCMetadataPrinter.h"
20 #include "llvm/CodeGen/MachineConstantPool.h"
21 #include "llvm/CodeGen/MachineJumpTableInfo.h"
22 #include "llvm/CodeGen/MachineModuleInfo.h"
23 #include "llvm/CodeGen/DwarfWriter.h"
24 #include "llvm/Analysis/DebugInfo.h"
25 #include "llvm/MC/MCInst.h"
26 #include "llvm/Support/CommandLine.h"
27 #include "llvm/Support/ErrorHandling.h"
28 #include "llvm/Support/FormattedStream.h"
29 #include "llvm/Support/Mangler.h"
30 #include "llvm/Target/TargetAsmInfo.h"
31 #include "llvm/Target/TargetData.h"
32 #include "llvm/Target/TargetLowering.h"
33 #include "llvm/Target/TargetOptions.h"
34 #include "llvm/Target/TargetRegisterInfo.h"
35 #include "llvm/ADT/SmallPtrSet.h"
36 #include "llvm/ADT/SmallString.h"
37 #include "llvm/ADT/StringExtras.h"
38 #include <cerrno>
39 using namespace llvm;
40
41 static cl::opt<cl::boolOrDefault>
42 AsmVerbose("asm-verbose", cl::desc("Add comments to directives."),
43            cl::init(cl::BOU_UNSET));
44
45 char AsmPrinter::ID = 0;
46 AsmPrinter::AsmPrinter(formatted_raw_ostream &o, TargetMachine &tm,
47                        const TargetAsmInfo *T, bool VDef)
48   : MachineFunctionPass(&ID), FunctionNumber(0), O(o),
49     TM(tm), TAI(T), TRI(tm.getRegisterInfo()),
50     IsInTextSection(false), LastMI(0), LastFn(0), Counter(~0U),
51     PrevDLT(0, ~0U, ~0U) {
52   DW = 0; MMI = 0;
53   switch (AsmVerbose) {
54   case cl::BOU_UNSET: VerboseAsm = VDef;  break;
55   case cl::BOU_TRUE:  VerboseAsm = true;  break;
56   case cl::BOU_FALSE: VerboseAsm = false; break;
57   }
58 }
59
60 AsmPrinter::~AsmPrinter() {
61   for (gcp_iterator I = GCMetadataPrinters.begin(),
62                     E = GCMetadataPrinters.end(); I != E; ++I)
63     delete I->second;
64 }
65
66 /// SwitchToTextSection - Switch to the specified text section of the executable
67 /// if we are not already in it!
68 ///
69 void AsmPrinter::SwitchToTextSection(const char *NewSection,
70                                      const GlobalValue *GV) {
71   std::string NS;
72   if (GV && GV->hasSection())
73     NS = TAI->getSwitchToSectionDirective() + GV->getSection();
74   else
75     NS = NewSection;
76   
77   // If we're already in this section, we're done.
78   if (CurrentSection == NS) return;
79
80   // Close the current section, if applicable.
81   if (TAI->getSectionEndDirectiveSuffix() && !CurrentSection.empty())
82     O << CurrentSection << TAI->getSectionEndDirectiveSuffix() << '\n';
83
84   CurrentSection = NS;
85
86   if (!CurrentSection.empty())
87     O << CurrentSection << TAI->getTextSectionStartSuffix() << '\n';
88
89   IsInTextSection = true;
90 }
91
92 /// SwitchToDataSection - Switch to the specified data section of the executable
93 /// if we are not already in it!
94 ///
95 void AsmPrinter::SwitchToDataSection(const char *NewSection,
96                                      const GlobalValue *GV) {
97   std::string NS;
98   if (GV && GV->hasSection())
99     NS = TAI->getSwitchToSectionDirective() + GV->getSection();
100   else
101     NS = NewSection;
102   
103   // If we're already in this section, we're done.
104   if (CurrentSection == NS) return;
105
106   // Close the current section, if applicable.
107   if (TAI->getSectionEndDirectiveSuffix() && !CurrentSection.empty())
108     O << CurrentSection << TAI->getSectionEndDirectiveSuffix() << '\n';
109
110   CurrentSection = NS;
111   
112   if (!CurrentSection.empty())
113     O << CurrentSection << TAI->getDataSectionStartSuffix() << '\n';
114
115   IsInTextSection = false;
116 }
117
118 /// SwitchToSection - Switch to the specified section of the executable if we
119 /// are not already in it!
120 void AsmPrinter::SwitchToSection(const Section* NS) {
121   const std::string& NewSection = NS->getName();
122
123   // If we're already in this section, we're done.
124   if (CurrentSection == NewSection) return;
125
126   // Close the current section, if applicable.
127   if (TAI->getSectionEndDirectiveSuffix() && !CurrentSection.empty())
128     O << CurrentSection << TAI->getSectionEndDirectiveSuffix() << '\n';
129
130   // FIXME: Make CurrentSection a Section* in the future
131   CurrentSection = NewSection;
132   CurrentSection_ = NS;
133
134   if (!CurrentSection.empty()) {
135     // If section is named we need to switch into it via special '.section'
136     // directive and also append funky flags. Otherwise - section name is just
137     // some magic assembler directive.
138     if (NS->hasFlag(SectionFlags::Named))
139       O << TAI->getSwitchToSectionDirective()
140         << CurrentSection
141         << TAI->getSectionFlags(NS->getFlags());
142     else
143       O << CurrentSection;
144     O << TAI->getDataSectionStartSuffix() << '\n';
145   }
146
147   IsInTextSection = (NS->getFlags() & SectionFlags::Code);
148 }
149
150 void AsmPrinter::getAnalysisUsage(AnalysisUsage &AU) const {
151   MachineFunctionPass::getAnalysisUsage(AU);
152   AU.addRequired<GCModuleInfo>();
153 }
154
155 bool AsmPrinter::doInitialization(Module &M) {
156   Mang = new Mangler(M, TAI->getGlobalPrefix(), TAI->getPrivateGlobalPrefix(),
157                      TAI->getLinkerPrivateGlobalPrefix());
158   
159   if (TAI->doesAllowQuotesInName())
160     Mang->setUseQuotes(true);
161   
162   GCModuleInfo *MI = getAnalysisIfAvailable<GCModuleInfo>();
163   assert(MI && "AsmPrinter didn't require GCModuleInfo?");
164
165   if (TAI->hasSingleParameterDotFile()) {
166     /* Very minimal debug info. It is ignored if we emit actual
167        debug info. If we don't, this at helps the user find where
168        a function came from. */
169     O << "\t.file\t\"" << M.getModuleIdentifier() << "\"\n";
170   }
171
172   for (GCModuleInfo::iterator I = MI->begin(), E = MI->end(); I != E; ++I)
173     if (GCMetadataPrinter *MP = GetOrCreateGCPrinter(*I))
174       MP->beginAssembly(O, *this, *TAI);
175   
176   if (!M.getModuleInlineAsm().empty())
177     O << TAI->getCommentString() << " Start of file scope inline assembly\n"
178       << M.getModuleInlineAsm()
179       << '\n' << TAI->getCommentString()
180       << " End of file scope inline assembly\n";
181
182   SwitchToDataSection("");   // Reset back to no section.
183   
184   if (TAI->doesSupportDebugInformation() ||
185       TAI->doesSupportExceptionHandling()) {
186     MMI = getAnalysisIfAvailable<MachineModuleInfo>();
187     if (MMI)
188       MMI->AnalyzeModule(M);
189     DW = getAnalysisIfAvailable<DwarfWriter>();
190     if (DW)
191       DW->BeginModule(&M, MMI, O, this, TAI);
192   }
193
194   return false;
195 }
196
197 bool AsmPrinter::doFinalization(Module &M) {
198   // Emit global variables.
199   for (Module::const_global_iterator I = M.global_begin(), E = M.global_end();
200        I != E; ++I)
201     PrintGlobalVariable(I);
202   
203   // Emit final debug information.
204   if (TAI->doesSupportDebugInformation() || TAI->doesSupportExceptionHandling())
205     DW->EndModule();
206   
207   // If the target wants to know about weak references, print them all.
208   if (TAI->getWeakRefDirective()) {
209     // FIXME: This is not lazy, it would be nice to only print weak references
210     // to stuff that is actually used.  Note that doing so would require targets
211     // to notice uses in operands (due to constant exprs etc).  This should
212     // happen with the MC stuff eventually.
213     SwitchToDataSection("");
214
215     // Print out module-level global variables here.
216     for (Module::const_global_iterator I = M.global_begin(), E = M.global_end();
217          I != E; ++I) {
218       if (I->hasExternalWeakLinkage())
219         O << TAI->getWeakRefDirective() << Mang->getMangledName(I) << '\n';
220     }
221     
222     for (Module::const_iterator I = M.begin(), E = M.end();
223          I != E; ++I) {
224       if (I->hasExternalWeakLinkage())
225         O << TAI->getWeakRefDirective() << Mang->getMangledName(I) << '\n';
226     }
227   }
228
229   if (TAI->getSetDirective()) {
230     if (!M.alias_empty())
231       SwitchToSection(TAI->getTextSection());
232
233     O << '\n';
234     for (Module::const_alias_iterator I = M.alias_begin(), E = M.alias_end();
235          I != E; ++I) {
236       std::string Name = Mang->getMangledName(I);
237
238       const GlobalValue *GV = cast<GlobalValue>(I->getAliasedGlobal());
239       std::string Target = Mang->getMangledName(GV);
240
241       if (I->hasExternalLinkage() || !TAI->getWeakRefDirective())
242         O << "\t.globl\t" << Name << '\n';
243       else if (I->hasWeakLinkage())
244         O << TAI->getWeakRefDirective() << Name << '\n';
245       else if (!I->hasLocalLinkage())
246         llvm_unreachable("Invalid alias linkage");
247
248       printVisibility(Name, I->getVisibility());
249
250       O << TAI->getSetDirective() << ' ' << Name << ", " << Target << '\n';
251     }
252   }
253
254   GCModuleInfo *MI = getAnalysisIfAvailable<GCModuleInfo>();
255   assert(MI && "AsmPrinter didn't require GCModuleInfo?");
256   for (GCModuleInfo::iterator I = MI->end(), E = MI->begin(); I != E; )
257     if (GCMetadataPrinter *MP = GetOrCreateGCPrinter(*--I))
258       MP->finishAssembly(O, *this, *TAI);
259
260   // If we don't have any trampolines, then we don't require stack memory
261   // to be executable. Some targets have a directive to declare this.
262   Function *InitTrampolineIntrinsic = M.getFunction("llvm.init.trampoline");
263   if (!InitTrampolineIntrinsic || InitTrampolineIntrinsic->use_empty())
264     if (TAI->getNonexecutableStackDirective())
265       O << TAI->getNonexecutableStackDirective() << '\n';
266
267   delete Mang; Mang = 0;
268   DW = 0; MMI = 0;
269   return false;
270 }
271
272 std::string 
273 AsmPrinter::getCurrentFunctionEHName(const MachineFunction *MF) const {
274   assert(MF && "No machine function?");
275   return Mang->getMangledName(MF->getFunction(), ".eh",
276                               TAI->is_EHSymbolPrivate());
277 }
278
279 void AsmPrinter::SetupMachineFunction(MachineFunction &MF) {
280   // What's my mangled name?
281   CurrentFnName = Mang->getMangledName(MF.getFunction());
282   IncrementFunctionNumber();
283 }
284
285 namespace {
286   // SectionCPs - Keep track the alignment, constpool entries per Section.
287   struct SectionCPs {
288     const Section *S;
289     unsigned Alignment;
290     SmallVector<unsigned, 4> CPEs;
291     SectionCPs(const Section *s, unsigned a) : S(s), Alignment(a) {};
292   };
293 }
294
295 /// EmitConstantPool - Print to the current output stream assembly
296 /// representations of the constants in the constant pool MCP. This is
297 /// used to print out constants which have been "spilled to memory" by
298 /// the code generator.
299 ///
300 void AsmPrinter::EmitConstantPool(MachineConstantPool *MCP) {
301   const std::vector<MachineConstantPoolEntry> &CP = MCP->getConstants();
302   if (CP.empty()) return;
303
304   const TargetData &TD = *TM.getTargetData();
305   
306   // Calculate sections for constant pool entries. We collect entries to go into
307   // the same section together to reduce amount of section switch statements.
308   SmallVector<SectionCPs, 4> CPSections;
309   for (unsigned i = 0, e = CP.size(); i != e; ++i) {
310     const MachineConstantPoolEntry &CPE = CP[i];
311     unsigned Align = CPE.getAlignment();
312     uint64_t Size = TD.getTypeAllocSize(CPE.getType());
313     const Section *S =
314       TAI->getSectionForMergableConstant(Size, CPE.getRelocationInfo());
315     
316     // The number of sections are small, just do a linear search from the
317     // last section to the first.
318     bool Found = false;
319     unsigned SecIdx = CPSections.size();
320     while (SecIdx != 0) {
321       if (CPSections[--SecIdx].S == S) {
322         Found = true;
323         break;
324       }
325     }
326     if (!Found) {
327       SecIdx = CPSections.size();
328       CPSections.push_back(SectionCPs(S, Align));
329     }
330
331     if (Align > CPSections[SecIdx].Alignment)
332       CPSections[SecIdx].Alignment = Align;
333     CPSections[SecIdx].CPEs.push_back(i);
334   }
335
336   // Now print stuff into the calculated sections.
337   for (unsigned i = 0, e = CPSections.size(); i != e; ++i) {
338     SwitchToSection(CPSections[i].S);
339     EmitAlignment(Log2_32(CPSections[i].Alignment));
340
341     unsigned Offset = 0;
342     for (unsigned j = 0, ee = CPSections[i].CPEs.size(); j != ee; ++j) {
343       unsigned CPI = CPSections[i].CPEs[j];
344       MachineConstantPoolEntry CPE = CP[CPI];
345
346       // Emit inter-object padding for alignment.
347       unsigned AlignMask = CPE.getAlignment() - 1;
348       unsigned NewOffset = (Offset + AlignMask) & ~AlignMask;
349       EmitZeros(NewOffset - Offset);
350
351       const Type *Ty = CPE.getType();
352       Offset = NewOffset + TM.getTargetData()->getTypeAllocSize(Ty);
353
354       O << TAI->getPrivateGlobalPrefix() << "CPI" << getFunctionNumber() << '_'
355         << CPI << ":\t\t\t\t\t";
356       if (VerboseAsm) {
357         O << TAI->getCommentString() << ' ';
358         WriteTypeSymbolic(O, CPE.getType(), 0);
359       }
360       O << '\n';
361       if (CPE.isMachineConstantPoolEntry())
362         EmitMachineConstantPoolValue(CPE.Val.MachineCPVal);
363       else
364         EmitGlobalConstant(CPE.Val.ConstVal);
365     }
366   }
367 }
368
369 /// EmitJumpTableInfo - Print assembly representations of the jump tables used
370 /// by the current function to the current output stream.  
371 ///
372 void AsmPrinter::EmitJumpTableInfo(MachineJumpTableInfo *MJTI,
373                                    MachineFunction &MF) {
374   const std::vector<MachineJumpTableEntry> &JT = MJTI->getJumpTables();
375   if (JT.empty()) return;
376
377   bool IsPic = TM.getRelocationModel() == Reloc::PIC_;
378   
379   // Pick the directive to use to print the jump table entries, and switch to 
380   // the appropriate section.
381   TargetLowering *LoweringInfo = TM.getTargetLowering();
382
383   const char* JumpTableDataSection = TAI->getJumpTableDataSection();
384   const Function *F = MF.getFunction();
385   unsigned SectionFlags = TAI->SectionFlagsForGlobal(F);
386   bool JTInDiffSection = false;
387   if ((IsPic && !(LoweringInfo && LoweringInfo->usesGlobalOffsetTable())) ||
388       !JumpTableDataSection ||
389       SectionFlags & SectionFlags::Linkonce) {
390     // In PIC mode, we need to emit the jump table to the same section as the
391     // function body itself, otherwise the label differences won't make sense.
392     // We should also do if the section name is NULL or function is declared in
393     // discardable section.
394     SwitchToSection(TAI->SectionForGlobal(F));
395   } else {
396     SwitchToDataSection(JumpTableDataSection);
397     JTInDiffSection = true;
398   }
399   
400   EmitAlignment(Log2_32(MJTI->getAlignment()));
401   
402   for (unsigned i = 0, e = JT.size(); i != e; ++i) {
403     const std::vector<MachineBasicBlock*> &JTBBs = JT[i].MBBs;
404     
405     // If this jump table was deleted, ignore it. 
406     if (JTBBs.empty()) continue;
407
408     // For PIC codegen, if possible we want to use the SetDirective to reduce
409     // the number of relocations the assembler will generate for the jump table.
410     // Set directives are all printed before the jump table itself.
411     SmallPtrSet<MachineBasicBlock*, 16> EmittedSets;
412     if (TAI->getSetDirective() && IsPic)
413       for (unsigned ii = 0, ee = JTBBs.size(); ii != ee; ++ii)
414         if (EmittedSets.insert(JTBBs[ii]))
415           printPICJumpTableSetLabel(i, JTBBs[ii]);
416     
417     // On some targets (e.g. darwin) we want to emit two consequtive labels
418     // before each jump table.  The first label is never referenced, but tells
419     // the assembler and linker the extents of the jump table object.  The
420     // second label is actually referenced by the code.
421     if (JTInDiffSection) {
422       if (const char *JTLabelPrefix = TAI->getJumpTableSpecialLabelPrefix())
423         O << JTLabelPrefix << "JTI" << getFunctionNumber() << '_' << i << ":\n";
424     }
425     
426     O << TAI->getPrivateGlobalPrefix() << "JTI" << getFunctionNumber() 
427       << '_' << i << ":\n";
428     
429     for (unsigned ii = 0, ee = JTBBs.size(); ii != ee; ++ii) {
430       printPICJumpTableEntry(MJTI, JTBBs[ii], i);
431       O << '\n';
432     }
433   }
434 }
435
436 void AsmPrinter::printPICJumpTableEntry(const MachineJumpTableInfo *MJTI,
437                                         const MachineBasicBlock *MBB,
438                                         unsigned uid)  const {
439   bool IsPic = TM.getRelocationModel() == Reloc::PIC_;
440   
441   // Use JumpTableDirective otherwise honor the entry size from the jump table
442   // info.
443   const char *JTEntryDirective = TAI->getJumpTableDirective();
444   bool HadJTEntryDirective = JTEntryDirective != NULL;
445   if (!HadJTEntryDirective) {
446     JTEntryDirective = MJTI->getEntrySize() == 4 ?
447       TAI->getData32bitsDirective() : TAI->getData64bitsDirective();
448   }
449
450   O << JTEntryDirective << ' ';
451
452   // If we have emitted set directives for the jump table entries, print 
453   // them rather than the entries themselves.  If we're emitting PIC, then
454   // emit the table entries as differences between two text section labels.
455   // If we're emitting non-PIC code, then emit the entries as direct
456   // references to the target basic blocks.
457   if (IsPic) {
458     if (TAI->getSetDirective()) {
459       O << TAI->getPrivateGlobalPrefix() << getFunctionNumber()
460         << '_' << uid << "_set_" << MBB->getNumber();
461     } else {
462       printBasicBlockLabel(MBB, false, false, false);
463       // If the arch uses custom Jump Table directives, don't calc relative to
464       // JT
465       if (!HadJTEntryDirective) 
466         O << '-' << TAI->getPrivateGlobalPrefix() << "JTI"
467           << getFunctionNumber() << '_' << uid;
468     }
469   } else {
470     printBasicBlockLabel(MBB, false, false, false);
471   }
472 }
473
474
475 /// EmitSpecialLLVMGlobal - Check to see if the specified global is a
476 /// special global used by LLVM.  If so, emit it and return true, otherwise
477 /// do nothing and return false.
478 bool AsmPrinter::EmitSpecialLLVMGlobal(const GlobalVariable *GV) {
479   if (GV->isName("llvm.used")) {
480     if (TAI->getUsedDirective() != 0)    // No need to emit this at all.
481       EmitLLVMUsedList(GV->getInitializer());
482     return true;
483   }
484
485   // Ignore debug and non-emitted data.  This handles llvm.compiler.used.
486   if (GV->getSection() == "llvm.metadata" ||
487       GV->hasAvailableExternallyLinkage())
488     return true;
489   
490   if (!GV->hasAppendingLinkage()) return false;
491
492   assert(GV->hasInitializer() && "Not a special LLVM global!");
493   
494   const TargetData *TD = TM.getTargetData();
495   unsigned Align = Log2_32(TD->getPointerPrefAlignment());
496   if (GV->getName() == "llvm.global_ctors") {
497     SwitchToDataSection(TAI->getStaticCtorsSection());
498     EmitAlignment(Align, 0);
499     EmitXXStructorList(GV->getInitializer());
500     return true;
501   } 
502   
503   if (GV->getName() == "llvm.global_dtors") {
504     SwitchToDataSection(TAI->getStaticDtorsSection());
505     EmitAlignment(Align, 0);
506     EmitXXStructorList(GV->getInitializer());
507     return true;
508   }
509   
510   return false;
511 }
512
513 /// EmitLLVMUsedList - For targets that define a TAI::UsedDirective, mark each
514 /// global in the specified llvm.used list for which emitUsedDirectiveFor
515 /// is true, as being used with this directive.
516 void AsmPrinter::EmitLLVMUsedList(Constant *List) {
517   const char *Directive = TAI->getUsedDirective();
518
519   // Should be an array of 'i8*'.
520   ConstantArray *InitList = dyn_cast<ConstantArray>(List);
521   if (InitList == 0) return;
522   
523   for (unsigned i = 0, e = InitList->getNumOperands(); i != e; ++i) {
524     const GlobalValue *GV =
525       dyn_cast<GlobalValue>(InitList->getOperand(i)->stripPointerCasts());
526     if (GV && TAI->emitUsedDirectiveFor(GV, Mang)) {
527       O << Directive;
528       EmitConstantValueOnly(InitList->getOperand(i));
529       O << '\n';
530     }
531   }
532 }
533
534 /// EmitXXStructorList - Emit the ctor or dtor list.  This just prints out the 
535 /// function pointers, ignoring the init priority.
536 void AsmPrinter::EmitXXStructorList(Constant *List) {
537   // Should be an array of '{ int, void ()* }' structs.  The first value is the
538   // init priority, which we ignore.
539   if (!isa<ConstantArray>(List)) return;
540   ConstantArray *InitList = cast<ConstantArray>(List);
541   for (unsigned i = 0, e = InitList->getNumOperands(); i != e; ++i)
542     if (ConstantStruct *CS = dyn_cast<ConstantStruct>(InitList->getOperand(i))){
543       if (CS->getNumOperands() != 2) return;  // Not array of 2-element structs.
544
545       if (CS->getOperand(1)->isNullValue())
546         return;  // Found a null terminator, exit printing.
547       // Emit the function pointer.
548       EmitGlobalConstant(CS->getOperand(1));
549     }
550 }
551
552 /// getGlobalLinkName - Returns the asm/link name of of the specified
553 /// global variable.  Should be overridden by each target asm printer to
554 /// generate the appropriate value.
555 const std::string &AsmPrinter::getGlobalLinkName(const GlobalVariable *GV,
556                                                  std::string &LinkName) const {
557   if (isa<Function>(GV)) {
558     LinkName += TAI->getFunctionAddrPrefix();
559     LinkName += Mang->getMangledName(GV);
560     LinkName += TAI->getFunctionAddrSuffix();
561   } else {
562     LinkName += TAI->getGlobalVarAddrPrefix();
563     LinkName += Mang->getMangledName(GV);
564     LinkName += TAI->getGlobalVarAddrSuffix();
565   }  
566   
567   return LinkName;
568 }
569
570 /// EmitExternalGlobal - Emit the external reference to a global variable.
571 /// Should be overridden if an indirect reference should be used.
572 void AsmPrinter::EmitExternalGlobal(const GlobalVariable *GV) {
573   std::string GLN;
574   O << getGlobalLinkName(GV, GLN);
575 }
576
577
578
579 //===----------------------------------------------------------------------===//
580 /// LEB 128 number encoding.
581
582 /// PrintULEB128 - Print a series of hexidecimal values (separated by commas)
583 /// representing an unsigned leb128 value.
584 void AsmPrinter::PrintULEB128(unsigned Value) const {
585   char Buffer[20];
586   do {
587     unsigned char Byte = static_cast<unsigned char>(Value & 0x7f);
588     Value >>= 7;
589     if (Value) Byte |= 0x80;
590     O << "0x" << utohex_buffer(Byte, Buffer+20);
591     if (Value) O << ", ";
592   } while (Value);
593 }
594
595 /// PrintSLEB128 - Print a series of hexidecimal values (separated by commas)
596 /// representing a signed leb128 value.
597 void AsmPrinter::PrintSLEB128(int Value) const {
598   int Sign = Value >> (8 * sizeof(Value) - 1);
599   bool IsMore;
600   char Buffer[20];
601
602   do {
603     unsigned char Byte = static_cast<unsigned char>(Value & 0x7f);
604     Value >>= 7;
605     IsMore = Value != Sign || ((Byte ^ Sign) & 0x40) != 0;
606     if (IsMore) Byte |= 0x80;
607     O << "0x" << utohex_buffer(Byte, Buffer+20);
608     if (IsMore) O << ", ";
609   } while (IsMore);
610 }
611
612 //===--------------------------------------------------------------------===//
613 // Emission and print routines
614 //
615
616 /// PrintHex - Print a value as a hexidecimal value.
617 ///
618 void AsmPrinter::PrintHex(int Value) const { 
619   char Buffer[20];
620   O << "0x" << utohex_buffer(static_cast<unsigned>(Value), Buffer+20);
621 }
622
623 /// EOL - Print a newline character to asm stream.  If a comment is present
624 /// then it will be printed first.  Comments should not contain '\n'.
625 void AsmPrinter::EOL() const {
626   O << '\n';
627 }
628
629 void AsmPrinter::EOL(const std::string &Comment) const {
630   if (VerboseAsm && !Comment.empty()) {
631     O << '\t'
632       << TAI->getCommentString()
633       << ' '
634       << Comment;
635   }
636   O << '\n';
637 }
638
639 void AsmPrinter::EOL(const char* Comment) const {
640   if (VerboseAsm && *Comment) {
641     O << '\t'
642       << TAI->getCommentString()
643       << ' '
644       << Comment;
645   }
646   O << '\n';
647 }
648
649 /// EmitULEB128Bytes - Emit an assembler byte data directive to compose an
650 /// unsigned leb128 value.
651 void AsmPrinter::EmitULEB128Bytes(unsigned Value) const {
652   if (TAI->hasLEB128()) {
653     O << "\t.uleb128\t"
654       << Value;
655   } else {
656     O << TAI->getData8bitsDirective();
657     PrintULEB128(Value);
658   }
659 }
660
661 /// EmitSLEB128Bytes - print an assembler byte data directive to compose a
662 /// signed leb128 value.
663 void AsmPrinter::EmitSLEB128Bytes(int Value) const {
664   if (TAI->hasLEB128()) {
665     O << "\t.sleb128\t"
666       << Value;
667   } else {
668     O << TAI->getData8bitsDirective();
669     PrintSLEB128(Value);
670   }
671 }
672
673 /// EmitInt8 - Emit a byte directive and value.
674 ///
675 void AsmPrinter::EmitInt8(int Value) const {
676   O << TAI->getData8bitsDirective();
677   PrintHex(Value & 0xFF);
678 }
679
680 /// EmitInt16 - Emit a short directive and value.
681 ///
682 void AsmPrinter::EmitInt16(int Value) const {
683   O << TAI->getData16bitsDirective();
684   PrintHex(Value & 0xFFFF);
685 }
686
687 /// EmitInt32 - Emit a long directive and value.
688 ///
689 void AsmPrinter::EmitInt32(int Value) const {
690   O << TAI->getData32bitsDirective();
691   PrintHex(Value);
692 }
693
694 /// EmitInt64 - Emit a long long directive and value.
695 ///
696 void AsmPrinter::EmitInt64(uint64_t Value) const {
697   if (TAI->getData64bitsDirective()) {
698     O << TAI->getData64bitsDirective();
699     PrintHex(Value);
700   } else {
701     if (TM.getTargetData()->isBigEndian()) {
702       EmitInt32(unsigned(Value >> 32)); O << '\n';
703       EmitInt32(unsigned(Value));
704     } else {
705       EmitInt32(unsigned(Value)); O << '\n';
706       EmitInt32(unsigned(Value >> 32));
707     }
708   }
709 }
710
711 /// toOctal - Convert the low order bits of X into an octal digit.
712 ///
713 static inline char toOctal(int X) {
714   return (X&7)+'0';
715 }
716
717 /// printStringChar - Print a char, escaped if necessary.
718 ///
719 static void printStringChar(formatted_raw_ostream &O, unsigned char C) {
720   if (C == '"') {
721     O << "\\\"";
722   } else if (C == '\\') {
723     O << "\\\\";
724   } else if (isprint((unsigned char)C)) {
725     O << C;
726   } else {
727     switch(C) {
728     case '\b': O << "\\b"; break;
729     case '\f': O << "\\f"; break;
730     case '\n': O << "\\n"; break;
731     case '\r': O << "\\r"; break;
732     case '\t': O << "\\t"; break;
733     default:
734       O << '\\';
735       O << toOctal(C >> 6);
736       O << toOctal(C >> 3);
737       O << toOctal(C >> 0);
738       break;
739     }
740   }
741 }
742
743 /// EmitString - Emit a string with quotes and a null terminator.
744 /// Special characters are emitted properly.
745 /// \literal (Eg. '\t') \endliteral
746 void AsmPrinter::EmitString(const std::string &String) const {
747   EmitString(String.c_str(), String.size());
748 }
749
750 void AsmPrinter::EmitString(const char *String, unsigned Size) const {
751   const char* AscizDirective = TAI->getAscizDirective();
752   if (AscizDirective)
753     O << AscizDirective;
754   else
755     O << TAI->getAsciiDirective();
756   O << '\"';
757   for (unsigned i = 0; i < Size; ++i)
758     printStringChar(O, String[i]);
759   if (AscizDirective)
760     O << '\"';
761   else
762     O << "\\0\"";
763 }
764
765
766 /// EmitFile - Emit a .file directive.
767 void AsmPrinter::EmitFile(unsigned Number, const std::string &Name) const {
768   O << "\t.file\t" << Number << " \"";
769   for (unsigned i = 0, N = Name.size(); i < N; ++i)
770     printStringChar(O, Name[i]);
771   O << '\"';
772 }
773
774
775 //===----------------------------------------------------------------------===//
776
777 // EmitAlignment - Emit an alignment directive to the specified power of
778 // two boundary.  For example, if you pass in 3 here, you will get an 8
779 // byte alignment.  If a global value is specified, and if that global has
780 // an explicit alignment requested, it will unconditionally override the
781 // alignment request.  However, if ForcedAlignBits is specified, this value
782 // has final say: the ultimate alignment will be the max of ForcedAlignBits
783 // and the alignment computed with NumBits and the global.
784 //
785 // The algorithm is:
786 //     Align = NumBits;
787 //     if (GV && GV->hasalignment) Align = GV->getalignment();
788 //     Align = std::max(Align, ForcedAlignBits);
789 //
790 void AsmPrinter::EmitAlignment(unsigned NumBits, const GlobalValue *GV,
791                                unsigned ForcedAlignBits,
792                                bool UseFillExpr) const {
793   if (GV && GV->getAlignment())
794     NumBits = Log2_32(GV->getAlignment());
795   NumBits = std::max(NumBits, ForcedAlignBits);
796   
797   if (NumBits == 0) return;   // No need to emit alignment.
798   if (TAI->getAlignmentIsInBytes()) NumBits = 1 << NumBits;
799   O << TAI->getAlignDirective() << NumBits;
800
801   unsigned FillValue = TAI->getTextAlignFillValue();
802   UseFillExpr &= IsInTextSection && FillValue;
803   if (UseFillExpr) {
804     O << ',';
805     PrintHex(FillValue);
806   }
807   O << '\n';
808 }
809
810     
811 /// EmitZeros - Emit a block of zeros.
812 ///
813 void AsmPrinter::EmitZeros(uint64_t NumZeros, unsigned AddrSpace) const {
814   if (NumZeros) {
815     if (TAI->getZeroDirective()) {
816       O << TAI->getZeroDirective() << NumZeros;
817       if (TAI->getZeroDirectiveSuffix())
818         O << TAI->getZeroDirectiveSuffix();
819       O << '\n';
820     } else {
821       for (; NumZeros; --NumZeros)
822         O << TAI->getData8bitsDirective(AddrSpace) << "0\n";
823     }
824   }
825 }
826
827 // Print out the specified constant, without a storage class.  Only the
828 // constants valid in constant expressions can occur here.
829 void AsmPrinter::EmitConstantValueOnly(const Constant *CV) {
830   if (CV->isNullValue() || isa<UndefValue>(CV))
831     O << '0';
832   else if (const ConstantInt *CI = dyn_cast<ConstantInt>(CV)) {
833     O << CI->getZExtValue();
834   } else if (const GlobalValue *GV = dyn_cast<GlobalValue>(CV)) {
835     // This is a constant address for a global variable or function. Use the
836     // name of the variable or function as the address value, possibly
837     // decorating it with GlobalVarAddrPrefix/Suffix or
838     // FunctionAddrPrefix/Suffix (these all default to "" )
839     if (isa<Function>(GV)) {
840       O << TAI->getFunctionAddrPrefix()
841         << Mang->getMangledName(GV)
842         << TAI->getFunctionAddrSuffix();
843     } else {
844       O << TAI->getGlobalVarAddrPrefix()
845         << Mang->getMangledName(GV)
846         << TAI->getGlobalVarAddrSuffix();
847     }
848   } else if (const ConstantExpr *CE = dyn_cast<ConstantExpr>(CV)) {
849     const TargetData *TD = TM.getTargetData();
850     unsigned Opcode = CE->getOpcode();    
851     switch (Opcode) {
852     case Instruction::GetElementPtr: {
853       // generate a symbolic expression for the byte address
854       const Constant *ptrVal = CE->getOperand(0);
855       SmallVector<Value*, 8> idxVec(CE->op_begin()+1, CE->op_end());
856       if (int64_t Offset = TD->getIndexedOffset(ptrVal->getType(), &idxVec[0],
857                                                 idxVec.size())) {
858         // Truncate/sext the offset to the pointer size.
859         if (TD->getPointerSizeInBits() != 64) {
860           int SExtAmount = 64-TD->getPointerSizeInBits();
861           Offset = (Offset << SExtAmount) >> SExtAmount;
862         }
863         
864         if (Offset)
865           O << '(';
866         EmitConstantValueOnly(ptrVal);
867         if (Offset > 0)
868           O << ") + " << Offset;
869         else if (Offset < 0)
870           O << ") - " << -Offset;
871       } else {
872         EmitConstantValueOnly(ptrVal);
873       }
874       break;
875     }
876     case Instruction::Trunc:
877     case Instruction::ZExt:
878     case Instruction::SExt:
879     case Instruction::FPTrunc:
880     case Instruction::FPExt:
881     case Instruction::UIToFP:
882     case Instruction::SIToFP:
883     case Instruction::FPToUI:
884     case Instruction::FPToSI:
885       llvm_unreachable("FIXME: Don't yet support this kind of constant cast expr");
886       break;
887     case Instruction::BitCast:
888       return EmitConstantValueOnly(CE->getOperand(0));
889
890     case Instruction::IntToPtr: {
891       // Handle casts to pointers by changing them into casts to the appropriate
892       // integer type.  This promotes constant folding and simplifies this code.
893       Constant *Op = CE->getOperand(0);
894       Op = ConstantExpr::getIntegerCast(Op, TD->getIntPtrType(), false/*ZExt*/);
895       return EmitConstantValueOnly(Op);
896     }
897       
898       
899     case Instruction::PtrToInt: {
900       // Support only foldable casts to/from pointers that can be eliminated by
901       // changing the pointer to the appropriately sized integer type.
902       Constant *Op = CE->getOperand(0);
903       const Type *Ty = CE->getType();
904
905       // We can emit the pointer value into this slot if the slot is an
906       // integer slot greater or equal to the size of the pointer.
907       if (TD->getTypeAllocSize(Ty) >= TD->getTypeAllocSize(Op->getType()))
908         return EmitConstantValueOnly(Op);
909
910       O << "((";
911       EmitConstantValueOnly(Op);
912       APInt ptrMask = APInt::getAllOnesValue(TD->getTypeAllocSizeInBits(Ty));
913       
914       SmallString<40> S;
915       ptrMask.toStringUnsigned(S);
916       O << ") & " << S.c_str() << ')';
917       break;
918     }
919     case Instruction::Add:
920     case Instruction::Sub:
921     case Instruction::And:
922     case Instruction::Or:
923     case Instruction::Xor:
924       O << '(';
925       EmitConstantValueOnly(CE->getOperand(0));
926       O << ')';
927       switch (Opcode) {
928       case Instruction::Add:
929        O << " + ";
930        break;
931       case Instruction::Sub:
932        O << " - ";
933        break;
934       case Instruction::And:
935        O << " & ";
936        break;
937       case Instruction::Or:
938        O << " | ";
939        break;
940       case Instruction::Xor:
941        O << " ^ ";
942        break;
943       default:
944        break;
945       }
946       O << '(';
947       EmitConstantValueOnly(CE->getOperand(1));
948       O << ')';
949       break;
950     default:
951       llvm_unreachable("Unsupported operator!");
952     }
953   } else {
954     llvm_unreachable("Unknown constant value!");
955   }
956 }
957
958 /// printAsCString - Print the specified array as a C compatible string, only if
959 /// the predicate isString is true.
960 ///
961 static void printAsCString(formatted_raw_ostream &O, const ConstantArray *CVA,
962                            unsigned LastElt) {
963   assert(CVA->isString() && "Array is not string compatible!");
964
965   O << '\"';
966   for (unsigned i = 0; i != LastElt; ++i) {
967     unsigned char C =
968         (unsigned char)cast<ConstantInt>(CVA->getOperand(i))->getZExtValue();
969     printStringChar(O, C);
970   }
971   O << '\"';
972 }
973
974 /// EmitString - Emit a zero-byte-terminated string constant.
975 ///
976 void AsmPrinter::EmitString(const ConstantArray *CVA) const {
977   unsigned NumElts = CVA->getNumOperands();
978   if (TAI->getAscizDirective() && NumElts && 
979       cast<ConstantInt>(CVA->getOperand(NumElts-1))->getZExtValue() == 0) {
980     O << TAI->getAscizDirective();
981     printAsCString(O, CVA, NumElts-1);
982   } else {
983     O << TAI->getAsciiDirective();
984     printAsCString(O, CVA, NumElts);
985   }
986   O << '\n';
987 }
988
989 void AsmPrinter::EmitGlobalConstantArray(const ConstantArray *CVA,
990                                          unsigned AddrSpace) {
991   if (CVA->isString()) {
992     EmitString(CVA);
993   } else { // Not a string.  Print the values in successive locations
994     for (unsigned i = 0, e = CVA->getNumOperands(); i != e; ++i)
995       EmitGlobalConstant(CVA->getOperand(i), AddrSpace);
996   }
997 }
998
999 void AsmPrinter::EmitGlobalConstantVector(const ConstantVector *CP) {
1000   const VectorType *PTy = CP->getType();
1001   
1002   for (unsigned I = 0, E = PTy->getNumElements(); I < E; ++I)
1003     EmitGlobalConstant(CP->getOperand(I));
1004 }
1005
1006 void AsmPrinter::EmitGlobalConstantStruct(const ConstantStruct *CVS,
1007                                           unsigned AddrSpace) {
1008   // Print the fields in successive locations. Pad to align if needed!
1009   const TargetData *TD = TM.getTargetData();
1010   unsigned Size = TD->getTypeAllocSize(CVS->getType());
1011   const StructLayout *cvsLayout = TD->getStructLayout(CVS->getType());
1012   uint64_t sizeSoFar = 0;
1013   for (unsigned i = 0, e = CVS->getNumOperands(); i != e; ++i) {
1014     const Constant* field = CVS->getOperand(i);
1015
1016     // Check if padding is needed and insert one or more 0s.
1017     uint64_t fieldSize = TD->getTypeAllocSize(field->getType());
1018     uint64_t padSize = ((i == e-1 ? Size : cvsLayout->getElementOffset(i+1))
1019                         - cvsLayout->getElementOffset(i)) - fieldSize;
1020     sizeSoFar += fieldSize + padSize;
1021
1022     // Now print the actual field value.
1023     EmitGlobalConstant(field, AddrSpace);
1024
1025     // Insert padding - this may include padding to increase the size of the
1026     // current field up to the ABI size (if the struct is not packed) as well
1027     // as padding to ensure that the next field starts at the right offset.
1028     EmitZeros(padSize, AddrSpace);
1029   }
1030   assert(sizeSoFar == cvsLayout->getSizeInBytes() &&
1031          "Layout of constant struct may be incorrect!");
1032 }
1033
1034 void AsmPrinter::EmitGlobalConstantFP(const ConstantFP *CFP, 
1035                                       unsigned AddrSpace) {
1036   // FP Constants are printed as integer constants to avoid losing
1037   // precision...
1038   const TargetData *TD = TM.getTargetData();
1039   if (CFP->getType() == Type::DoubleTy) {
1040     double Val = CFP->getValueAPF().convertToDouble();  // for comment only
1041     uint64_t i = CFP->getValueAPF().bitcastToAPInt().getZExtValue();
1042     if (TAI->getData64bitsDirective(AddrSpace)) {
1043       O << TAI->getData64bitsDirective(AddrSpace) << i;
1044       if (VerboseAsm)
1045         O << '\t' << TAI->getCommentString() << " double value: " << Val;
1046       O << '\n';
1047     } else if (TD->isBigEndian()) {
1048       O << TAI->getData32bitsDirective(AddrSpace) << unsigned(i >> 32);
1049       if (VerboseAsm)
1050         O << '\t' << TAI->getCommentString()
1051           << " double most significant word " << Val;
1052       O << '\n';
1053       O << TAI->getData32bitsDirective(AddrSpace) << unsigned(i);
1054       if (VerboseAsm)
1055         O << '\t' << TAI->getCommentString()
1056           << " double least significant word " << Val;
1057       O << '\n';
1058     } else {
1059       O << TAI->getData32bitsDirective(AddrSpace) << unsigned(i);
1060       if (VerboseAsm)
1061         O << '\t' << TAI->getCommentString()
1062           << " double least significant word " << Val;
1063       O << '\n';
1064       O << TAI->getData32bitsDirective(AddrSpace) << unsigned(i >> 32);
1065       if (VerboseAsm)
1066         O << '\t' << TAI->getCommentString()
1067           << " double most significant word " << Val;
1068       O << '\n';
1069     }
1070     return;
1071   } else if (CFP->getType() == Type::FloatTy) {
1072     float Val = CFP->getValueAPF().convertToFloat();  // for comment only
1073     O << TAI->getData32bitsDirective(AddrSpace)
1074       << CFP->getValueAPF().bitcastToAPInt().getZExtValue();
1075     if (VerboseAsm)
1076       O << '\t' << TAI->getCommentString() << " float " << Val;
1077     O << '\n';
1078     return;
1079   } else if (CFP->getType() == Type::X86_FP80Ty) {
1080     // all long double variants are printed as hex
1081     // api needed to prevent premature destruction
1082     APInt api = CFP->getValueAPF().bitcastToAPInt();
1083     const uint64_t *p = api.getRawData();
1084     // Convert to double so we can print the approximate val as a comment.
1085     APFloat DoubleVal = CFP->getValueAPF();
1086     bool ignored;
1087     DoubleVal.convert(APFloat::IEEEdouble, APFloat::rmNearestTiesToEven,
1088                       &ignored);
1089     if (TD->isBigEndian()) {
1090       O << TAI->getData16bitsDirective(AddrSpace) << uint16_t(p[1]);
1091       if (VerboseAsm)
1092         O << '\t' << TAI->getCommentString()
1093           << " long double most significant halfword of ~"
1094           << DoubleVal.convertToDouble();
1095       O << '\n';
1096       O << TAI->getData16bitsDirective(AddrSpace) << uint16_t(p[0] >> 48);
1097       if (VerboseAsm)
1098         O << '\t' << TAI->getCommentString() << " long double next halfword";
1099       O << '\n';
1100       O << TAI->getData16bitsDirective(AddrSpace) << uint16_t(p[0] >> 32);
1101       if (VerboseAsm)
1102         O << '\t' << TAI->getCommentString() << " long double next halfword";
1103       O << '\n';
1104       O << TAI->getData16bitsDirective(AddrSpace) << uint16_t(p[0] >> 16);
1105       if (VerboseAsm)
1106         O << '\t' << TAI->getCommentString() << " long double next halfword";
1107       O << '\n';
1108       O << TAI->getData16bitsDirective(AddrSpace) << uint16_t(p[0]);
1109       if (VerboseAsm)
1110         O << '\t' << TAI->getCommentString()
1111           << " long double least significant halfword";
1112       O << '\n';
1113      } else {
1114       O << TAI->getData16bitsDirective(AddrSpace) << uint16_t(p[0]);
1115       if (VerboseAsm)
1116         O << '\t' << TAI->getCommentString()
1117           << " long double least significant halfword of ~"
1118           << DoubleVal.convertToDouble();
1119       O << '\n';
1120       O << TAI->getData16bitsDirective(AddrSpace) << uint16_t(p[0] >> 16);
1121       if (VerboseAsm)
1122         O << '\t' << TAI->getCommentString()
1123           << " long double next halfword";
1124       O << '\n';
1125       O << TAI->getData16bitsDirective(AddrSpace) << uint16_t(p[0] >> 32);
1126       if (VerboseAsm)
1127         O << '\t' << TAI->getCommentString()
1128           << " long double next halfword";
1129       O << '\n';
1130       O << TAI->getData16bitsDirective(AddrSpace) << uint16_t(p[0] >> 48);
1131       if (VerboseAsm)
1132         O << '\t' << TAI->getCommentString()
1133           << " long double next halfword";
1134       O << '\n';
1135       O << TAI->getData16bitsDirective(AddrSpace) << uint16_t(p[1]);
1136       if (VerboseAsm)
1137         O << '\t' << TAI->getCommentString()
1138           << " long double most significant halfword";
1139       O << '\n';
1140     }
1141     EmitZeros(TD->getTypeAllocSize(Type::X86_FP80Ty) -
1142               TD->getTypeStoreSize(Type::X86_FP80Ty), AddrSpace);
1143     return;
1144   } else if (CFP->getType() == Type::PPC_FP128Ty) {
1145     // all long double variants are printed as hex
1146     // api needed to prevent premature destruction
1147     APInt api = CFP->getValueAPF().bitcastToAPInt();
1148     const uint64_t *p = api.getRawData();
1149     if (TD->isBigEndian()) {
1150       O << TAI->getData32bitsDirective(AddrSpace) << uint32_t(p[0] >> 32);
1151       if (VerboseAsm)
1152         O << '\t' << TAI->getCommentString()
1153           << " long double most significant word";
1154       O << '\n';
1155       O << TAI->getData32bitsDirective(AddrSpace) << uint32_t(p[0]);
1156       if (VerboseAsm)      
1157         O << '\t' << TAI->getCommentString()
1158         << " long double next word";
1159       O << '\n';
1160       O << TAI->getData32bitsDirective(AddrSpace) << uint32_t(p[1] >> 32);
1161       if (VerboseAsm)
1162         O << '\t' << TAI->getCommentString()
1163           << " long double next word";
1164       O << '\n';
1165       O << TAI->getData32bitsDirective(AddrSpace) << uint32_t(p[1]);
1166       if (VerboseAsm)
1167         O << '\t' << TAI->getCommentString()
1168           << " long double least significant word";
1169       O << '\n';
1170      } else {
1171       O << TAI->getData32bitsDirective(AddrSpace) << uint32_t(p[1]);
1172       if (VerboseAsm)
1173         O << '\t' << TAI->getCommentString()
1174           << " long double least significant word";
1175       O << '\n';
1176       O << TAI->getData32bitsDirective(AddrSpace) << uint32_t(p[1] >> 32);
1177       if (VerboseAsm)
1178         O << '\t' << TAI->getCommentString()
1179           << " long double next word";
1180       O << '\n';
1181       O << TAI->getData32bitsDirective(AddrSpace) << uint32_t(p[0]);
1182       if (VerboseAsm)
1183         O << '\t' << TAI->getCommentString()
1184           << " long double next word";
1185       O << '\n';
1186       O << TAI->getData32bitsDirective(AddrSpace) << uint32_t(p[0] >> 32);
1187       if (VerboseAsm)
1188         O << '\t' << TAI->getCommentString()
1189           << " long double most significant word";
1190       O << '\n';
1191     }
1192     return;
1193   } else llvm_unreachable("Floating point constant type not handled");
1194 }
1195
1196 void AsmPrinter::EmitGlobalConstantLargeInt(const ConstantInt *CI,
1197                                             unsigned AddrSpace) {
1198   const TargetData *TD = TM.getTargetData();
1199   unsigned BitWidth = CI->getBitWidth();
1200   assert(isPowerOf2_32(BitWidth) &&
1201          "Non-power-of-2-sized integers not handled!");
1202
1203   // We don't expect assemblers to support integer data directives
1204   // for more than 64 bits, so we emit the data in at most 64-bit
1205   // quantities at a time.
1206   const uint64_t *RawData = CI->getValue().getRawData();
1207   for (unsigned i = 0, e = BitWidth / 64; i != e; ++i) {
1208     uint64_t Val;
1209     if (TD->isBigEndian())
1210       Val = RawData[e - i - 1];
1211     else
1212       Val = RawData[i];
1213
1214     if (TAI->getData64bitsDirective(AddrSpace))
1215       O << TAI->getData64bitsDirective(AddrSpace) << Val << '\n';
1216     else if (TD->isBigEndian()) {
1217       O << TAI->getData32bitsDirective(AddrSpace) << unsigned(Val >> 32);
1218       if (VerboseAsm)
1219         O << '\t' << TAI->getCommentString()
1220           << " Double-word most significant word " << Val;
1221       O << '\n';
1222       O << TAI->getData32bitsDirective(AddrSpace) << unsigned(Val);
1223       if (VerboseAsm)
1224         O << '\t' << TAI->getCommentString()
1225           << " Double-word least significant word " << Val;
1226       O << '\n';
1227     } else {
1228       O << TAI->getData32bitsDirective(AddrSpace) << unsigned(Val);
1229       if (VerboseAsm)
1230         O << '\t' << TAI->getCommentString()
1231           << " Double-word least significant word " << Val;
1232       O << '\n';
1233       O << TAI->getData32bitsDirective(AddrSpace) << unsigned(Val >> 32);
1234       if (VerboseAsm)
1235         O << '\t' << TAI->getCommentString()
1236           << " Double-word most significant word " << Val;
1237       O << '\n';
1238     }
1239   }
1240 }
1241
1242 /// EmitGlobalConstant - Print a general LLVM constant to the .s file.
1243 void AsmPrinter::EmitGlobalConstant(const Constant *CV, unsigned AddrSpace) {
1244   const TargetData *TD = TM.getTargetData();
1245   const Type *type = CV->getType();
1246   unsigned Size = TD->getTypeAllocSize(type);
1247
1248   if (CV->isNullValue() || isa<UndefValue>(CV)) {
1249     EmitZeros(Size, AddrSpace);
1250     return;
1251   } else if (const ConstantArray *CVA = dyn_cast<ConstantArray>(CV)) {
1252     EmitGlobalConstantArray(CVA , AddrSpace);
1253     return;
1254   } else if (const ConstantStruct *CVS = dyn_cast<ConstantStruct>(CV)) {
1255     EmitGlobalConstantStruct(CVS, AddrSpace);
1256     return;
1257   } else if (const ConstantFP *CFP = dyn_cast<ConstantFP>(CV)) {
1258     EmitGlobalConstantFP(CFP, AddrSpace);
1259     return;
1260   } else if (const ConstantInt *CI = dyn_cast<ConstantInt>(CV)) {
1261     // Small integers are handled below; large integers are handled here.
1262     if (Size > 4) {
1263       EmitGlobalConstantLargeInt(CI, AddrSpace);
1264       return;
1265     }
1266   } else if (const ConstantVector *CP = dyn_cast<ConstantVector>(CV)) {
1267     EmitGlobalConstantVector(CP);
1268     return;
1269   }
1270
1271   printDataDirective(type, AddrSpace);
1272   EmitConstantValueOnly(CV);
1273   if (VerboseAsm) {
1274     if (const ConstantInt *CI = dyn_cast<ConstantInt>(CV)) {
1275       SmallString<40> S;
1276       CI->getValue().toStringUnsigned(S, 16);
1277       O << "\t\t\t" << TAI->getCommentString() << " 0x" << S.c_str();
1278     }
1279   }
1280   O << '\n';
1281 }
1282
1283 void AsmPrinter::EmitMachineConstantPoolValue(MachineConstantPoolValue *MCPV) {
1284   // Target doesn't support this yet!
1285   llvm_unreachable("Target does not support EmitMachineConstantPoolValue");
1286 }
1287
1288 /// PrintSpecial - Print information related to the specified machine instr
1289 /// that is independent of the operand, and may be independent of the instr
1290 /// itself.  This can be useful for portably encoding the comment character
1291 /// or other bits of target-specific knowledge into the asmstrings.  The
1292 /// syntax used is ${:comment}.  Targets can override this to add support
1293 /// for their own strange codes.
1294 void AsmPrinter::PrintSpecial(const MachineInstr *MI, const char *Code) const {
1295   if (!strcmp(Code, "private")) {
1296     O << TAI->getPrivateGlobalPrefix();
1297   } else if (!strcmp(Code, "comment")) {
1298     if (VerboseAsm)
1299       O << TAI->getCommentString();
1300   } else if (!strcmp(Code, "uid")) {
1301     // Comparing the address of MI isn't sufficient, because machineinstrs may
1302     // be allocated to the same address across functions.
1303     const Function *ThisF = MI->getParent()->getParent()->getFunction();
1304     
1305     // If this is a new LastFn instruction, bump the counter.
1306     if (LastMI != MI || LastFn != ThisF) {
1307       ++Counter;
1308       LastMI = MI;
1309       LastFn = ThisF;
1310     }
1311     O << Counter;
1312   } else {
1313     std::string msg;
1314     raw_string_ostream Msg(msg);
1315     Msg << "Unknown special formatter '" << Code
1316          << "' for machine instr: " << *MI;
1317     llvm_report_error(Msg.str());
1318   }    
1319 }
1320
1321 /// processDebugLoc - Processes the debug information of each machine
1322 /// instruction's DebugLoc.
1323 void AsmPrinter::processDebugLoc(DebugLoc DL) {
1324   if (TAI->doesSupportDebugInformation() && DW->ShouldEmitDwarfDebug()) {
1325     if (!DL.isUnknown()) {
1326       DebugLocTuple CurDLT = MF->getDebugLocTuple(DL);
1327
1328       if (CurDLT.CompileUnit != 0 && PrevDLT != CurDLT)
1329         printLabel(DW->RecordSourceLine(CurDLT.Line, CurDLT.Col,
1330                                         DICompileUnit(CurDLT.CompileUnit)));
1331
1332       PrevDLT = CurDLT;
1333     }
1334   }
1335 }
1336
1337 /// printInlineAsm - This method formats and prints the specified machine
1338 /// instruction that is an inline asm.
1339 void AsmPrinter::printInlineAsm(const MachineInstr *MI) const {
1340   unsigned NumOperands = MI->getNumOperands();
1341   
1342   // Count the number of register definitions.
1343   unsigned NumDefs = 0;
1344   for (; MI->getOperand(NumDefs).isReg() && MI->getOperand(NumDefs).isDef();
1345        ++NumDefs)
1346     assert(NumDefs != NumOperands-1 && "No asm string?");
1347   
1348   assert(MI->getOperand(NumDefs).isSymbol() && "No asm string?");
1349
1350   // Disassemble the AsmStr, printing out the literal pieces, the operands, etc.
1351   const char *AsmStr = MI->getOperand(NumDefs).getSymbolName();
1352
1353   // If this asmstr is empty, just print the #APP/#NOAPP markers.
1354   // These are useful to see where empty asm's wound up.
1355   if (AsmStr[0] == 0) {
1356     O << TAI->getInlineAsmStart() << "\n\t" << TAI->getInlineAsmEnd() << '\n';
1357     return;
1358   }
1359   
1360   O << TAI->getInlineAsmStart() << "\n\t";
1361
1362   // The variant of the current asmprinter.
1363   int AsmPrinterVariant = TAI->getAssemblerDialect();
1364
1365   int CurVariant = -1;            // The number of the {.|.|.} region we are in.
1366   const char *LastEmitted = AsmStr; // One past the last character emitted.
1367   
1368   while (*LastEmitted) {
1369     switch (*LastEmitted) {
1370     default: {
1371       // Not a special case, emit the string section literally.
1372       const char *LiteralEnd = LastEmitted+1;
1373       while (*LiteralEnd && *LiteralEnd != '{' && *LiteralEnd != '|' &&
1374              *LiteralEnd != '}' && *LiteralEnd != '$' && *LiteralEnd != '\n')
1375         ++LiteralEnd;
1376       if (CurVariant == -1 || CurVariant == AsmPrinterVariant)
1377         O.write(LastEmitted, LiteralEnd-LastEmitted);
1378       LastEmitted = LiteralEnd;
1379       break;
1380     }
1381     case '\n':
1382       ++LastEmitted;   // Consume newline character.
1383       O << '\n';       // Indent code with newline.
1384       break;
1385     case '$': {
1386       ++LastEmitted;   // Consume '$' character.
1387       bool Done = true;
1388
1389       // Handle escapes.
1390       switch (*LastEmitted) {
1391       default: Done = false; break;
1392       case '$':     // $$ -> $
1393         if (CurVariant == -1 || CurVariant == AsmPrinterVariant)
1394           O << '$';
1395         ++LastEmitted;  // Consume second '$' character.
1396         break;
1397       case '(':             // $( -> same as GCC's { character.
1398         ++LastEmitted;      // Consume '(' character.
1399         if (CurVariant != -1) {
1400           llvm_report_error("Nested variants found in inline asm string: '"
1401                             + std::string(AsmStr) + "'");
1402         }
1403         CurVariant = 0;     // We're in the first variant now.
1404         break;
1405       case '|':
1406         ++LastEmitted;  // consume '|' character.
1407         if (CurVariant == -1)
1408           O << '|';       // this is gcc's behavior for | outside a variant
1409         else
1410           ++CurVariant;   // We're in the next variant.
1411         break;
1412       case ')':         // $) -> same as GCC's } char.
1413         ++LastEmitted;  // consume ')' character.
1414         if (CurVariant == -1)
1415           O << '}';     // this is gcc's behavior for } outside a variant
1416         else 
1417           CurVariant = -1;
1418         break;
1419       }
1420       if (Done) break;
1421       
1422       bool HasCurlyBraces = false;
1423       if (*LastEmitted == '{') {     // ${variable}
1424         ++LastEmitted;               // Consume '{' character.
1425         HasCurlyBraces = true;
1426       }
1427       
1428       // If we have ${:foo}, then this is not a real operand reference, it is a
1429       // "magic" string reference, just like in .td files.  Arrange to call
1430       // PrintSpecial.
1431       if (HasCurlyBraces && *LastEmitted == ':') {
1432         ++LastEmitted;
1433         const char *StrStart = LastEmitted;
1434         const char *StrEnd = strchr(StrStart, '}');
1435         if (StrEnd == 0) {
1436           llvm_report_error("Unterminated ${:foo} operand in inline asm string: '" 
1437                             + std::string(AsmStr) + "'");
1438         }
1439         
1440         std::string Val(StrStart, StrEnd);
1441         PrintSpecial(MI, Val.c_str());
1442         LastEmitted = StrEnd+1;
1443         break;
1444       }
1445             
1446       const char *IDStart = LastEmitted;
1447       char *IDEnd;
1448       errno = 0;
1449       long Val = strtol(IDStart, &IDEnd, 10); // We only accept numbers for IDs.
1450       if (!isdigit(*IDStart) || (Val == 0 && errno == EINVAL)) {
1451         llvm_report_error("Bad $ operand number in inline asm string: '" 
1452                           + std::string(AsmStr) + "'");
1453       }
1454       LastEmitted = IDEnd;
1455       
1456       char Modifier[2] = { 0, 0 };
1457       
1458       if (HasCurlyBraces) {
1459         // If we have curly braces, check for a modifier character.  This
1460         // supports syntax like ${0:u}, which correspond to "%u0" in GCC asm.
1461         if (*LastEmitted == ':') {
1462           ++LastEmitted;    // Consume ':' character.
1463           if (*LastEmitted == 0) {
1464             llvm_report_error("Bad ${:} expression in inline asm string: '" 
1465                               + std::string(AsmStr) + "'");
1466           }
1467           
1468           Modifier[0] = *LastEmitted;
1469           ++LastEmitted;    // Consume modifier character.
1470         }
1471         
1472         if (*LastEmitted != '}') {
1473           llvm_report_error("Bad ${} expression in inline asm string: '" 
1474                             + std::string(AsmStr) + "'");
1475         }
1476         ++LastEmitted;    // Consume '}' character.
1477       }
1478       
1479       if ((unsigned)Val >= NumOperands-1) {
1480         llvm_report_error("Invalid $ operand number in inline asm string: '" 
1481                           + std::string(AsmStr) + "'");
1482       }
1483       
1484       // Okay, we finally have a value number.  Ask the target to print this
1485       // operand!
1486       if (CurVariant == -1 || CurVariant == AsmPrinterVariant) {
1487         unsigned OpNo = 1;
1488
1489         bool Error = false;
1490
1491         // Scan to find the machine operand number for the operand.
1492         for (; Val; --Val) {
1493           if (OpNo >= MI->getNumOperands()) break;
1494           unsigned OpFlags = MI->getOperand(OpNo).getImm();
1495           OpNo += InlineAsm::getNumOperandRegisters(OpFlags) + 1;
1496         }
1497
1498         if (OpNo >= MI->getNumOperands()) {
1499           Error = true;
1500         } else {
1501           unsigned OpFlags = MI->getOperand(OpNo).getImm();
1502           ++OpNo;  // Skip over the ID number.
1503
1504           if (Modifier[0]=='l')  // labels are target independent
1505             printBasicBlockLabel(MI->getOperand(OpNo).getMBB(), 
1506                                  false, false, false);
1507           else {
1508             AsmPrinter *AP = const_cast<AsmPrinter*>(this);
1509             if ((OpFlags & 7) == 4) {
1510               Error = AP->PrintAsmMemoryOperand(MI, OpNo, AsmPrinterVariant,
1511                                                 Modifier[0] ? Modifier : 0);
1512             } else {
1513               Error = AP->PrintAsmOperand(MI, OpNo, AsmPrinterVariant,
1514                                           Modifier[0] ? Modifier : 0);
1515             }
1516           }
1517         }
1518         if (Error) {
1519           std::string msg;
1520           raw_string_ostream Msg(msg);
1521           Msg << "Invalid operand found in inline asm: '"
1522                << AsmStr << "'\n";
1523           MI->print(Msg);
1524           llvm_report_error(Msg.str());
1525         }
1526       }
1527       break;
1528     }
1529     }
1530   }
1531   O << "\n\t" << TAI->getInlineAsmEnd() << '\n';
1532 }
1533
1534 /// printImplicitDef - This method prints the specified machine instruction
1535 /// that is an implicit def.
1536 void AsmPrinter::printImplicitDef(const MachineInstr *MI) const {
1537   if (VerboseAsm)
1538     O << '\t' << TAI->getCommentString() << " implicit-def: "
1539       << TRI->getAsmName(MI->getOperand(0).getReg()) << '\n';
1540 }
1541
1542 /// printLabel - This method prints a local label used by debug and
1543 /// exception handling tables.
1544 void AsmPrinter::printLabel(const MachineInstr *MI) const {
1545   printLabel(MI->getOperand(0).getImm());
1546 }
1547
1548 void AsmPrinter::printLabel(unsigned Id) const {
1549   O << TAI->getPrivateGlobalPrefix() << "label" << Id << ":\n";
1550 }
1551
1552 /// printDeclare - This method prints a local variable declaration used by
1553 /// debug tables.
1554 /// FIXME: It doesn't really print anything rather it inserts a DebugVariable
1555 /// entry into dwarf table.
1556 void AsmPrinter::printDeclare(const MachineInstr *MI) const {
1557   unsigned FI = MI->getOperand(0).getIndex();
1558   GlobalValue *GV = MI->getOperand(1).getGlobal();
1559   DW->RecordVariable(cast<GlobalVariable>(GV), FI, MI);
1560 }
1561
1562 /// PrintAsmOperand - Print the specified operand of MI, an INLINEASM
1563 /// instruction, using the specified assembler variant.  Targets should
1564 /// overried this to format as appropriate.
1565 bool AsmPrinter::PrintAsmOperand(const MachineInstr *MI, unsigned OpNo,
1566                                  unsigned AsmVariant, const char *ExtraCode) {
1567   // Target doesn't support this yet!
1568   return true;
1569 }
1570
1571 bool AsmPrinter::PrintAsmMemoryOperand(const MachineInstr *MI, unsigned OpNo,
1572                                        unsigned AsmVariant,
1573                                        const char *ExtraCode) {
1574   // Target doesn't support this yet!
1575   return true;
1576 }
1577
1578 /// printBasicBlockLabel - This method prints the label for the specified
1579 /// MachineBasicBlock
1580 void AsmPrinter::printBasicBlockLabel(const MachineBasicBlock *MBB,
1581                                       bool printAlign, 
1582                                       bool printColon,
1583                                       bool printComment) const {
1584   if (printAlign) {
1585     unsigned Align = MBB->getAlignment();
1586     if (Align)
1587       EmitAlignment(Log2_32(Align));
1588   }
1589
1590   O << TAI->getPrivateGlobalPrefix() << "BB" << getFunctionNumber() << '_'
1591     << MBB->getNumber();
1592   if (printColon)
1593     O << ':';
1594   if (printComment && MBB->getBasicBlock())
1595     O << '\t' << TAI->getCommentString() << ' '
1596       << MBB->getBasicBlock()->getNameStart();
1597 }
1598
1599 /// printPICJumpTableSetLabel - This method prints a set label for the
1600 /// specified MachineBasicBlock for a jumptable entry.
1601 void AsmPrinter::printPICJumpTableSetLabel(unsigned uid, 
1602                                            const MachineBasicBlock *MBB) const {
1603   if (!TAI->getSetDirective())
1604     return;
1605   
1606   O << TAI->getSetDirective() << ' ' << TAI->getPrivateGlobalPrefix()
1607     << getFunctionNumber() << '_' << uid << "_set_" << MBB->getNumber() << ',';
1608   printBasicBlockLabel(MBB, false, false, false);
1609   O << '-' << TAI->getPrivateGlobalPrefix() << "JTI" << getFunctionNumber() 
1610     << '_' << uid << '\n';
1611 }
1612
1613 void AsmPrinter::printPICJumpTableSetLabel(unsigned uid, unsigned uid2,
1614                                            const MachineBasicBlock *MBB) const {
1615   if (!TAI->getSetDirective())
1616     return;
1617   
1618   O << TAI->getSetDirective() << ' ' << TAI->getPrivateGlobalPrefix()
1619     << getFunctionNumber() << '_' << uid << '_' << uid2
1620     << "_set_" << MBB->getNumber() << ',';
1621   printBasicBlockLabel(MBB, false, false, false);
1622   O << '-' << TAI->getPrivateGlobalPrefix() << "JTI" << getFunctionNumber() 
1623     << '_' << uid << '_' << uid2 << '\n';
1624 }
1625
1626 /// printDataDirective - This method prints the asm directive for the
1627 /// specified type.
1628 void AsmPrinter::printDataDirective(const Type *type, unsigned AddrSpace) {
1629   const TargetData *TD = TM.getTargetData();
1630   switch (type->getTypeID()) {
1631   case Type::FloatTyID: case Type::DoubleTyID:
1632   case Type::X86_FP80TyID: case Type::FP128TyID: case Type::PPC_FP128TyID:
1633     assert(0 && "Should have already output floating point constant.");
1634   default:
1635     assert(0 && "Can't handle printing this type of thing");
1636   case Type::IntegerTyID: {
1637     unsigned BitWidth = cast<IntegerType>(type)->getBitWidth();
1638     if (BitWidth <= 8)
1639       O << TAI->getData8bitsDirective(AddrSpace);
1640     else if (BitWidth <= 16)
1641       O << TAI->getData16bitsDirective(AddrSpace);
1642     else if (BitWidth <= 32)
1643       O << TAI->getData32bitsDirective(AddrSpace);
1644     else if (BitWidth <= 64) {
1645       assert(TAI->getData64bitsDirective(AddrSpace) &&
1646              "Target cannot handle 64-bit constant exprs!");
1647       O << TAI->getData64bitsDirective(AddrSpace);
1648     } else {
1649       llvm_unreachable("Target cannot handle given data directive width!");
1650     }
1651     break;
1652   }
1653   case Type::PointerTyID:
1654     if (TD->getPointerSize() == 8) {
1655       assert(TAI->getData64bitsDirective(AddrSpace) &&
1656              "Target cannot handle 64-bit pointer exprs!");
1657       O << TAI->getData64bitsDirective(AddrSpace);
1658     } else if (TD->getPointerSize() == 2) {
1659       O << TAI->getData16bitsDirective(AddrSpace);
1660     } else if (TD->getPointerSize() == 1) {
1661       O << TAI->getData8bitsDirective(AddrSpace);
1662     } else {
1663       O << TAI->getData32bitsDirective(AddrSpace);
1664     }
1665     break;
1666   }
1667 }
1668
1669 void AsmPrinter::printVisibility(const std::string& Name,
1670                                  unsigned Visibility) const {
1671   if (Visibility == GlobalValue::HiddenVisibility) {
1672     if (const char *Directive = TAI->getHiddenDirective())
1673       O << Directive << Name << '\n';
1674   } else if (Visibility == GlobalValue::ProtectedVisibility) {
1675     if (const char *Directive = TAI->getProtectedDirective())
1676       O << Directive << Name << '\n';
1677   }
1678 }
1679
1680 void AsmPrinter::printOffset(int64_t Offset) const {
1681   if (Offset > 0)
1682     O << '+' << Offset;
1683   else if (Offset < 0)
1684     O << Offset;
1685 }
1686
1687 GCMetadataPrinter *AsmPrinter::GetOrCreateGCPrinter(GCStrategy *S) {
1688   if (!S->usesMetadata())
1689     return 0;
1690   
1691   gcp_iterator GCPI = GCMetadataPrinters.find(S);
1692   if (GCPI != GCMetadataPrinters.end())
1693     return GCPI->second;
1694   
1695   const char *Name = S->getName().c_str();
1696   
1697   for (GCMetadataPrinterRegistry::iterator
1698          I = GCMetadataPrinterRegistry::begin(),
1699          E = GCMetadataPrinterRegistry::end(); I != E; ++I)
1700     if (strcmp(Name, I->getName()) == 0) {
1701       GCMetadataPrinter *GMP = I->instantiate();
1702       GMP->S = S;
1703       GCMetadataPrinters.insert(std::make_pair(S, GMP));
1704       return GMP;
1705     }
1706   
1707   cerr << "no GCMetadataPrinter registered for GC: " << Name << "\n";
1708   llvm_unreachable(0);
1709 }
1710
1711 /// EmitComments - Pretty-print comments for instructions
1712 void AsmPrinter::EmitComments(const MachineInstr &MI) const
1713 {
1714   if (VerboseAsm) {
1715     if (!MI.getDebugLoc().isUnknown()) {
1716       DebugLocTuple DLT = MF->getDebugLocTuple(MI.getDebugLoc());
1717
1718       // Print source line info
1719       O.PadToColumn(TAI->getCommentColumn(), 1);
1720       O << TAI->getCommentString() << " SrcLine ";
1721       if (DLT.CompileUnit->hasInitializer()) {
1722         Constant *Name = DLT.CompileUnit->getInitializer();
1723         if (ConstantArray *NameString = dyn_cast<ConstantArray>(Name))
1724           if (NameString->isString()) {
1725             O << NameString->getAsString() << " ";
1726           }
1727       }
1728       O << DLT.Line;
1729       if (DLT.Col != 0) 
1730         O << ":" << DLT.Col;
1731     }
1732   }
1733 }
1734
1735 /// EmitComments - Pretty-print comments for instructions
1736 void AsmPrinter::EmitComments(const MCInst &MI) const
1737 {
1738   if (VerboseAsm) {
1739     if (!MI.getDebugLoc().isUnknown()) {
1740       DebugLocTuple DLT = MF->getDebugLocTuple(MI.getDebugLoc());
1741
1742       // Print source line info
1743       O.PadToColumn(TAI->getCommentColumn(), 1);
1744       O << TAI->getCommentString() << " SrcLine ";
1745       if (DLT.CompileUnit->hasInitializer()) {
1746         Constant *Name = DLT.CompileUnit->getInitializer();
1747         if (ConstantArray *NameString = dyn_cast<ConstantArray>(Name))
1748           if (NameString->isString()) {
1749             O << NameString->getAsString() << " ";
1750           }
1751       }
1752       O << DLT.Line;
1753       if (DLT.Col != 0) 
1754         O << ":" << DLT.Col;
1755     }
1756   }
1757 }