1 //===- SubtargetFeature.cpp - CPU characteristics Implementation ----------===//
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 file implements the SubtargetFeature interface.
12 //===----------------------------------------------------------------------===//
14 #include "llvm/MC/SubtargetFeature.h"
15 #include "llvm/Support/Debug.h"
16 #include "llvm/Support/raw_ostream.h"
17 #include "llvm/ADT/StringExtras.h"
24 //===----------------------------------------------------------------------===//
25 // Static Helper Functions
26 //===----------------------------------------------------------------------===//
28 /// hasFlag - Determine if a feature has a flag; '+' or '-'
30 static inline bool hasFlag(const StringRef Feature
) {
31 assert(!Feature
.empty() && "Empty string");
32 // Get first character
34 // Check if first character is '+' or '-' flag
35 return Ch
== '+' || Ch
=='-';
38 /// StripFlag - Return string stripped of flag.
40 static inline std::string
StripFlag(const StringRef Feature
) {
41 return hasFlag(Feature
) ? Feature
.substr(1) : Feature
;
44 /// isEnabled - Return true if enable flag; '+'.
46 static inline bool isEnabled(const StringRef Feature
) {
47 assert(!Feature
.empty() && "Empty string");
48 // Get first character
50 // Check if first character is '+' for enabled
54 /// PrependFlag - Return a string with a prepended flag; '+' or '-'.
56 static inline std::string
PrependFlag(const StringRef Feature
,
58 assert(!Feature
.empty() && "Empty string");
61 std::string Prefix
= IsEnabled
? "+" : "-";
66 /// Split - Splits a string of comma separated items in to a vector of strings.
68 static void Split(std::vector
<std::string
> &V
, const StringRef S
) {
72 // Start at beginning of string.
75 // Find the next comma
76 size_t Comma
= S
.find(',', Pos
);
77 // If no comma found then the rest of the string is used
78 if (Comma
== std::string::npos
) {
79 // Add string to vector
80 V
.push_back(S
.substr(Pos
));
83 // Otherwise add substring to vector
84 V
.push_back(S
.substr(Pos
, Comma
- Pos
));
85 // Advance to next item
90 /// Join a vector of strings to a string with a comma separating each element.
92 static std::string
Join(const std::vector
<std::string
> &V
) {
93 // Start with empty string.
95 // If the vector is not empty
97 // Start with the first feature
99 // For each successive feature
100 for (size_t i
= 1; i
< V
.size(); i
++) {
107 // Return the features string
112 void SubtargetFeatures::AddFeature(const StringRef String
,
114 // Don't add empty features
115 if (!String
.empty()) {
116 // Convert to lowercase, prepend flag and add to vector
117 Features
.push_back(PrependFlag(LowercaseString(String
), IsEnabled
));
121 /// Find KV in array using binary search.
122 template<typename T
> const T
*Find(const StringRef S
, const T
*A
, size_t L
) {
123 // Make the lower bound element we're looking for
126 // Determine the end of the array
128 // Binary search the array
129 const T
*F
= std::lower_bound(A
, Hi
, KV
);
130 // If not found then return NULL
131 if (F
== Hi
|| StringRef(F
->Key
) != S
) return NULL
;
132 // Return the found array item
136 /// getLongestEntryLength - Return the length of the longest entry in the table.
138 static size_t getLongestEntryLength(const SubtargetFeatureKV
*Table
,
141 for (size_t i
= 0; i
< Size
; i
++)
142 MaxLen
= std::max(MaxLen
, std::strlen(Table
[i
].Key
));
146 /// Display help for feature choices.
148 static void Help(const SubtargetFeatureKV
*CPUTable
, size_t CPUTableSize
,
149 const SubtargetFeatureKV
*FeatTable
, size_t FeatTableSize
) {
150 // Determine the length of the longest CPU and Feature entries.
151 unsigned MaxCPULen
= getLongestEntryLength(CPUTable
, CPUTableSize
);
152 unsigned MaxFeatLen
= getLongestEntryLength(FeatTable
, FeatTableSize
);
154 // Print the CPU table.
155 errs() << "Available CPUs for this target:\n\n";
156 for (size_t i
= 0; i
!= CPUTableSize
; i
++)
157 errs() << " " << CPUTable
[i
].Key
158 << std::string(MaxCPULen
- std::strlen(CPUTable
[i
].Key
), ' ')
159 << " - " << CPUTable
[i
].Desc
<< ".\n";
162 // Print the Feature table.
163 errs() << "Available features for this target:\n\n";
164 for (size_t i
= 0; i
!= FeatTableSize
; i
++)
165 errs() << " " << FeatTable
[i
].Key
166 << std::string(MaxFeatLen
- std::strlen(FeatTable
[i
].Key
), ' ')
167 << " - " << FeatTable
[i
].Desc
<< ".\n";
170 errs() << "Use +feature to enable a feature, or -feature to disable it.\n"
171 << "For example, llc -mcpu=mycpu -mattr=+feature1,-feature2\n";
175 //===----------------------------------------------------------------------===//
176 // SubtargetFeatures Implementation
177 //===----------------------------------------------------------------------===//
179 SubtargetFeatures::SubtargetFeatures(const StringRef Initial
) {
180 // Break up string into separate features
181 Split(Features
, Initial
);
185 std::string
SubtargetFeatures::getString() const {
186 return Join(Features
);
189 /// SetImpliedBits - For each feature that is (transitively) implied by this
193 void SetImpliedBits(uint64_t &Bits
, const SubtargetFeatureKV
*FeatureEntry
,
194 const SubtargetFeatureKV
*FeatureTable
,
195 size_t FeatureTableSize
) {
196 for (size_t i
= 0; i
< FeatureTableSize
; ++i
) {
197 const SubtargetFeatureKV
&FE
= FeatureTable
[i
];
199 if (FeatureEntry
->Value
== FE
.Value
) continue;
201 if (FeatureEntry
->Implies
& FE
.Value
) {
203 SetImpliedBits(Bits
, &FE
, FeatureTable
, FeatureTableSize
);
208 /// ClearImpliedBits - For each feature that (transitively) implies this
209 /// feature, clear it.
212 void ClearImpliedBits(uint64_t &Bits
, const SubtargetFeatureKV
*FeatureEntry
,
213 const SubtargetFeatureKV
*FeatureTable
,
214 size_t FeatureTableSize
) {
215 for (size_t i
= 0; i
< FeatureTableSize
; ++i
) {
216 const SubtargetFeatureKV
&FE
= FeatureTable
[i
];
218 if (FeatureEntry
->Value
== FE
.Value
) continue;
220 if (FE
.Implies
& FeatureEntry
->Value
) {
222 ClearImpliedBits(Bits
, &FE
, FeatureTable
, FeatureTableSize
);
227 /// ToggleFeature - Toggle a feature and returns the newly updated feature
230 SubtargetFeatures::ToggleFeature(uint64_t Bits
, const StringRef Feature
,
231 const SubtargetFeatureKV
*FeatureTable
,
232 size_t FeatureTableSize
) {
233 // Find feature in table.
234 const SubtargetFeatureKV
*FeatureEntry
=
235 Find(StripFlag(Feature
), FeatureTable
, FeatureTableSize
);
236 // If there is a match
238 if ((Bits
& FeatureEntry
->Value
) == FeatureEntry
->Value
) {
239 Bits
&= ~FeatureEntry
->Value
;
241 // For each feature that implies this, clear it.
242 ClearImpliedBits(Bits
, FeatureEntry
, FeatureTable
, FeatureTableSize
);
244 Bits
|= FeatureEntry
->Value
;
246 // For each feature that this implies, set it.
247 SetImpliedBits(Bits
, FeatureEntry
, FeatureTable
, FeatureTableSize
);
250 errs() << "'" << Feature
251 << "' is not a recognized feature for this target"
252 << " (ignoring feature)\n";
259 /// getFeatureBits - Get feature bits a CPU.
261 uint64_t SubtargetFeatures::getFeatureBits(const StringRef CPU
,
262 const SubtargetFeatureKV
*CPUTable
,
264 const SubtargetFeatureKV
*FeatureTable
,
265 size_t FeatureTableSize
) {
266 if (!FeatureTableSize
|| !CPUTableSize
)
270 for (size_t i
= 1; i
< CPUTableSize
; i
++) {
271 assert(strcmp(CPUTable
[i
- 1].Key
, CPUTable
[i
].Key
) < 0 &&
272 "CPU table is not sorted");
274 for (size_t i
= 1; i
< FeatureTableSize
; i
++) {
275 assert(strcmp(FeatureTable
[i
- 1].Key
, FeatureTable
[i
].Key
) < 0 &&
276 "CPU features table is not sorted");
279 uint64_t Bits
= 0; // Resulting bits
281 // Check if help is needed
283 Help(CPUTable
, CPUTableSize
, FeatureTable
, FeatureTableSize
);
285 // Find CPU entry if CPU name is specified.
287 const SubtargetFeatureKV
*CPUEntry
= Find(CPU
, CPUTable
, CPUTableSize
);
288 // If there is a match
290 // Set base feature bits
291 Bits
= CPUEntry
->Value
;
293 // Set the feature implied by this CPU feature, if any.
294 for (size_t i
= 0; i
< FeatureTableSize
; ++i
) {
295 const SubtargetFeatureKV
&FE
= FeatureTable
[i
];
296 if (CPUEntry
->Value
& FE
.Value
)
297 SetImpliedBits(Bits
, &FE
, FeatureTable
, FeatureTableSize
);
301 << "' is not a recognized processor for this target"
302 << " (ignoring processor)\n";
306 // Iterate through each feature
307 for (size_t i
= 0, E
= Features
.size(); i
< E
; i
++) {
308 const StringRef Feature
= Features
[i
];
311 if (Feature
== "+help")
312 Help(CPUTable
, CPUTableSize
, FeatureTable
, FeatureTableSize
);
314 // Find feature in table.
315 const SubtargetFeatureKV
*FeatureEntry
=
316 Find(StripFlag(Feature
), FeatureTable
, FeatureTableSize
);
317 // If there is a match
319 // Enable/disable feature in bits
320 if (isEnabled(Feature
)) {
321 Bits
|= FeatureEntry
->Value
;
323 // For each feature that this implies, set it.
324 SetImpliedBits(Bits
, FeatureEntry
, FeatureTable
, FeatureTableSize
);
326 Bits
&= ~FeatureEntry
->Value
;
328 // For each feature that implies this, clear it.
329 ClearImpliedBits(Bits
, FeatureEntry
, FeatureTable
, FeatureTableSize
);
332 errs() << "'" << Feature
333 << "' is not a recognized feature for this target"
334 << " (ignoring feature)\n";
341 /// Get scheduling itinerary of a CPU.
342 void *SubtargetFeatures::getItinerary(const StringRef CPU
,
343 const SubtargetInfoKV
*Table
,
345 assert(Table
&& "missing table");
347 for (size_t i
= 1; i
< TableSize
; i
++) {
348 assert(strcmp(Table
[i
- 1].Key
, Table
[i
].Key
) < 0 && "Table is not sorted");
353 const SubtargetInfoKV
*Entry
= Find(CPU
, Table
, TableSize
);
359 << "' is not a recognized processor for this target"
360 << " (ignoring processor)\n";
365 /// print - Print feature string.
367 void SubtargetFeatures::print(raw_ostream
&OS
) const {
368 for (size_t i
= 0, e
= Features
.size(); i
!= e
; ++i
)
369 OS
<< Features
[i
] << " ";
373 /// dump - Dump feature info.
375 void SubtargetFeatures::dump() const {
379 /// getDefaultSubtargetFeatures - Return a string listing the features
380 /// associated with the target triple.
382 /// FIXME: This is an inelegant way of specifying the features of a
383 /// subtarget. It would be better if we could encode this information
384 /// into the IR. See <rdar://5972456>.
386 void SubtargetFeatures::getDefaultSubtargetFeatures(const Triple
& Triple
) {
387 if (Triple
.getVendor() == Triple::Apple
) {
388 if (Triple
.getArch() == Triple::ppc
) {
390 AddFeature("altivec");
391 } else if (Triple
.getArch() == Triple::ppc64
) {
394 AddFeature("altivec");