mirror of
https://github.com/c64scene-ar/llvm-6502.git
synced 2024-08-25 00:29:20 +00:00
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@16019 91177308-0d34-0410-b5e6-96231b3b80d8
227 lines
9.0 KiB
C++
227 lines
9.0 KiB
C++
//===- CompilerDriver.h - Compiler Driver -----------------------*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file was developed by Reid Spencer and is distributed under the
|
|
// University of Illinois Open Source License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This file declares the CompilerDriver class which implements the bulk of the
|
|
// LLVM Compiler Driver program (llvmc).
|
|
//
|
|
//===------------------------------------------------------------------------===
|
|
#ifndef LLVM_TOOLS_LLVMC_COMPILERDRIVER_H
|
|
#define LLVM_TOOLS_LLVMC_COMPILERDRIVER_H
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
namespace llvm {
|
|
/// This class provides the high level interface to the LLVM Compiler Driver.
|
|
/// The driver's purpose is to make it easier for compiler writers and users
|
|
/// of LLVM to utilize the compiler toolkits and LLVM toolset by learning only
|
|
/// the interface of one program (llvmc).
|
|
///
|
|
/// @see llvmc.cpp
|
|
/// @brief The interface to the LLVM Compiler Driver.
|
|
class CompilerDriver {
|
|
/// @name Types
|
|
/// @{
|
|
public:
|
|
/// @brief A vector of strings, commonly used
|
|
typedef std::vector<std::string> StringVector;
|
|
|
|
/// @brief A table of strings, indexed typically by Phases
|
|
typedef std::vector<StringVector> StringTable;
|
|
|
|
/// @brief The phases of processing that llvmc understands
|
|
enum Phases {
|
|
PREPROCESSING, ///< Source language combining, filtering, substitution
|
|
TRANSLATION, ///< Translate source -> LLVM bytecode/assembly
|
|
OPTIMIZATION, ///< Optimize translation result
|
|
ASSEMBLY, ///< Convert program to executable
|
|
LINKING, ///< Link bytecode and native code
|
|
NUM_PHASES ///< Always last!
|
|
};
|
|
|
|
/// @brief The levels of optimization llvmc understands
|
|
enum OptimizationLevels {
|
|
OPT_FAST_COMPILE, ///< Optimize to make >compile< go faster
|
|
OPT_SIMPLE, ///< Standard/simple optimizations
|
|
OPT_AGGRESSIVE, ///< Aggressive optimizations
|
|
OPT_LINK_TIME, ///< Aggressive + LinkTime optimizations
|
|
OPT_AGGRESSIVE_LINK_TIME, ///< Make it go way fast!
|
|
OPT_NONE ///< No optimizations. Keep this at the end!
|
|
};
|
|
|
|
/// @brief Action specific flags
|
|
enum ConfigurationFlags {
|
|
REQUIRED_FLAG = 0x0001, ///< Should the action always be run?
|
|
PREPROCESSES_FLAG = 0x0002, ///< Does this action preprocess?
|
|
TRANSLATES_FLAG = 0x0004, ///< Does this action translate?
|
|
OUTPUT_IS_ASM_FLAG = 0x0008, ///< Action produces .ll files?
|
|
FLAGS_MASK = 0x000F, ///< Union of all flags
|
|
};
|
|
|
|
/// This type is the input list to the CompilerDriver. It provides
|
|
/// a vector of filename/filetype pairs. The filetype is used to look up
|
|
/// the configuration of the actions to be taken by the driver.
|
|
/// @brief The Input Data to the execute method
|
|
typedef std::vector<std::pair<std::string,std::string> > InputList;
|
|
|
|
/// This type is read from configuration files or otherwise provided to
|
|
/// the CompilerDriver through a "ConfigDataProvider". It serves as both
|
|
/// the template of what to do and the actual Action to be executed.
|
|
/// @brief A structure to hold the action data for a given source
|
|
/// language.
|
|
struct Action {
|
|
Action() : flags(0) {}
|
|
std::string program; ///< The program to execve
|
|
StringVector args; ///< Arguments to the program
|
|
unsigned flags; ///< Action specific flags
|
|
void set(unsigned fl ) { flags |= fl; }
|
|
void clear(unsigned fl) { flags &= (FLAGS_MASK ^ fl); }
|
|
bool isSet(unsigned fl) { return (flags&fl) != 0; }
|
|
};
|
|
|
|
struct ConfigData {
|
|
ConfigData();
|
|
std::string version; ///< The version number.
|
|
std::string langName; ///< The name of the source language
|
|
StringTable opts; ///< The o10n options for each level
|
|
Action PreProcessor; ///< PreProcessor command line
|
|
Action Translator; ///< Translator command line
|
|
Action Optimizer; ///< Optimizer command line
|
|
Action Assembler; ///< Assembler command line
|
|
Action Linker; ///< Linker command line
|
|
};
|
|
|
|
/// This pure virtual interface class defines the interface between the
|
|
/// CompilerDriver and other software that provides ConfigData objects to
|
|
/// it. The CompilerDriver must be configured to use an object of this
|
|
/// type so it can obtain the configuration data.
|
|
/// @see setConfigDataProvider
|
|
/// @brief Configuration Data Provider interface
|
|
class ConfigDataProvider {
|
|
public:
|
|
virtual ConfigData* ProvideConfigData(const std::string& filetype) = 0;
|
|
virtual void setConfigDir(const std::string& dirName) = 0;
|
|
};
|
|
|
|
/// @}
|
|
/// @name Constructors
|
|
/// @{
|
|
public:
|
|
CompilerDriver(ConfigDataProvider& cdp );
|
|
virtual ~CompilerDriver();
|
|
|
|
/// @}
|
|
/// @name Methods
|
|
/// @{
|
|
public:
|
|
/// @brief Handle an error
|
|
virtual void error(const std::string& errmsg);
|
|
|
|
/// @brief Execute the actions requested for the given input list.
|
|
virtual int execute(const InputList& list, const std::string& output);
|
|
|
|
/// @}
|
|
/// @name Mutators
|
|
/// @{
|
|
public:
|
|
/// @brief Set the final phase at which compilation terminates
|
|
void setFinalPhase( Phases phase ) { finalPhase = phase; }
|
|
|
|
/// @brief Set the optimization level for the compilation
|
|
void setOptimization( OptimizationLevels level ) { optLevel = level; }
|
|
|
|
/// @brief Prevent the CompilerDriver from taking any actions
|
|
void setDryRun( bool TF ) { isDryRun = TF; }
|
|
|
|
/// @brief Cause the CompilerDriver to print to stderr all the
|
|
/// actions it is taking.
|
|
void setVerbose( bool TF ) { isVerbose = TF; }
|
|
|
|
/// @brief Cause the CompilerDriver to print to stderr very verbose
|
|
/// information that might be useful in debugging the driver's actions
|
|
void setDebug( bool TF ) { isDebug = TF; }
|
|
|
|
/// @brief Cause the CompilerDriver to print to stderr the
|
|
/// execution time of each action taken.
|
|
void setTimeActions( bool TF ) { timeActions = TF; }
|
|
|
|
/// @brief Cause the CompilerDriver to print timings for each pass.
|
|
void setTimePasses( bool TF ) { timePasses = TF; }
|
|
|
|
/// @brief Cause the CompilerDriver to show statistics gathered
|
|
void setShowStats( bool TF ) { showStats = TF; }
|
|
|
|
/// @brief Indicate that native code is to be generated instead
|
|
/// of LLVM bytecode.
|
|
void setEmitNativeCode( bool TF ) { emitNativeCode = TF; }
|
|
|
|
/// @brief Indicate that raw, unoptimized code is to be generated.
|
|
void setEmitRawCode(bool TF ) { emitRawCode = TF; }
|
|
|
|
void setKeepTemporaries(bool TF) { keepTemps = TF; }
|
|
|
|
/// @brief Set the output machine name.
|
|
void setOutputMachine( const std::string& machineName ) {
|
|
machine = machineName;
|
|
}
|
|
|
|
/// @brief Set Preprocessor specific options
|
|
void setPhaseArgs(Phases phase, const std::vector<std::string>& opts) {
|
|
assert(phase <= LINKING && phase >= PREPROCESSING);
|
|
AdditionalArgs[phase] = opts;
|
|
}
|
|
|
|
/// @brief Set Library Paths
|
|
void setLibraryPaths(const std::vector<std::string>& paths) {
|
|
LibraryPaths = paths;
|
|
}
|
|
|
|
/// @brief Set the list of library paths to be searched for
|
|
/// libraries.
|
|
void addLibraryPath( const std::string& libPath ) {
|
|
LibraryPaths.push_back(libPath);
|
|
}
|
|
|
|
/// @}
|
|
/// @name Functions
|
|
/// @{
|
|
private:
|
|
Action* GetAction(ConfigData* cd, const std::string& input,
|
|
const std::string& output, Phases phase );
|
|
bool DoAction(Action* a);
|
|
|
|
/// @}
|
|
/// @name Data
|
|
/// @{
|
|
private:
|
|
ConfigDataProvider* cdp; ///< Where we get configuration data from
|
|
Phases finalPhase; ///< The final phase of compilation
|
|
OptimizationLevels optLevel; ///< The optimization level to apply
|
|
bool isDryRun; ///< Prevent actions ?
|
|
bool isVerbose; ///< Print actions?
|
|
bool isDebug; ///< Print lotsa debug info?
|
|
bool timeActions; ///< Time the actions executed ?
|
|
bool timePasses; ///< Time each pass and print timing ?
|
|
bool showStats; ///< Show gathered statistics ?
|
|
bool emitRawCode; ///< Emit Raw (unoptimized) code?
|
|
bool emitNativeCode; ///< Emit native code instead of bytecode?
|
|
bool keepTemps; ///< Keep temporary files?
|
|
std::string machine; ///< Target machine name
|
|
StringVector LibraryPaths; ///< -L options
|
|
StringTable AdditionalArgs; ///< The -Txyz options
|
|
std::string TempDir; ///< Name of the temporary directory.
|
|
|
|
/// @}
|
|
|
|
};
|
|
}
|
|
|
|
// vim: sw=2 smartindent smarttab tw=80 autoindent expandtab
|
|
#endif
|