2011-06-29 03:14:12 +02:00
|
|
|
//===-- llvm/MC/SubtargetFeature.h - CPU characteristics --------*- C++ -*-===//
|
2005-09-01 23:36:18 +02:00
|
|
|
//
|
|
|
|
// The LLVM Compiler Infrastructure
|
|
|
|
//
|
2007-12-29 20:59:42 +01:00
|
|
|
// This file is distributed under the University of Illinois Open Source
|
|
|
|
// License. See LICENSE.TXT for details.
|
2005-09-01 23:36:18 +02:00
|
|
|
//
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
//
|
|
|
|
// This file defines and manages user or tool specified CPU characteristics.
|
|
|
|
// The intent is to be able to package specific features that should or should
|
|
|
|
// not be used on a specific target processor. A tool, such as llc, could, as
|
|
|
|
// as example, gather chip info from the command line, a long with features
|
|
|
|
// that should be used on that chip.
|
|
|
|
//
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
|
2011-06-29 03:14:12 +02:00
|
|
|
#ifndef LLVM_MC_SUBTARGETFEATURE_H
|
|
|
|
#define LLVM_MC_SUBTARGETFEATURE_H
|
2005-09-01 23:36:18 +02:00
|
|
|
|
2014-05-06 22:23:04 +02:00
|
|
|
#include "llvm/ADT/ArrayRef.h"
|
2009-11-18 21:20:05 +01:00
|
|
|
#include "llvm/ADT/Triple.h"
|
2010-11-29 19:16:10 +01:00
|
|
|
#include "llvm/Support/DataTypes.h"
|
2015-05-26 12:47:10 +02:00
|
|
|
#include <bitset>
|
2005-09-01 23:36:18 +02:00
|
|
|
|
|
|
|
namespace llvm {
|
2009-08-23 23:41:43 +02:00
|
|
|
class raw_ostream;
|
2011-07-01 02:23:10 +02:00
|
|
|
class StringRef;
|
2012-05-11 03:39:13 +02:00
|
|
|
|
2015-05-26 12:47:10 +02:00
|
|
|
// A container class for subtarget features.
|
|
|
|
// This is convenient because std::bitset does not have a constructor
|
|
|
|
// with an initializer list of set bits.
|
|
|
|
const unsigned MAX_SUBTARGET_FEATURES = 64;
|
|
|
|
class FeatureBitset : public std::bitset<MAX_SUBTARGET_FEATURES> {
|
|
|
|
public:
|
|
|
|
// Cannot inherit constructors because it's not supported by VC++..
|
|
|
|
FeatureBitset() : bitset() {}
|
|
|
|
|
|
|
|
FeatureBitset(const bitset<MAX_SUBTARGET_FEATURES>& B) : bitset(B) {}
|
|
|
|
|
|
|
|
FeatureBitset(std::initializer_list<unsigned> Init) : bitset() {
|
|
|
|
for (auto I = Init.begin() , E = Init.end(); I != E; ++I)
|
|
|
|
set(*I);
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2005-09-01 23:36:18 +02:00
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
///
|
|
|
|
/// SubtargetFeatureKV - Used to provide key value pairs for feature and
|
|
|
|
/// CPU bit flags.
|
|
|
|
//
|
|
|
|
struct SubtargetFeatureKV {
|
|
|
|
const char *Key; // K-V key string
|
2005-09-02 21:27:43 +02:00
|
|
|
const char *Desc; // Help descriptor
|
2015-05-26 12:47:10 +02:00
|
|
|
FeatureBitset Value; // K-V integer value
|
|
|
|
FeatureBitset Implies; // K-V bit mask
|
2012-05-11 03:39:13 +02:00
|
|
|
|
2013-10-14 00:09:26 +02:00
|
|
|
// Compare routine for std::lower_bound
|
|
|
|
bool operator<(StringRef S) const {
|
|
|
|
return StringRef(Key) < S;
|
2005-09-01 23:36:18 +02:00
|
|
|
}
|
|
|
|
};
|
2012-05-11 03:39:13 +02:00
|
|
|
|
2005-10-25 17:15:28 +02:00
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
///
|
|
|
|
/// SubtargetInfoKV - Used to provide key value pairs for CPU and arbitrary
|
|
|
|
/// pointers.
|
|
|
|
//
|
|
|
|
struct SubtargetInfoKV {
|
|
|
|
const char *Key; // K-V key string
|
2012-09-05 23:43:57 +02:00
|
|
|
const void *Value; // K-V pointer value
|
2012-05-11 03:39:13 +02:00
|
|
|
|
2013-10-14 00:09:26 +02:00
|
|
|
// Compare routine for std::lower_bound
|
|
|
|
bool operator<(StringRef S) const {
|
|
|
|
return StringRef(Key) < S;
|
2005-10-25 17:15:28 +02:00
|
|
|
}
|
|
|
|
};
|
2012-05-11 03:39:13 +02:00
|
|
|
|
2005-09-01 23:36:18 +02:00
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
///
|
2012-05-11 03:39:13 +02:00
|
|
|
/// SubtargetFeatures - Manages the enabling and disabling of subtarget
|
2005-09-01 23:36:18 +02:00
|
|
|
/// specific features. Features are encoded as a string of the form
|
2013-04-08 20:52:58 +02:00
|
|
|
/// "+attr1,+attr2,-attr3,...,+attrN"
|
2005-09-01 23:36:18 +02:00
|
|
|
/// A comma separates each feature from the next (all lowercase.)
|
|
|
|
/// Each of the remaining features is prefixed with + or - indicating whether
|
|
|
|
/// that feature should be enabled or disabled contrary to the cpu
|
|
|
|
/// specification.
|
|
|
|
///
|
|
|
|
|
|
|
|
class SubtargetFeatures {
|
|
|
|
std::vector<std::string> Features; // Subtarget features as a vector
|
|
|
|
public:
|
2014-08-30 18:48:02 +02:00
|
|
|
explicit SubtargetFeatures(StringRef Initial = "");
|
2005-09-01 23:36:18 +02:00
|
|
|
|
|
|
|
/// Features string accessors.
|
2011-07-01 06:40:50 +02:00
|
|
|
std::string getString() const;
|
2005-09-01 23:36:18 +02:00
|
|
|
|
|
|
|
/// Adding Features.
|
2015-03-31 07:52:57 +02:00
|
|
|
void AddFeature(StringRef String, bool Enable = true);
|
2012-05-11 03:39:13 +02:00
|
|
|
|
2011-07-09 07:47:46 +02:00
|
|
|
/// ToggleFeature - Toggle a feature and returns the newly updated feature
|
|
|
|
/// bits.
|
2015-05-26 12:47:10 +02:00
|
|
|
FeatureBitset ToggleFeature(FeatureBitset Bits, StringRef String,
|
2014-05-06 22:23:04 +02:00
|
|
|
ArrayRef<SubtargetFeatureKV> FeatureTable);
|
2012-05-11 03:39:13 +02:00
|
|
|
|
2011-06-30 03:53:36 +02:00
|
|
|
/// Get feature bits of a CPU.
|
2015-05-26 12:47:10 +02:00
|
|
|
FeatureBitset getFeatureBits(StringRef CPU,
|
2014-05-06 22:23:04 +02:00
|
|
|
ArrayRef<SubtargetFeatureKV> CPUTable,
|
|
|
|
ArrayRef<SubtargetFeatureKV> FeatureTable);
|
2012-05-11 03:39:13 +02:00
|
|
|
|
2005-09-01 23:36:18 +02:00
|
|
|
/// Print feature string.
|
2009-08-23 23:41:43 +02:00
|
|
|
void print(raw_ostream &OS) const;
|
2012-05-11 03:39:13 +02:00
|
|
|
|
2005-09-01 23:36:18 +02:00
|
|
|
// Dump feature info.
|
|
|
|
void dump() const;
|
2009-11-18 21:20:05 +01:00
|
|
|
|
2013-10-07 15:34:05 +02:00
|
|
|
/// Adds the default features for the specified target triple.
|
2011-06-30 03:53:36 +02:00
|
|
|
void getDefaultSubtargetFeatures(const Triple& Triple);
|
2005-09-01 23:36:18 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
} // End namespace llvm
|
|
|
|
|
|
|
|
#endif
|