1 //===-- Target/TargetRegistry.h - Target Registration -----------*- C++ -*-===//
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 exposes the TargetRegistry interface, which tools can use to access
11 // the appropriate target specific classes (TargetMachine, AsmPrinter, etc.)
12 // which have been registered.
14 // Target specific class implementations should register themselves using the
15 // appropriate TargetRegistry interfaces.
17 //===----------------------------------------------------------------------===//
19 #ifndef LLVM_TARGET_TARGETREGISTRY_H
20 #define LLVM_TARGET_TARGETREGISTRY_H
28 class TargetAsmParser;
30 class formatted_raw_ostream;
32 /// Target - Wrapper for Target specific information.
34 /// For registration purposes, this is a POD type so that targets can be
35 /// registered without the use of static constructors.
37 /// Targets should implement a single global instance of this class (which
38 /// will be zero initialized), and pass that instance to the TargetRegistry as
39 /// part of their initialization.
42 typedef unsigned (*TripleMatchQualityFnTy)(const std::string &TT);
43 typedef unsigned (*ModuleMatchQualityFnTy)(const Module &M);
44 typedef unsigned (*JITMatchQualityFnTy)();
46 typedef TargetMachine *(*TargetMachineCtorTy)(const Target &,
49 typedef FunctionPass *(*AsmPrinterCtorTy)(formatted_raw_ostream &,
52 typedef TargetAsmParser *(*AsmParserCtorTy)(const Target &);
54 friend struct TargetRegistry;
56 /// Next - The next registered target in the linked list, maintained by the
60 /// TripleMatchQualityFn - The target function for rating the match quality
62 TripleMatchQualityFnTy TripleMatchQualityFn;
64 /// ModuleMatchQualityFn - The target function for rating the match quality
66 ModuleMatchQualityFnTy ModuleMatchQualityFn;
68 /// JITMatchQualityFn - The target function for rating the match quality
70 JITMatchQualityFnTy JITMatchQualityFn;
72 /// Name - The target name.
75 /// ShortDesc - A short description of the target.
76 const char *ShortDesc;
78 /// TargetMachineCtorFn - Construction function for this target's
79 /// TargetMachine, if registered.
80 TargetMachineCtorTy TargetMachineCtorFn;
82 /// AsmPrinterCtorFn - Construction function for this target's AsmPrinter,
84 AsmPrinterCtorTy AsmPrinterCtorFn;
86 /// AsmParserCtorFn - Construction function for this target's AsmParser,
88 AsmParserCtorTy AsmParserCtorFn;
91 // getNext - Return the next registered target.
92 const Target *getNext() const { return Next; }
94 /// getName - Get the target name.
95 const char *getName() const { return Name; }
97 /// getShortDescription - Get a short description of the target.
98 const char *getShortDescription() const { return ShortDesc; }
100 /// getJITMatchQuality - Get the quality of this targets match for use as a
102 unsigned getJITMatchQuality() const { return JITMatchQualityFn(); }
104 /// hasTargetMachine - Check if this target supports code generation.
105 bool hasTargetMachine() const { return TargetMachineCtorFn != 0; }
107 /// hasAsmPrinter - Check if this target supports .s printing.
108 bool hasAsmPrinter() const { return AsmPrinterCtorFn != 0; }
110 /// hasAsmParser - Check if this target supports .s parsing.
111 bool hasAsmParser() const { return AsmParserCtorFn != 0; }
113 /// createTargetMachine - Create a target specific machine implementation.
114 TargetMachine *createTargetMachine(const Module &M,
115 const std::string &Features) const {
116 if (!TargetMachineCtorFn)
118 return TargetMachineCtorFn(*this, M, Features);
121 /// createAsmPrinter - Create a target specific assembly printer pass.
122 FunctionPass *createAsmPrinter(formatted_raw_ostream &OS,
124 bool Verbose) const {
125 if (!AsmPrinterCtorFn)
127 return AsmPrinterCtorFn(OS, M, Verbose);
130 /// createAsmParser - Create a target specific assembly parser.
131 TargetAsmParser *createAsmParser() const {
132 if (!AsmParserCtorFn)
134 return AsmParserCtorFn(*this);
138 /// TargetRegistry - Generic interface to target specific features.
140 // FIXME: Provide Target* iterator.
141 struct TargetRegistry {
143 const Target *Current;
144 explicit iterator(Target *T) : Current(T) {}
145 friend struct TargetRegistry;
147 iterator(const iterator &I) : Current(I.Current) {}
148 iterator() : Current(0) {}
150 bool operator==(const iterator &x) const {
151 return Current == x.Current;
153 bool operator!=(const iterator &x) const {
154 return !operator==(x);
157 // Iterator traversal: forward iteration only
158 iterator &operator++() { // Preincrement
159 assert(Current && "Cannot increment end iterator!");
160 Current = Current->getNext();
163 iterator operator++(int) { // Postincrement
164 iterator tmp = *this;
169 const Target &operator*() const {
170 assert(Current && "Cannot dereference end iterator!");
174 const Target *operator->() const {
179 /// @name Registry Access
182 static iterator begin();
184 static iterator end() { return iterator(); }
186 /// getClosestStaticTargetForTriple - Given a target triple, pick the most
187 /// capable target for that triple.
188 static const Target *getClosestStaticTargetForTriple(const std::string &TT,
191 /// getClosestStaticTargetForModule - Given an LLVM module, pick the best
192 /// target that is compatible with the module. If no close target can be
193 /// found, this returns null and sets the Error string to a reason.
194 static const Target *getClosestStaticTargetForModule(const Module &M,
197 /// getClosestTargetForJIT - Pick the best target that is compatible with
198 /// the current host. If no close target can be found, this returns null
199 /// and sets the Error string to a reason.
201 // FIXME: Do we still need this interface, clients can always look for the
202 // match for the host triple.
203 static const Target *getClosestTargetForJIT(std::string &Error);
206 /// @name Target Registration
209 /// RegisterTarget - Register the given target. Attempts to register a
210 /// target which has already been registered will be ignored.
212 /// Clients are responsible for ensuring that registration doesn't occur
213 /// while another thread is attempting to access the registry. Typically
214 /// this is done by initializing all targets at program startup.
216 /// @param T - The target being registered.
217 /// @param Name - The target name. This should be a static string.
218 /// @param ShortDesc - A short target description. This should be a static
220 /// @param TQualityFn - The triple match quality computation function for
222 /// @param MQualityFn - The module match quality computation function for
224 /// @param JITMatchQualityFn - The JIT match quality computation function
226 static void RegisterTarget(Target &T,
228 const char *ShortDesc,
229 Target::TripleMatchQualityFnTy TQualityFn,
230 Target::ModuleMatchQualityFnTy MQualityFn,
231 Target::JITMatchQualityFnTy JITQualityFn);
233 /// RegisterTargetMachine - Register a TargetMachine implementation for the
236 /// Clients are responsible for ensuring that registration doesn't occur
237 /// while another thread is attempting to access the registry. Typically
238 /// this is done by initializing all targets at program startup.
240 /// @param T - The target being registered.
241 /// @param Fn - A function to construct a TargetMachine for the target.
242 static void RegisterTargetMachine(Target &T,
243 Target::TargetMachineCtorTy Fn) {
244 // Ignore duplicate registration.
245 if (!T.TargetMachineCtorFn)
246 T.TargetMachineCtorFn = Fn;
249 /// RegisterAsmPrinter - Register an AsmPrinter implementation for the given
252 /// Clients are responsible for ensuring that registration doesn't occur
253 /// while another thread is attempting to access the registry. Typically
254 /// this is done by initializing all targets at program startup.
256 /// @param T - The target being registered.
257 /// @param Fn - A function to construct an AsmPrinter for the target.
258 static void RegisterAsmPrinter(Target &T, Target::AsmPrinterCtorTy Fn) {
259 // Ignore duplicate registration.
260 if (!T.AsmPrinterCtorFn)
261 T.AsmPrinterCtorFn = Fn;
264 /// RegisterAsmParser - Register a TargetAsmParser implementation for the
267 /// Clients are responsible for ensuring that registration doesn't occur
268 /// while another thread is attempting to access the registry. Typically
269 /// this is done by initializing all targets at program startup.
271 /// @param T - The target being registered.
272 /// @param Fn - A function to construct an AsmPrinter for the target.
273 static void RegisterAsmParser(Target &T, Target::AsmParserCtorTy Fn) {
274 if (!T.AsmParserCtorFn)
275 T.AsmParserCtorFn = Fn;