/*========================================================================= Program: CMake - Cross-Platform Makefile Generator Module: $RCSfile$ Language: C++ Date: $Date$ Version: $Revision$ Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved. See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details. This software is distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the above copyright notices for more information. =========================================================================*/ #ifndef cmMakefile_h #define cmMakefile_h #include "cmCacheManager.h" #include "cmData.h" #include "cmExecutionStatus.h" #include "cmListFileCache.h" #include "cmPolicies.h" #include "cmPropertyMap.h" #include "cmSystemTools.h" #include "cmTarget.h" #include "cmake.h" #if defined(CMAKE_BUILD_WITH_CMAKE) #include "cmSourceGroup.h" #endif #include class cmFunctionBlocker; class cmCommand; class cmInstallGenerator; class cmLocalGenerator; class cmMakeDepend; class cmSourceFile; class cmTest; class cmVariableWatch; class cmake; class cmMakefileCall; /** \class cmMakefile * \brief Process the input CMakeLists.txt file. * * Process and store into memory the input CMakeLists.txt file. * Each CMakeLists.txt file is parsed and the commands found there * are added into the build process. */ class cmMakefile { public: /** * Return the major and minor version of the cmake that * was used to write the currently loaded cache, note * this method will not work before the cache is loaded. */ unsigned int GetCacheMajorVersion(); unsigned int GetCacheMinorVersion(); /** Return whether compatibility features needed for a version of the cache or lower should be enabled. */ bool NeedCacheCompatibility(int major, int minor); /** * Construct an empty makefile. */ cmMakefile(); cmMakefile(const cmMakefile& mf); /** * Destructor. */ ~cmMakefile(); /** * Read and parse a CMakeLists.txt file. */ bool ReadListFile(const char* listfile, const char* external= 0, std::string* fullPath= 0); /** * Add a function blocker to this makefile */ void AddFunctionBlocker(cmFunctionBlocker *fb) { this->FunctionBlockers.push_back(fb);} void RemoveFunctionBlocker(cmFunctionBlocker *fb) { this->FunctionBlockers.remove(fb);} void RemoveFunctionBlocker(const cmListFileFunction& lff); /** * Try running cmake and building a file. This is used for dynalically * loaded commands, not as part of the usual build process. */ int TryCompile(const char *srcdir, const char *bindir, const char *projectName, const char *targetName, const std::vector *cmakeArgs, std::string *output); /** * Specify the makefile generator. This is platform/compiler * dependent, although the interface is through a generic * superclass. */ void SetLocalGenerator(cmLocalGenerator*); ///! Get the current makefile generator. cmLocalGenerator* GetLocalGenerator() { return this->LocalGenerator;} /** * Test whether compatibility is set to a given version or lower. */ bool NeedBackwardsCompatibility(unsigned int major, unsigned int minor, unsigned int patch = 0xFFu); /** * Help enforce global target name uniqueness. */ bool EnforceUniqueName(std::string const& name, std::string& msg, bool isCustom = false); /** * Perform FinalPass, Library dependency analysis etc before output of the * makefile. */ void ConfigureFinalPass(); /** * run the final pass on all commands. */ void FinalPass(); /** * Print the object state to std::cout. */ void Print(); /** Add a custom command to the build. */ void AddCustomCommandToTarget(const char* target, const std::vector& depends, const cmCustomCommandLines& commandLines, cmTarget::CustomCommandType type, const char* comment, const char* workingDir, bool escapeOldStyle = true); void AddCustomCommandToOutput(const std::vector& outputs, const std::vector& depends, const char* main_dependency, const cmCustomCommandLines& commandLines, const char* comment, const char* workingDir, bool replace = false, bool escapeOldStyle = true); void AddCustomCommandToOutput(const char* output, const std::vector& depends, const char* main_dependency, const cmCustomCommandLines& commandLines, const char* comment, const char* workingDir, bool replace = false, bool escapeOldStyle = true); void AddCustomCommandOldStyle(const char* target, const std::vector& outputs, const std::vector& depends, const char* source, const cmCustomCommandLines& commandLines, const char* comment); /** * Add a define flag to the build. */ void AddDefineFlag(const char* definition); void RemoveDefineFlag(const char* definition); /** Create a new imported target with the name and type given. */ cmTarget* AddImportedTarget(const char* name, cmTarget::TargetType type); cmTarget* AddNewTarget(cmTarget::TargetType type, const char* name); /** * Add an executable to the build. */ cmTarget* AddExecutable(const char *exename, const std::vector &srcs, bool excludeFromAll = false); /** * Add a utility to the build. A utiltity target is a command that * is run every time the target is built. */ void AddUtilityCommand(const char* utilityName, bool excludeFromAll, const std::vector& depends, const char* workingDirectory, const char* command, const char* arg1=0, const char* arg2=0, const char* arg3=0, const char* arg4=0); void AddUtilityCommand(const char* utilityName, bool excludeFromAll, const char* workingDirectory, const std::vector& depends, const cmCustomCommandLines& commandLines, bool escapeOldStyle = true, const char* comment = 0); /** * Add a link library to the build. */ void AddLinkLibrary(const char*); void AddLinkLibrary(const char*, cmTarget::LinkLibraryType type); void AddLinkLibraryForTarget(const char *tgt, const char*, cmTarget::LinkLibraryType type); void AddLinkDirectoryForTarget(const char *tgt, const char* d); /** * Add a link directory to the build. */ void AddLinkDirectory(const char*); /** * Get the list of link directories */ std::vector& GetLinkDirectories() { return this->LinkDirectories; } const std::vector& GetLinkDirectories() const { return this->LinkDirectories; } void SetLinkDirectories(const std::vector& vec) { this->LinkDirectories = vec; } /** * Add a subdirectory to the build. */ void AddSubDirectory(const char*, bool excludeFromAll=false, bool preorder = false); void AddSubDirectory(const char* fullSrcDir,const char *fullBinDir, bool excludeFromAll, bool preorder, bool immediate); /** * Configure a subdirectory */ void ConfigureSubDirectory(cmLocalGenerator *); /** * Add an include directory to the build. */ void AddIncludeDirectory(const char*, bool before = false); /** * Add a variable definition to the build. This variable * can be used in CMake to refer to lists, directories, etc. */ void AddDefinition(const char* name, const char* value); ///! Add a definition to this makefile and the global cmake cache. void AddCacheDefinition(const char* name, const char* value, const char* doc, cmCacheManager::CacheEntryType type); /** * Add bool variable definition to the build. */ void AddDefinition(const char* name, bool); ///! Add a definition to this makefile and the global cmake cache. void AddCacheDefinition(const char* name, bool, const char* doc); /** * Remove a variable definition from the build. This is not valid * for cache entries, and will only affect the current makefile. */ void RemoveDefinition(const char* name); ///! Remove a definition from the cache. void RemoveCacheDefinition(const char* name); /** * Specify the name of the project for this build. */ void SetProjectName(const char*); /** * Get the name of the project for this build. */ const char* GetProjectName() const { return this->ProjectName.c_str(); } /** * Set the name of the library. */ void AddLibrary(const char *libname, cmTarget::TargetType type, const std::vector &srcs, bool excludeFromAll = false); #if defined(CMAKE_BUILD_WITH_CMAKE) /** * Add a root source group for consideration when adding a new source. */ void AddSourceGroup(const char* name, const char* regex=0); /** * Add a source group for consideration when adding a new source. * name is tokenized. */ void AddSourceGroup(const std::vector& name, const char* regex=0); #endif //@{ /** * Set, Push, Pop policy values for CMake. */ bool SetPolicy(cmPolicies::PolicyID id, cmPolicies::PolicyStatus status); bool SetPolicy(const char *id, cmPolicies::PolicyStatus status); cmPolicies::PolicyStatus GetPolicyStatus(cmPolicies::PolicyID id); bool PushPolicy(); bool PopPolicy(bool reportError = true); bool SetPolicyVersion(const char *version); //@} /** * Get the Policies Instance */ cmPolicies *GetPolicies(); /** * Add an auxiliary directory to the build. */ void AddExtraDirectory(const char* dir); /** * Add an auxiliary directory to the build. */ void MakeStartDirectoriesCurrent() { this->AddDefinition("CMAKE_CURRENT_SOURCE_DIR", this->cmStartDirectory.c_str()); this->AddDefinition("CMAKE_CURRENT_BINARY_DIR", this->StartOutputDirectory.c_str()); } //@{ /** * Set/Get the home directory (or output directory) in the project. The * home directory is the top directory of the project. It is where * CMakeSetup or configure was run. Remember that CMake processes * CMakeLists files by recursing up the tree starting at the StartDirectory * and going up until it reaches the HomeDirectory. */ void SetHomeDirectory(const char* dir); const char* GetHomeDirectory() const { return this->cmHomeDirectory.c_str(); } void SetHomeOutputDirectory(const char* lib); const char* GetHomeOutputDirectory() const { return this->HomeOutputDirectory.c_str(); } //@} //@{ /** * Set/Get the start directory (or output directory). The start directory * is the directory of the CMakeLists.txt file that started the current * round of processing. Remember that CMake processes CMakeLists files by * recursing up the tree starting at the StartDirectory and going up until * it reaches the HomeDirectory. */ void SetStartDirectory(const char* dir) { this->cmStartDirectory = dir; cmSystemTools::ConvertToUnixSlashes(this->cmStartDirectory); this->cmStartDirectory = cmSystemTools::CollapseFullPath(this->cmStartDirectory.c_str()); this->AddDefinition("CMAKE_CURRENT_SOURCE_DIR", this->cmStartDirectory.c_str()); } const char* GetStartDirectory() const { return this->cmStartDirectory.c_str(); } void SetStartOutputDirectory(const char* lib) { this->StartOutputDirectory = lib; cmSystemTools::ConvertToUnixSlashes(this->StartOutputDirectory); this->StartOutputDirectory = cmSystemTools::CollapseFullPath(this->StartOutputDirectory.c_str()); cmSystemTools::MakeDirectory(this->StartOutputDirectory.c_str()); this->AddDefinition("CMAKE_CURRENT_BINARY_DIR", this->StartOutputDirectory.c_str()); } const char* GetStartOutputDirectory() const { return this->StartOutputDirectory.c_str(); } //@} const char* GetCurrentDirectory() const { return this->cmStartDirectory.c_str(); } const char* GetCurrentOutputDirectory() const { return this->StartOutputDirectory.c_str(); } /* Get the current CMakeLists.txt file that is being processed. This * is just used in order to be able to 'branch' from one file to a second * transparently */ const char* GetCurrentListFile() const { return this->cmCurrentListFile.c_str(); } //@} /** * Set a regular expression that include files must match * in order to be considered as part of the depend information. */ void SetIncludeRegularExpression(const char* regex) { this->IncludeFileRegularExpression = regex; } const char* GetIncludeRegularExpression() { return this->IncludeFileRegularExpression.c_str(); } /** * Set a regular expression that include files that are not found * must match in order to be considered a problem. */ void SetComplainRegularExpression(const char* regex) { this->ComplainFileRegularExpression = regex; } const char* GetComplainRegularExpression() { return this->ComplainFileRegularExpression.c_str(); } /** * Get the list of targets */ cmTargets &GetTargets() { return this->Targets; } /** * Get the list of targets, const version */ const cmTargets &GetTargets() const { return this->Targets; } cmTarget* FindTarget(const char* name); /** Find a target to use in place of the given name. The target returned may be imported or built within the project. */ cmTarget* FindTargetToUse(const char* name); /** * Get a list of include directories in the build. */ std::vector& GetIncludeDirectories() { return this->IncludeDirectories; } const std::vector& GetIncludeDirectories() const { return this->IncludeDirectories; } void SetIncludeDirectories(const std::vector& vec) { this->IncludeDirectories = vec; } /** * Mark include directories as system directories. */ void AddSystemIncludeDirectory(const char* dir); bool IsSystemIncludeDirectory(const char* dir); /** Expand out any arguements in the vector that have ; separated * strings into multiple arguements. A new vector is created * containing the expanded versions of all arguments in argsIn. * This method differes from the one in cmSystemTools in that if * the CmakeLists file is version 1.2 or earlier it will check for * source lists being used without ${} around them */ void ExpandSourceListArguments(std::vector const& argsIn, std::vector& argsOut, unsigned int startArgumentIndex); /** Get a cmSourceFile pointer for a given source name, if the name is * not found, then a null pointer is returned. */ cmSourceFile* GetSource(const char* sourceName); /** Get a cmSourceFile pointer for a given source name, if the name is * not found, then create the source file and return it. generated * indicates if it is a generated file, this is used in determining * how to create the source file instance e.g. name */ cmSourceFile* GetOrCreateSource(const char* sourceName, bool generated = false); /** * Obtain a list of auxiliary source directories. */ std::vector& GetAuxSourceDirectories() {return this->AuxSourceDirectories;} //@{ /** * Return a list of extensions associated with source and header * files */ const std::vector& GetSourceExtensions() const {return this->SourceFileExtensions;} const std::vector& GetHeaderExtensions() const {return this->HeaderFileExtensions;} //@} /** * Given a variable name, return its value (as a string). * If the variable is not found in this makefile instance, the * cache is then queried. */ const char* GetDefinition(const char*) const; const char* GetSafeDefinition(const char*) const; const char* GetRequiredDefinition(const char* name) const; bool IsDefinitionSet(const char*) const; /** * Get the list of all variables in the current space. If argument * cacheonly is specified and is greater than 0, then only cache * variables will be listed. */ std::vector GetDefinitions(int cacheonly=0) const; /** Test a boolean cache entry to see if it is true or false, * returns false if no entry defined. */ bool IsOn(const char* name) const; bool IsSet(const char* name) const; /** * Get a list of preprocessor define flags. */ const char* GetDefineFlags() {return this->DefineFlags.c_str();} /** * Make sure CMake can write this file */ bool CanIWriteThisFile(const char* fileName); /** * Get the vector of used command instances. */ const std::vector& GetUsedCommands() const {return this->UsedCommands;} #if defined(CMAKE_BUILD_WITH_CMAKE) /** * Get the vector source groups. */ const std::vector& GetSourceGroups() const { return this->SourceGroups; } /** * Get the source group */ cmSourceGroup* GetSourceGroup(const std::vector&name); #endif /** * Get the vector of list files on which this makefile depends */ const std::vector& GetListFiles() const { return this->ListFiles; } ///! When the file changes cmake will be re-run from the build system. void AddCMakeDependFile(const char* file) { this->ListFiles.push_back(file);} /** * Get the list file stack as a string */ std::string GetListFileStack(); /** * Get the current context backtrace. */ bool GetBacktrace(cmListFileBacktrace& backtrace) const; /** * Get the vector of files created by this makefile */ const std::vector& GetOutputFiles() const { return this->OutputFiles; } void AddCMakeOutputFile(const char* file) { this->OutputFiles.push_back(file);} /** * Expand all defined variables in the string. * Defined variables come from the this->Definitions map. * They are expanded with ${var} where var is the * entry in the this->Definitions map. Also @var@ is * expanded to match autoconf style expansions. */ const char *ExpandVariablesInString(std::string& source); const char *ExpandVariablesInString(std::string& source, bool escapeQuotes, bool noEscapes, bool atOnly = false, const char* filename = 0, long line = -1, bool removeEmpty = false, bool replaceAt = true); /** * Remove any remaining variables in the string. Anything with ${var} or * @var@ will be removed. */ void RemoveVariablesInString(std::string& source, bool atOnly = false) const; /** * Expand variables in the makefiles ivars such as link directories etc */ void ExpandVariables(); /** * Replace variables and #cmakedefine lines in the given string. * See cmConfigureFileCommand for details. */ void ConfigureString(const std::string& input, std::string& output, bool atOnly, bool escapeQuotes); /** * Copy file but change lines acording to ConfigureString */ int ConfigureFile(const char* infile, const char* outfile, bool copyonly, bool atOnly, bool escapeQuotes); #if defined(CMAKE_BUILD_WITH_CMAKE) /** * find what source group this source is in */ cmSourceGroup& FindSourceGroup(const char* source, std::vector &groups); #endif void RegisterData(cmData*); void RegisterData(const char*, cmData*); cmData* LookupData(const char*) const; /** * Execute a single CMake command. Returns true if the command * succeeded or false if it failed. */ bool ExecuteCommand(const cmListFileFunction& lff, cmExecutionStatus &status); /** Check if a command exists. */ bool CommandExists(const char* name) const; /** * Add a command to this cmake instance */ void AddCommand(cmCommand* ); ///! Enable support for named language, if nil then all languages are ///enabled. void EnableLanguage(std::vectorconst& languages, bool optional); /** * Set/Get the name of the parent directories CMakeLists file * given a current CMakeLists file name */ cmCacheManager *GetCacheManager() const; /** * Get the variable watch. This is used to determine when certain variables * are accessed. */ #ifdef CMAKE_BUILD_WITH_CMAKE cmVariableWatch* GetVariableWatch() const; #endif ///! Display progress or status message. void DisplayStatus(const char*, float); /** * Expand the given list file arguments into the full set after * variable replacement and list expansion. */ bool ExpandArguments(std::vector const& inArgs, std::vector& outArgs); /** * Get the instance */ cmake *GetCMakeInstance() const; /** * Get all the source files this makefile knows about */ const std::vector &GetSourceFiles() const {return this->SourceFiles;} std::vector &GetSourceFiles() {return this->SourceFiles;} /** * Is there a source file that has the provided source file as an output? * if so then return it */ cmSourceFile *GetSourceFileWithOutput(const char *outName); /** * Add a macro to the list of macros. The arguments should be name of the * macro and a documentation signature of it */ void AddMacro(const char* name, const char* signature); ///! Add a new cmTest to the list of tests for this makefile. cmTest* CreateTest(const char* testName); /** Get a cmTest pointer for a given test name, if the name is * not found, then a null pointer is returned. */ cmTest* GetTest(const char* testName) const; const std::vector *GetTests() const; std::vector *GetTests(); /** * Get a list of macros as a ; separated string */ void GetListOfMacros(std::string& macros); /** * Return a location of a file in cmake or custom modules directory */ std::string GetModulesFile(const char* name); ///! Set/Get a property of this directory void SetProperty(const char *prop, const char *value); void AppendProperty(const char *prop, const char *value); const char *GetProperty(const char *prop); const char *GetPropertyOrDefinition(const char *prop); const char *GetProperty(const char *prop, cmProperty::ScopeType scope); bool GetPropertyAsBool(const char *prop); // Get the properties cmPropertyMap &GetProperties() { return this->Properties; }; typedef std::map DefinitionMap; ///! Initialize a makefile from its parent void InitializeFromParent(); ///! Set/Get the preorder flag void SetPreOrder(bool p) { this->PreOrder = p; } bool GetPreOrder() const { return this->PreOrder; } void AddInstallGenerator(cmInstallGenerator* g) { if(g) this->InstallGenerators.push_back(g); } std::vector& GetInstallGenerators() { return this->InstallGenerators; } // Define the properties static void DefineProperties(cmake *cm); // push and pop variable scopes void PushScope(); void PopScope(); void RaiseScope(const char *var, const char *value); void IssueMessage(cmake::MessageType t, std::string const& text) const; /** Set whether or not to report a CMP0000 violation. */ void SetCheckCMP0000(bool b) { this->CheckCMP0000 = b; } protected: // add link libraries and directories to the target void AddGlobalLinkInformation(const char* name, cmTarget& target); std::string Prefix; std::vector AuxSourceDirectories; // std::string cmStartDirectory; std::string StartOutputDirectory; std::string cmHomeDirectory; std::string HomeOutputDirectory; std::string cmCurrentListFile; std::string ProjectName; // project name // libraries, classes, and executables cmTargets Targets; std::vector SourceFiles; // Tests std::vector Tests; // The include and link-library paths. These may have order // dependency, so they must be vectors (not set). std::vector IncludeDirectories; std::vector LinkDirectories; // The set of include directories that are marked as system include // directories. std::set SystemIncludeDirectories; std::vector ListFiles; // list of command files loaded std::vector OutputFiles; // list of command files loaded cmTarget::LinkLibraryVectorType LinkLibraries; std::vector InstallGenerators; std::string IncludeFileRegularExpression; std::string ComplainFileRegularExpression; std::vector SourceFileExtensions; std::vector HeaderFileExtensions; std::string DefineFlags; // Track the value of the computed DEFINITIONS property. void AddDefineFlag(const char*, std::string&); void RemoveDefineFlag(const char*, std::string::size_type, std::string&); std::string DefineFlagsOrig; #if defined(CMAKE_BUILD_WITH_CMAKE) std::vector SourceGroups; #endif std::vector DefinitionStack; std::vector UsedCommands; cmLocalGenerator* LocalGenerator; bool IsFunctionBlocked(const cmListFileFunction& lff, cmExecutionStatus &status); private: void Initialize(); bool ParseDefineFlag(std::string const& definition, bool remove); void ReadSources(std::ifstream& fin, bool t); friend class cmMakeDepend; // make depend needs direct access // to the Sources array void PrintStringVector(const char* s, const std::vector >& v) const; void PrintStringVector(const char* s, const std::vector& v) const; void AddDefaultDefinitions(); std::list FunctionBlockers; typedef std::map DataMapType; DataMapType DataMap; typedef std::map StringStringMap; StringStringMap MacrosMap; std::map SubDirectoryOrder; // used in AddDefinition for performance improvement DefinitionMap::key_type TemporaryDefinitionKey; cmsys::RegularExpression cmDefineRegex; cmsys::RegularExpression cmDefine01Regex; cmsys::RegularExpression cmAtVarRegex; cmPropertyMap Properties; // should this makefile be processed before or after processing the parent bool PreOrder; // stack of list files being read std::deque ListFileStack; // stack of commands being invoked. struct CallStackEntry { cmListFileContext const* Context; cmExecutionStatus* Status; }; typedef std::deque CallStackType; CallStackType CallStack; friend class cmMakefileCall; cmTarget* FindBasicTarget(const char* name); std::vector ImportedTargetsOwned; std::map ImportedTargets; // stack of policy settings typedef std::map PolicyMap; std::vector PolicyStack; cmPolicies::PolicyStatus GetPolicyStatusInternal(cmPolicies::PolicyID id); bool CheckCMP0000; // Enforce rules about CMakeLists.txt files. void EnforceDirectoryLevelRules(bool endScopeNicely); }; #endif