1 //===-- llvm-config.cpp - LLVM project configuration utility --------------===//
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 tool encapsulates information about an LLVM project configuration for
11 // use by other project's build environments (to determine installed path,
12 // available features, required libraries, etc.).
14 // Note that although this tool *may* be used by some parts of LLVM's build
15 // itself (i.e., the Makefiles use it to compute required libraries when linking
16 // tools), this tool is primarily designed to support external projects.
18 //===----------------------------------------------------------------------===//
20 #include "llvm/ADT/STLExtras.h"
21 #include "llvm/ADT/StringMap.h"
22 #include "llvm/ADT/StringRef.h"
23 #include "llvm/ADT/Triple.h"
24 #include "llvm/ADT/Twine.h"
25 #include "llvm/Config/config.h"
26 #include "llvm/Config/llvm-config.h"
27 #include "llvm/Support/FileSystem.h"
28 #include "llvm/Support/Path.h"
29 #include "llvm/Support/raw_ostream.h"
33 #include <unordered_set>
37 // Include the build time variables we can report to the user. This is generated
38 // at build time from the BuildVariables.inc.in file by the build system.
39 #include "BuildVariables.inc"
41 // Include the component table. This creates an array of struct
42 // AvailableComponent entries, which record the component name, library name,
43 // and required components for all of the available libraries.
45 // Not all components define a library, we also use "library groups" as a way to
46 // create entries for pseudo groups like x86 or all-targets.
47 #include "LibraryDependencies.inc"
49 /// \brief Traverse a single component adding to the topological ordering in
50 /// \arg RequiredLibs.
52 /// \param Name - The component to traverse.
53 /// \param ComponentMap - A prebuilt map of component names to descriptors.
54 /// \param VisitedComponents [in] [out] - The set of already visited components.
55 /// \param RequiredLibs [out] - The ordered list of required
57 /// \param GetComponentNames - Get the component names instead of the
59 static void VisitComponent(StringRef Name,
60 const StringMap<AvailableComponent*> &ComponentMap,
61 std::set<AvailableComponent*> &VisitedComponents,
62 std::vector<StringRef> &RequiredLibs,
63 bool IncludeNonInstalled, bool GetComponentNames,
64 const std::string *ActiveLibDir, bool *HasMissing) {
65 // Lookup the component.
66 AvailableComponent *AC = ComponentMap.lookup(Name);
67 assert(AC && "Invalid component name!");
69 // Add to the visited table.
70 if (!VisitedComponents.insert(AC).second) {
71 // We are done if the component has already been visited.
75 // Only include non-installed components if requested.
76 if (!AC->IsInstalled && !IncludeNonInstalled)
79 // Otherwise, visit all the dependencies.
80 for (unsigned i = 0; AC->RequiredLibraries[i]; ++i) {
81 VisitComponent(AC->RequiredLibraries[i], ComponentMap, VisitedComponents,
82 RequiredLibs, IncludeNonInstalled, GetComponentNames,
83 ActiveLibDir, HasMissing);
86 if (GetComponentNames) {
87 RequiredLibs.push_back(Name);
91 // Add to the required library list.
93 if (!IncludeNonInstalled && HasMissing && !*HasMissing && ActiveLibDir) {
94 *HasMissing = !sys::fs::exists(*ActiveLibDir + "/" + AC->Library);
96 RequiredLibs.push_back(AC->Library);
100 /// \brief Compute the list of required libraries for a given list of
101 /// components, in an order suitable for passing to a linker (that is, libraries
102 /// appear prior to their dependencies).
104 /// \param Components - The names of the components to find libraries for.
105 /// \param RequiredLibs [out] - On return, the ordered list of libraries that
106 /// are required to link the given components.
107 /// \param IncludeNonInstalled - Whether non-installed components should be
109 /// \param GetComponentNames - True if one would prefer the component names.
110 static std::vector<StringRef>
111 ComputeLibsForComponents(const std::vector<StringRef> &Components,
112 bool IncludeNonInstalled, bool GetComponentNames,
113 const std::string *ActiveLibDir, bool *HasMissing) {
114 std::vector<StringRef> RequiredLibs;
115 std::set<AvailableComponent *> VisitedComponents;
117 // Build a map of component names to information.
118 StringMap<AvailableComponent*> ComponentMap;
119 for (unsigned i = 0; i != array_lengthof(AvailableComponents); ++i) {
120 AvailableComponent *AC = &AvailableComponents[i];
121 ComponentMap[AC->Name] = AC;
124 // Visit the components.
125 for (unsigned i = 0, e = Components.size(); i != e; ++i) {
126 // Users are allowed to provide mixed case component names.
127 std::string ComponentLower = Components[i].lower();
129 // Validate that the user supplied a valid component name.
130 if (!ComponentMap.count(ComponentLower)) {
131 llvm::errs() << "llvm-config: unknown component name: " << Components[i]
136 VisitComponent(ComponentLower, ComponentMap, VisitedComponents,
137 RequiredLibs, IncludeNonInstalled, GetComponentNames,
138 ActiveLibDir, HasMissing);
141 // The list is now ordered with leafs first, we want the libraries to printed
142 // in the reverse order of dependency.
143 std::reverse(RequiredLibs.begin(), RequiredLibs.end());
150 static void usage() {
152 usage: llvm-config <OPTION>... [<COMPONENT>...]\n\
154 Get various configuration information needed to compile programs which use\n\
155 LLVM. Typically called from 'configure' scripts. Examples:\n\
156 llvm-config --cxxflags\n\
157 llvm-config --ldflags\n\
158 llvm-config --libs engine bcreader scalaropts\n\
161 --version Print LLVM version.\n\
162 --prefix Print the installation prefix.\n\
163 --src-root Print the source root LLVM was built from.\n\
164 --obj-root Print the object root used to build LLVM.\n\
165 --bindir Directory containing LLVM executables.\n\
166 --includedir Directory containing LLVM headers.\n\
167 --libdir Directory containing LLVM libraries.\n\
168 --cppflags C preprocessor flags for files that include LLVM headers.\n\
169 --cflags C compiler flags for files that include LLVM headers.\n\
170 --cxxflags C++ compiler flags for files that include LLVM headers.\n\
171 --ldflags Print Linker flags.\n\
172 --system-libs System Libraries needed to link against LLVM components.\n\
173 --libs Libraries needed to link against LLVM components.\n\
174 --libnames Bare library names for in-tree builds.\n\
175 --libfiles Fully qualified library filenames for makefile depends.\n\
176 --components List of all possible components.\n\
177 --targets-built List of all targets currently built.\n\
178 --host-target Target triple used to configure LLVM.\n\
179 --build-mode Print build mode of LLVM tree (e.g. Debug or Release).\n\
180 --assertion-mode Print assertion mode of LLVM tree (ON or OFF).\n\
181 --build-system Print the build system used to build LLVM (autoconf or cmake).\n\
182 --has-rtti Print whether or not LLVM was built with rtti (YES or NO).\n\
183 --shared-mode Print how the provided components can be collectively linked (`shared` or `static`).\n\
184 Typical components:\n\
185 all All LLVM libraries (default).\n\
186 engine Either a native JIT or a bitcode interpreter.\n";
190 /// \brief Compute the path to the main executable.
191 std::string GetExecutablePath(const char *Argv0) {
192 // This just needs to be some symbol in the binary; C++ doesn't
193 // allow taking the address of ::main however.
194 void *P = (void*) (intptr_t) GetExecutablePath;
195 return llvm::sys::fs::getMainExecutable(Argv0, P);
198 /// \brief Expand the semi-colon delimited LLVM_DYLIB_COMPONENTS into
199 /// the full list of components.
200 std::vector<StringRef> GetAllDyLibComponents(const bool IsInDevelopmentTree,
201 const bool GetComponentNames) {
202 std::vector<StringRef> DyLibComponents;
204 StringRef DyLibComponentsStr(LLVM_DYLIB_COMPONENTS);
207 const size_t NextOffset = DyLibComponentsStr.find(';', Offset);
208 DyLibComponents.push_back(DyLibComponentsStr.substr(Offset, NextOffset));
209 if (NextOffset == std::string::npos) {
212 Offset = NextOffset + 1;
215 assert(!DyLibComponents.empty());
217 return ComputeLibsForComponents(DyLibComponents,
218 /*IncludeNonInstalled=*/IsInDevelopmentTree,
219 GetComponentNames, nullptr, nullptr);
222 int main(int argc, char **argv) {
223 std::vector<StringRef> Components;
224 bool PrintLibs = false, PrintLibNames = false, PrintLibFiles = false;
225 bool PrintSystemLibs = false, PrintSharedMode = false;
226 bool HasAnyOption = false;
228 // llvm-config is designed to support being run both from a development tree
229 // and from an installed path. We try and auto-detect which case we are in so
230 // that we can report the correct information when run from a development
232 bool IsInDevelopmentTree;
233 enum { MakefileStyle, CMakeStyle, CMakeBuildModeStyle } DevelopmentTreeLayout;
234 llvm::SmallString<256> CurrentPath(GetExecutablePath(argv[0]));
235 std::string CurrentExecPrefix;
236 std::string ActiveObjRoot;
238 // If CMAKE_CFG_INTDIR is given, honor it as build mode.
239 char const *build_mode = LLVM_BUILDMODE;
240 #if defined(CMAKE_CFG_INTDIR)
241 if (!(CMAKE_CFG_INTDIR[0] == '.' && CMAKE_CFG_INTDIR[1] == '\0'))
242 build_mode = CMAKE_CFG_INTDIR;
245 // Create an absolute path, and pop up one directory (we expect to be inside a
247 sys::fs::make_absolute(CurrentPath);
248 CurrentExecPrefix = sys::path::parent_path(
249 sys::path::parent_path(CurrentPath)).str();
251 // Check to see if we are inside a development tree by comparing to possible
252 // locations (prefix style or CMake style).
253 if (sys::fs::equivalent(CurrentExecPrefix,
254 Twine(LLVM_OBJ_ROOT) + "/" + build_mode)) {
255 IsInDevelopmentTree = true;
256 DevelopmentTreeLayout = MakefileStyle;
258 // If we are in a development tree, then check if we are in a BuildTools
259 // directory. This indicates we are built for the build triple, but we
260 // always want to provide information for the host triple.
261 if (sys::path::filename(LLVM_OBJ_ROOT) == "BuildTools") {
262 ActiveObjRoot = sys::path::parent_path(LLVM_OBJ_ROOT);
264 ActiveObjRoot = LLVM_OBJ_ROOT;
266 } else if (sys::fs::equivalent(CurrentExecPrefix, LLVM_OBJ_ROOT)) {
267 IsInDevelopmentTree = true;
268 DevelopmentTreeLayout = CMakeStyle;
269 ActiveObjRoot = LLVM_OBJ_ROOT;
270 } else if (sys::fs::equivalent(CurrentExecPrefix,
271 Twine(LLVM_OBJ_ROOT) + "/bin")) {
272 IsInDevelopmentTree = true;
273 DevelopmentTreeLayout = CMakeBuildModeStyle;
274 ActiveObjRoot = LLVM_OBJ_ROOT;
276 IsInDevelopmentTree = false;
277 DevelopmentTreeLayout = MakefileStyle; // Initialized to avoid warnings.
280 // Compute various directory locations based on the derived location
282 std::string ActivePrefix, ActiveBinDir, ActiveIncludeDir, ActiveLibDir;
283 std::string ActiveIncludeOption;
284 if (IsInDevelopmentTree) {
285 ActiveIncludeDir = std::string(LLVM_SRC_ROOT) + "/include";
286 ActivePrefix = CurrentExecPrefix;
288 // CMake organizes the products differently than a normal prefix style
290 switch (DevelopmentTreeLayout) {
292 ActivePrefix = ActiveObjRoot;
293 ActiveBinDir = ActiveObjRoot + "/" + build_mode + "/bin";
295 ActiveObjRoot + "/" + build_mode + "/lib" + LLVM_LIBDIR_SUFFIX;
298 ActiveBinDir = ActiveObjRoot + "/bin";
299 ActiveLibDir = ActiveObjRoot + "/lib" + LLVM_LIBDIR_SUFFIX;
301 case CMakeBuildModeStyle:
302 ActivePrefix = ActiveObjRoot;
303 ActiveBinDir = ActiveObjRoot + "/bin/" + build_mode;
305 ActiveObjRoot + "/lib" + LLVM_LIBDIR_SUFFIX + "/" + build_mode;
309 // We need to include files from both the source and object trees.
310 ActiveIncludeOption = ("-I" + ActiveIncludeDir + " " +
311 "-I" + ActiveObjRoot + "/include");
313 ActivePrefix = CurrentExecPrefix;
314 ActiveIncludeDir = ActivePrefix + "/include";
315 ActiveBinDir = ActivePrefix + "/bin";
316 ActiveLibDir = ActivePrefix + "/lib" + LLVM_LIBDIR_SUFFIX;
317 ActiveIncludeOption = "-I" + ActiveIncludeDir;
320 /// We only use `shared library` mode in cases where the static library form
321 /// of the components provided are not available; note however that this is
322 /// skipped if we're run from within the build dir. However, once installed,
323 /// we still need to provide correct output when the static archives are
324 /// removed or, as in the case of CMake's `BUILD_SHARED_LIBS`, never present
325 /// in the first place. This can't be done at configure/build time.
327 StringRef SharedExt, SharedVersionedExt, SharedDir, SharedPrefix, StaticExt,
328 StaticPrefix, StaticDir = "lib";
329 const Triple HostTriple(Triple::normalize(LLVM_DEFAULT_TARGET_TRIPLE));
330 if (HostTriple.isOSWindows()) {
332 SharedVersionedExt = PACKAGE_VERSION ".dll";
334 SharedDir = ActiveBinDir;
335 StaticDir = ActiveLibDir;
336 StaticPrefix = SharedPrefix = "";
337 } else if (HostTriple.isOSDarwin()) {
339 SharedVersionedExt = PACKAGE_VERSION ".dylib";
341 StaticDir = SharedDir = ActiveLibDir;
342 StaticPrefix = SharedPrefix = "lib";
344 // default to the unix values:
346 SharedVersionedExt = PACKAGE_VERSION ".so";
348 StaticDir = SharedDir = ActiveLibDir;
349 StaticPrefix = SharedPrefix = "lib";
352 const bool BuiltDyLib = (std::strcmp(LLVM_ENABLE_DYLIB, "ON") == 0);
354 enum { CMake, AutoConf } ConfigTool;
355 if (std::strcmp(LLVM_BUILD_SYSTEM, "cmake") == 0) {
358 ConfigTool = AutoConf;
361 /// CMake style shared libs, ie each component is in a shared library.
362 const bool BuiltSharedLibs =
363 (ConfigTool == CMake && std::strcmp(LLVM_ENABLE_SHARED, "ON") == 0);
365 bool DyLibExists = false;
366 const std::string DyLibName =
367 (SharedPrefix + "LLVM-" + SharedVersionedExt).str();
370 DyLibExists = sys::fs::exists(SharedDir + "/" + DyLibName);
373 /// Get the component's library name without the lib prefix and the
374 /// extension. Returns true if Lib is in a recognized format.
375 auto GetComponentLibraryNameSlice = [&](const StringRef &Lib,
377 if (Lib.startswith("lib")) {
379 if (Lib.endswith(StaticExt)) {
380 FromEnd = StaticExt.size() + 1;
381 } else if (Lib.endswith(SharedExt)) {
382 FromEnd = SharedExt.size() + 1;
388 Out = Lib.slice(3, Lib.size() - FromEnd);
395 /// Maps Unixizms to the host platform.
396 auto GetComponentLibraryFileName = [&](const StringRef &Lib,
397 const bool ForceShared) {
398 std::string LibFileName = Lib;
400 if (GetComponentLibraryNameSlice(Lib, LibName)) {
401 if (BuiltSharedLibs || ForceShared) {
402 LibFileName = (SharedPrefix + LibName + "." + SharedExt).str();
405 LibFileName = (StaticPrefix + LibName + "." + StaticExt).str();
411 /// Get the full path for a possibly shared component library.
412 auto GetComponentLibraryPath = [&](const StringRef &Name,
413 const bool ForceShared) {
414 auto LibFileName = GetComponentLibraryFileName(Name, ForceShared);
415 if (BuiltSharedLibs || ForceShared) {
416 return (SharedDir + "/" + LibFileName).str();
418 return (StaticDir + "/" + LibFileName).str();
422 raw_ostream &OS = outs();
423 for (int i = 1; i != argc; ++i) {
424 StringRef Arg = argv[i];
426 if (Arg.startswith("-")) {
428 if (Arg == "--version") {
429 OS << PACKAGE_VERSION << '\n';
430 } else if (Arg == "--prefix") {
431 OS << ActivePrefix << '\n';
432 } else if (Arg == "--bindir") {
433 OS << ActiveBinDir << '\n';
434 } else if (Arg == "--includedir") {
435 OS << ActiveIncludeDir << '\n';
436 } else if (Arg == "--libdir") {
437 OS << ActiveLibDir << '\n';
438 } else if (Arg == "--cppflags") {
439 OS << ActiveIncludeOption << ' ' << LLVM_CPPFLAGS << '\n';
440 } else if (Arg == "--cflags") {
441 OS << ActiveIncludeOption << ' ' << LLVM_CFLAGS << '\n';
442 } else if (Arg == "--cxxflags") {
443 OS << ActiveIncludeOption << ' ' << LLVM_CXXFLAGS << '\n';
444 } else if (Arg == "--ldflags") {
445 OS << "-L" << ActiveLibDir << ' ' << LLVM_LDFLAGS << '\n';
446 } else if (Arg == "--system-libs") {
447 PrintSystemLibs = true;
448 } else if (Arg == "--libs") {
450 } else if (Arg == "--libnames") {
451 PrintLibNames = true;
452 } else if (Arg == "--libfiles") {
453 PrintLibFiles = true;
454 } else if (Arg == "--components") {
455 /// If there are missing static archives and a dylib was
456 /// built, print LLVM_DYLIB_COMPONENTS instead of everything
458 std::vector<StringRef> Components;
459 for (unsigned j = 0; j != array_lengthof(AvailableComponents); ++j) {
460 // Only include non-installed components when in a development tree.
461 if (!AvailableComponents[j].IsInstalled && !IsInDevelopmentTree)
464 Components.push_back(AvailableComponents[j].Name);
465 if (AvailableComponents[j].Library && !IsInDevelopmentTree) {
467 !sys::fs::exists(GetComponentLibraryPath(
468 AvailableComponents[j].Library, false))) {
469 Components = GetAllDyLibComponents(IsInDevelopmentTree, true);
470 std::sort(Components.begin(), Components.end());
476 for (unsigned I = 0; I < Components.size(); ++I) {
484 } else if (Arg == "--targets-built") {
485 OS << LLVM_TARGETS_BUILT << '\n';
486 } else if (Arg == "--host-target") {
487 OS << Triple::normalize(LLVM_DEFAULT_TARGET_TRIPLE) << '\n';
488 } else if (Arg == "--build-mode") {
489 OS << build_mode << '\n';
490 } else if (Arg == "--assertion-mode") {
496 } else if (Arg == "--build-system") {
497 OS << LLVM_BUILD_SYSTEM << '\n';
498 } else if (Arg == "--has-rtti") {
499 OS << LLVM_HAS_RTTI << '\n';
500 } else if (Arg == "--shared-mode") {
501 PrintSharedMode = true;
502 } else if (Arg == "--obj-root") {
503 OS << ActivePrefix << '\n';
504 } else if (Arg == "--src-root") {
505 OS << LLVM_SRC_ROOT << '\n';
510 Components.push_back(Arg);
517 if (PrintLibs || PrintLibNames || PrintLibFiles || PrintSystemLibs ||
520 if (PrintSharedMode && BuiltSharedLibs) {
525 // If no components were specified, default to "all".
526 if (Components.empty())
527 Components.push_back("all");
529 // Construct the list of all the required libraries.
530 bool HasMissing = false;
531 std::vector<StringRef> RequiredLibs =
532 ComputeLibsForComponents(Components,
533 /*IncludeNonInstalled=*/IsInDevelopmentTree,
534 false, &ActiveLibDir, &HasMissing);
536 if (PrintSharedMode) {
537 std::unordered_set<std::string> FullDyLibComponents;
538 std::vector<StringRef> DyLibComponents =
539 GetAllDyLibComponents(IsInDevelopmentTree, false);
541 for (auto &Component : DyLibComponents) {
542 FullDyLibComponents.insert(Component);
544 DyLibComponents.clear();
546 for (auto &Lib : RequiredLibs) {
547 if (!FullDyLibComponents.count(Lib)) {
552 FullDyLibComponents.clear();
554 if (HasMissing && DyLibExists) {
563 if (PrintLibs || PrintLibNames || PrintLibFiles) {
565 auto PrintForLib = [&](const StringRef &Lib, const bool ForceShared) {
567 OS << GetComponentLibraryFileName(Lib, ForceShared);
568 } else if (PrintLibFiles) {
569 OS << GetComponentLibraryPath(Lib, ForceShared);
570 } else if (PrintLibs) {
571 // If this is a typical library name, include it using -l.
573 if (Lib.startswith("lib")) {
574 if (GetComponentLibraryNameSlice(Lib, LibName)) {
575 OS << "-l" << LibName;
577 OS << "-l:" << GetComponentLibraryFileName(Lib, ForceShared);
580 // Otherwise, print the full path.
581 OS << GetComponentLibraryPath(Lib, ForceShared);
586 if (HasMissing && DyLibExists) {
587 PrintForLib(DyLibName, true);
589 for (unsigned i = 0, e = RequiredLibs.size(); i != e; ++i) {
590 StringRef Lib = RequiredLibs[i];
594 PrintForLib(Lib, false);
600 // Print SYSTEM_LIBS after --libs.
601 // FIXME: Each LLVM component may have its dependent system libs.
603 OS << LLVM_SYSTEM_LIBS << '\n';
604 } else if (!Components.empty()) {
605 errs() << "llvm-config: error: components given, but unused\n\n";