1 //===- SubtargetEmitter.cpp - Generate subtarget enumerations -------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This tablegen backend emits subtarget enumerations.
12 //===----------------------------------------------------------------------===//
14 #include "SubtargetEmitter.h"
15 #include "CodeGenTarget.h"
17 #include "llvm/ADT/StringExtras.h"
18 #include "llvm/Support/Debug.h"
23 // Enumeration - Emit the specified class as an enumeration.
25 void SubtargetEmitter::Enumeration(raw_ostream &OS,
26 const char *ClassName,
28 // Get all records of class and sort
29 std::vector<Record*> DefList = Records.getAllDerivedDefinitions(ClassName);
30 std::sort(DefList.begin(), DefList.end(), LessRecord());
36 for (unsigned i = 0, N = DefList.size(); i < N;) {
38 Record *Def = DefList[i];
41 OS << " " << Def->getName();
43 // If bit flags then emit expression (1 << i)
44 if (isBits) OS << " = " << " 1 << " << i;
46 // Depending on 'if more in the list' emit comma
47 if (++i < N) OS << ",";
57 // FeatureKeyValues - Emit data of all the subtarget features. Used by the
60 void SubtargetEmitter::FeatureKeyValues(raw_ostream &OS) {
61 // Gather and sort all the features
62 std::vector<Record*> FeatureList =
63 Records.getAllDerivedDefinitions("SubtargetFeature");
64 std::sort(FeatureList.begin(), FeatureList.end(), LessRecordFieldName());
66 // Begin feature table
67 OS << "// Sorted (by key) array of values for CPU features.\n"
68 << "static const llvm::SubtargetFeatureKV FeatureKV[] = {\n";
71 for (unsigned i = 0, N = FeatureList.size(); i < N; ++i) {
73 Record *Feature = FeatureList[i];
75 const std::string &Name = Feature->getName();
76 const std::string &CommandLineName = Feature->getValueAsString("Name");
77 const std::string &Desc = Feature->getValueAsString("Desc");
79 if (CommandLineName.empty()) continue;
81 // Emit as { "feature", "description", featureEnum, i1 | i2 | ... | in }
83 << "\"" << CommandLineName << "\", "
84 << "\"" << Desc << "\", "
87 const std::vector<Record*> &ImpliesList =
88 Feature->getValueAsListOfDefs("Implies");
90 if (ImpliesList.empty()) {
93 for (unsigned j = 0, M = ImpliesList.size(); j < M;) {
94 OS << ImpliesList[j]->getName();
95 if (++j < M) OS << " | ";
101 // Depending on 'if more in the list' emit comma
102 if ((i + 1) < N) OS << ",";
110 // Emit size of table
112 OS<<" FeatureKVSize = sizeof(FeatureKV)/sizeof(llvm::SubtargetFeatureKV)\n";
117 // CPUKeyValues - Emit data of all the subtarget processors. Used by command
120 void SubtargetEmitter::CPUKeyValues(raw_ostream &OS) {
121 // Gather and sort processor information
122 std::vector<Record*> ProcessorList =
123 Records.getAllDerivedDefinitions("Processor");
124 std::sort(ProcessorList.begin(), ProcessorList.end(), LessRecordFieldName());
126 // Begin processor table
127 OS << "// Sorted (by key) array of values for CPU subtype.\n"
128 << "static const llvm::SubtargetFeatureKV SubTypeKV[] = {\n";
130 // For each processor
131 for (unsigned i = 0, N = ProcessorList.size(); i < N;) {
133 Record *Processor = ProcessorList[i];
135 const std::string &Name = Processor->getValueAsString("Name");
136 const std::vector<Record*> &FeatureList =
137 Processor->getValueAsListOfDefs("Features");
139 // Emit as { "cpu", "description", f1 | f2 | ... fn },
141 << "\"" << Name << "\", "
142 << "\"Select the " << Name << " processor\", ";
144 if (FeatureList.empty()) {
147 for (unsigned j = 0, M = FeatureList.size(); j < M;) {
148 OS << FeatureList[j]->getName();
149 if (++j < M) OS << " | ";
153 // The "0" is for the "implies" section of this data structure.
156 // Depending on 'if more in the list' emit comma
157 if (++i < N) OS << ",";
162 // End processor table
165 // Emit size of table
167 OS<<" SubTypeKVSize = sizeof(SubTypeKV)/sizeof(llvm::SubtargetFeatureKV)\n";
172 // CollectAllItinClasses - Gathers and enumerates all the itinerary classes.
173 // Returns itinerary class count.
175 unsigned SubtargetEmitter::CollectAllItinClasses(raw_ostream &OS,
176 std::map<std::string, unsigned> &ItinClassesMap) {
177 // Gather and sort all itinerary classes
178 std::vector<Record*> ItinClassList =
179 Records.getAllDerivedDefinitions("InstrItinClass");
180 std::sort(ItinClassList.begin(), ItinClassList.end(), LessRecord());
182 // For each itinerary class
183 unsigned N = ItinClassList.size();
184 for (unsigned i = 0; i < N; i++) {
185 // Next itinerary class
186 const Record *ItinClass = ItinClassList[i];
187 // Get name of itinerary class
188 // Assign itinerary class a unique number
189 ItinClassesMap[ItinClass->getName()] = i;
192 // Emit size of table
194 OS<<" ItinClassesSize = " << N << "\n";
197 // Return itinerary class count
202 // FormItineraryStageString - Compose a string containing the stage
203 // data initialization for the specified itinerary. N is the number
206 void SubtargetEmitter::FormItineraryStageString(Record *ItinData,
207 std::string &ItinString,
210 const std::vector<Record*> &StageList =
211 ItinData->getValueAsListOfDefs("Stages");
214 unsigned N = NStages = StageList.size();
215 for (unsigned i = 0; i < N;) {
217 const Record *Stage = StageList[i];
219 // Form string as ,{ cycles, u1 | u2 | ... | un, timeinc, kind }
220 int Cycles = Stage->getValueAsInt("Cycles");
221 ItinString += " { " + itostr(Cycles) + ", ";
224 const std::vector<Record*> &UnitList = Stage->getValueAsListOfDefs("Units");
227 for (unsigned j = 0, M = UnitList.size(); j < M;) {
228 // Add name and bitwise or
229 ItinString += UnitList[j]->getName();
230 if (++j < M) ItinString += " | ";
233 int TimeInc = Stage->getValueAsInt("TimeInc");
234 ItinString += ", " + itostr(TimeInc);
236 int Kind = Stage->getValueAsInt("Kind");
237 ItinString += ", (llvm::InstrStage::ReservationKinds)" + itostr(Kind);
241 if (++i < N) ItinString += ", ";
246 // FormItineraryOperandCycleString - Compose a string containing the
247 // operand cycle initialization for the specified itinerary. N is the
248 // number of operands that has cycles specified.
250 void SubtargetEmitter::FormItineraryOperandCycleString(Record *ItinData,
251 std::string &ItinString, unsigned &NOperandCycles) {
252 // Get operand cycle list
253 const std::vector<int64_t> &OperandCycleList =
254 ItinData->getValueAsListOfInts("OperandCycles");
256 // For each operand cycle
257 unsigned N = NOperandCycles = OperandCycleList.size();
258 for (unsigned i = 0; i < N;) {
259 // Next operand cycle
260 const int OCycle = OperandCycleList[i];
262 ItinString += " " + itostr(OCycle);
263 if (++i < N) ItinString += ", ";
268 // EmitStageAndOperandCycleData - Generate unique itinerary stages and
269 // operand cycle tables. Record itineraries for processors.
271 void SubtargetEmitter::EmitStageAndOperandCycleData(raw_ostream &OS,
272 unsigned NItinClasses,
273 std::map<std::string, unsigned> &ItinClassesMap,
274 std::vector<std::vector<InstrItinerary> > &ProcList) {
275 // Gather processor iteraries
276 std::vector<Record*> ProcItinList =
277 Records.getAllDerivedDefinitions("ProcessorItineraries");
279 // If just no itinerary then don't bother
280 if (ProcItinList.size() < 2) return;
282 // Begin stages table
283 std::string StageTable = "static const llvm::InstrStage Stages[] = {\n";
284 StageTable += " { 0, 0, 0, llvm::InstrStage::Required }, // No itinerary\n";
286 // Begin operand cycle table
287 std::string OperandCycleTable = "static const unsigned OperandCycles[] = {\n";
288 OperandCycleTable += " 0, // No itinerary\n";
290 unsigned StageCount = 1, OperandCycleCount = 1;
291 unsigned ItinStageEnum = 1, ItinOperandCycleEnum = 1;
292 std::map<std::string, unsigned> ItinStageMap, ItinOperandCycleMap;
293 for (unsigned i = 0, N = ProcItinList.size(); i < N; i++) {
295 Record *Proc = ProcItinList[i];
297 // Get processor itinerary name
298 const std::string &Name = Proc->getName();
301 if (Name == "NoItineraries") continue;
303 // Create and expand processor itinerary to cover all itinerary classes
304 std::vector<InstrItinerary> ItinList;
305 ItinList.resize(NItinClasses);
307 // Get itinerary data list
308 std::vector<Record*> ItinDataList = Proc->getValueAsListOfDefs("IID");
310 // For each itinerary data
311 for (unsigned j = 0, M = ItinDataList.size(); j < M; j++) {
312 // Next itinerary data
313 Record *ItinData = ItinDataList[j];
315 // Get string and stage count
316 std::string ItinStageString;
318 FormItineraryStageString(ItinData, ItinStageString, NStages);
320 // Get string and operand cycle count
321 std::string ItinOperandCycleString;
322 unsigned NOperandCycles;
323 FormItineraryOperandCycleString(ItinData, ItinOperandCycleString,
326 // Check to see if stage already exists and create if it doesn't
327 unsigned FindStage = 0;
329 FindStage = ItinStageMap[ItinStageString];
330 if (FindStage == 0) {
331 // Emit as { cycles, u1 | u2 | ... | un, timeinc }, // index
332 StageTable += ItinStageString + ", // " + itostr(ItinStageEnum) + "\n";
333 // Record Itin class number.
334 ItinStageMap[ItinStageString] = FindStage = StageCount;
335 StageCount += NStages;
340 // Check to see if operand cycle already exists and create if it doesn't
341 unsigned FindOperandCycle = 0;
342 if (NOperandCycles > 0) {
343 FindOperandCycle = ItinOperandCycleMap[ItinOperandCycleString];
344 if (FindOperandCycle == 0) {
345 // Emit as cycle, // index
346 OperandCycleTable += ItinOperandCycleString + ", // " +
347 itostr(ItinOperandCycleEnum) + "\n";
348 // Record Itin class number.
349 ItinOperandCycleMap[ItinOperandCycleString] =
350 FindOperandCycle = OperandCycleCount;
351 OperandCycleCount += NOperandCycles;
352 ItinOperandCycleEnum++;
356 // Set up itinerary as location and location + stage count
357 InstrItinerary Intinerary = { FindStage, FindStage + NStages,
358 FindOperandCycle, FindOperandCycle + NOperandCycles};
360 // Locate where to inject into processor itinerary table
361 const std::string &Name = ItinData->getValueAsDef("TheClass")->getName();
362 unsigned Find = ItinClassesMap[Name];
364 // Inject - empty slots will be 0, 0
365 ItinList[Find] = Intinerary;
368 // Add process itinerary to list
369 ProcList.push_back(ItinList);
373 StageTable += " { 0, 0, 0, llvm::InstrStage::Required } // End itinerary\n";
374 StageTable += "};\n";
376 // Closing operand cycles
377 OperandCycleTable += " 0 // End itinerary\n";
378 OperandCycleTable += "};\n";
382 OS << OperandCycleTable;
384 // Emit size of tables
386 OS<<" StagesSize = sizeof(Stages)/sizeof(llvm::InstrStage),\n";
387 OS<<" OperandCyclesSize = sizeof(OperandCycles)/sizeof(unsigned)\n";
392 // EmitProcessorData - Generate data for processor itineraries.
394 void SubtargetEmitter::EmitProcessorData(raw_ostream &OS,
395 std::vector<std::vector<InstrItinerary> > &ProcList) {
396 // Get an iterator for processor itinerary stages
397 std::vector<std::vector<InstrItinerary> >::iterator
398 ProcListIter = ProcList.begin();
400 // For each processor itinerary
401 std::vector<Record*> Itins =
402 Records.getAllDerivedDefinitions("ProcessorItineraries");
403 for (unsigned i = 0, N = Itins.size(); i < N; i++) {
405 Record *Itin = Itins[i];
407 // Get processor itinerary name
408 const std::string &Name = Itin->getName();
411 if (Name == "NoItineraries") continue;
413 // Begin processor itinerary table
415 OS << "static const llvm::InstrItinerary " << Name << "[] = {\n";
417 // For each itinerary class
418 std::vector<InstrItinerary> &ItinList = *ProcListIter++;
419 for (unsigned j = 0, M = ItinList.size(); j < M; ++j) {
420 InstrItinerary &Intinerary = ItinList[j];
422 // Emit in the form of
423 // { firstStage, lastStage, firstCycle, lastCycle } // index
424 if (Intinerary.FirstStage == 0) {
425 OS << " { 0, 0, 0, 0 }";
427 OS << " { " << Intinerary.FirstStage << ", " <<
428 Intinerary.LastStage << ", " <<
429 Intinerary.FirstOperandCycle << ", " <<
430 Intinerary.LastOperandCycle << " }";
433 OS << ", // " << j << "\n";
436 // End processor itinerary table
437 OS << " { ~0U, ~0U, ~0U, ~0U } // end marker\n";
443 // EmitProcessorLookup - generate cpu name to itinerary lookup table.
445 void SubtargetEmitter::EmitProcessorLookup(raw_ostream &OS) {
446 // Gather and sort processor information
447 std::vector<Record*> ProcessorList =
448 Records.getAllDerivedDefinitions("Processor");
449 std::sort(ProcessorList.begin(), ProcessorList.end(), LessRecordFieldName());
451 // Begin processor table
453 OS << "// Sorted (by key) array of itineraries for CPU subtype.\n"
454 << "static const llvm::SubtargetInfoKV ProcItinKV[] = {\n";
456 // For each processor
457 for (unsigned i = 0, N = ProcessorList.size(); i < N;) {
459 Record *Processor = ProcessorList[i];
461 const std::string &Name = Processor->getValueAsString("Name");
462 const std::string &ProcItin =
463 Processor->getValueAsDef("ProcItin")->getName();
465 // Emit as { "cpu", procinit },
467 << "\"" << Name << "\", "
468 << "(void *)&" << ProcItin;
472 // Depending on ''if more in the list'' emit comma
473 if (++i < N) OS << ",";
478 // End processor table
481 // Emit size of table
483 OS<<" ProcItinKVSize = sizeof(ProcItinKV)/"
484 "sizeof(llvm::SubtargetInfoKV)\n";
489 // EmitData - Emits all stages and itineries, folding common patterns.
491 void SubtargetEmitter::EmitData(raw_ostream &OS) {
492 std::map<std::string, unsigned> ItinClassesMap;
493 std::vector<std::vector<InstrItinerary> > ProcList;
495 // Enumerate all the itinerary classes
496 unsigned NItinClasses = CollectAllItinClasses(OS, ItinClassesMap);
497 // Make sure the rest is worth the effort
498 HasItineraries = NItinClasses != 1; // Ignore NoItinerary.
500 if (HasItineraries) {
501 // Emit the stage data
502 EmitStageAndOperandCycleData(OS, NItinClasses, ItinClassesMap, ProcList);
503 // Emit the processor itinerary data
504 EmitProcessorData(OS, ProcList);
505 // Emit the processor lookup data
506 EmitProcessorLookup(OS);
511 // ParseFeaturesFunction - Produces a subtarget specific function for parsing
512 // the subtarget features string.
514 void SubtargetEmitter::ParseFeaturesFunction(raw_ostream &OS) {
515 std::vector<Record*> Features =
516 Records.getAllDerivedDefinitions("SubtargetFeature");
517 std::sort(Features.begin(), Features.end(), LessRecord());
519 OS << "// ParseSubtargetFeatures - Parses features string setting specified\n"
520 << "// subtarget options.\n"
521 << "std::string llvm::";
523 OS << "Subtarget::ParseSubtargetFeatures(const std::string &FS,\n"
524 << " const std::string &CPU) {\n"
525 << " DEBUG(dbgs() << \"\\nFeatures:\" << FS);\n"
526 << " DEBUG(dbgs() << \"\\nCPU:\" << CPU);\n"
527 << " SubtargetFeatures Features(FS);\n"
528 << " Features.setCPUIfNone(CPU);\n"
529 << " uint32_t Bits = Features.getBits(SubTypeKV, SubTypeKVSize,\n"
530 << " FeatureKV, FeatureKVSize);\n";
532 for (unsigned i = 0; i < Features.size(); i++) {
534 Record *R = Features[i];
535 const std::string &Instance = R->getName();
536 const std::string &Value = R->getValueAsString("Value");
537 const std::string &Attribute = R->getValueAsString("Attribute");
539 if (Value=="true" || Value=="false")
540 OS << " if ((Bits & " << Instance << ") != 0) "
541 << Attribute << " = " << Value << ";\n";
543 OS << " if ((Bits & " << Instance << ") != 0 && " << Attribute <<
544 " < " << Value << ") " << Attribute << " = " << Value << ";\n";
547 if (HasItineraries) {
549 << " InstrItinerary *Itinerary = (InstrItinerary *)"
550 << "Features.getInfo(ProcItinKV, ProcItinKVSize);\n"
551 << " InstrItins = InstrItineraryData(Stages, OperandCycles, Itinerary);\n";
554 OS << " return Features.getCPU();\n"
559 // SubtargetEmitter::run - Main subtarget enumeration emitter.
561 void SubtargetEmitter::run(raw_ostream &OS) {
562 Target = CodeGenTarget().getName();
564 EmitSourceFileHeader("Subtarget Enumeration Source Fragment", OS);
566 OS << "#include \"llvm/Support/Debug.h\"\n";
567 OS << "#include \"llvm/Support/raw_ostream.h\"\n";
568 OS << "#include \"llvm/Target/SubtargetFeature.h\"\n";
569 OS << "#include \"llvm/Target/TargetInstrItineraries.h\"\n\n";
571 Enumeration(OS, "FuncUnit", true);
573 // Enumeration(OS, "InstrItinClass", false);
575 Enumeration(OS, "SubtargetFeature", true);
577 FeatureKeyValues(OS);
583 ParseFeaturesFunction(OS);