1 //===- lib/Linker/LinkItems.cpp - Link LLVM objects and libraries ---------===//
3 // The LLVM Compiler Infrastructure
5 // This file was developed by Reid Spencer and is distributed under the
6 // University of Illinois Open Source License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file contains routines to handle linking together LLVM bytecode files,
11 // and to handle annoying things like static libraries.
13 //===----------------------------------------------------------------------===//
15 #include "llvm/Linker.h"
16 #include "llvm/Module.h"
20 // LinkItems - This function is the main entry point into linking. It takes a
21 // list of LinkItem which indicates the order the files should be linked and
22 // how each file should be treated (plain file or with library search). The
23 // function only links bytecode and produces a result list of items that are
26 Linker::LinkInItems(const ItemList& Items, ItemList& NativeItems) {
27 // Clear the NativeItems just in case
30 // For each linkage item ...
31 for (ItemList::const_iterator I = Items.begin(), E = Items.end();
34 // Link in the library suggested.
35 bool is_native = false;
36 if (LinkInLibrary(I->first, is_native))
39 NativeItems.push_back(*I);
41 // Link in the file suggested
42 bool is_native = false;
43 if (LinkInFile(sys::Path(I->first), is_native))
46 NativeItems.push_back(*I);
50 // At this point we have processed all the link items provided to us. Since
51 // we have an aggregated module at this point, the dependent libraries in
52 // that module should also be aggregated with duplicates eliminated. This is
53 // now the time to process the dependent libraries to resolve any remaining
56 for (Module::lib_iterator I = Composite->lib_begin(),
57 E = Composite->lib_end(); I != E; ++I)
58 if(LinkInLibrary(*I, is_native))
65 /// LinkInLibrary - links one library into the HeadModule.
67 bool Linker::LinkInLibrary(const std::string& Lib, bool& is_native) {
69 // Determine where this library lives.
70 sys::Path Pathname = FindLib(Lib);
71 if (Pathname.isEmpty())
72 return warning("Cannot find library '" + Lib + "'");
74 // If its an archive, try to link it in
76 Pathname.getMagicNumber(Magic, 64);
77 switch (sys::IdentifyFileType(Magic.c_str(), 64)) {
78 default: assert(0 && "Bad file type identification");
79 case sys::Unknown_FileType:
80 return warning("Supposed library '" + Lib + "' isn't a library.");
82 case sys::Bytecode_FileType:
83 case sys::CompressedBytecode_FileType:
85 if (LinkInFile(Pathname, is_native))
86 return error("Cannot link file '" + Pathname.toString() + "'");
89 case sys::Archive_FileType:
90 if (LinkInArchive(Pathname))
91 return error("Cannot link archive '" + Pathname.toString() + "'");
94 case sys::ELF_Relocatable_FileType:
95 case sys::ELF_SharedObject_FileType:
96 case sys::Mach_O_Object_FileType:
97 case sys::Mach_O_FixedVirtualMemorySharedLib_FileType:
98 case sys::Mach_O_DynamicallyLinkedSharedLib_FileType:
99 case sys::Mach_O_DynamicallyLinkedSharedLibStub_FileType:
100 case sys::COFF_FileType:
107 /// LinkLibraries - takes the specified library files and links them into the
108 /// main bytecode object file.
111 /// Libraries - The list of libraries to link into the module.
114 /// FALSE - No error.
117 bool Linker::LinkInLibraries(const std::vector<std::string> &Libraries) {
119 // Process the set of libraries we've been provided.
120 bool is_native = false;
121 for (unsigned i = 0; i < Libraries.size(); ++i)
122 if (LinkInLibrary(Libraries[i], is_native))
125 // At this point we have processed all the libraries provided to us. Since
126 // we have an aggregated module at this point, the dependent libraries in
127 // that module should also be aggregated with duplicates eliminated. This is
128 // now the time to process the dependent libraries to resolve any remaining
130 const Module::LibraryListType& DepLibs = Composite->getLibraries();
131 for (Module::LibraryListType::const_iterator I = DepLibs.begin(),
132 E = DepLibs.end(); I != E; ++I)
133 if (LinkInLibrary(*I, is_native))
139 /// LinkInFile - opens a bytecode file and links in all objects which
140 /// provide symbols that are currently undefined.
143 /// File - The pathname of the bytecode file.
146 /// ErrorMessage - A C++ string detailing what error occurred, if any.
149 /// TRUE - An error occurred.
150 /// FALSE - No errors.
152 bool Linker::LinkInFile(const sys::Path &File, bool &is_native) {
154 // Make sure we can at least read the file
156 return error("Cannot find linker input '" + File.toString() + "'");
158 // If its an archive, try to link it in
160 File.getMagicNumber(Magic, 64);
161 switch (sys::IdentifyFileType(Magic.c_str(), 64)) {
162 default: assert(0 && "Bad file type identification");
163 case sys::Unknown_FileType:
164 return warning("Supposed object file '" + File.toString() +
165 "' not recognized as such");
167 case sys::Archive_FileType:
168 // A user may specify an ar archive without -l, perhaps because it
169 // is not installed as a library. Detect that and link the archive.
170 verbose("Linking archive file '" + File.toString() + "'");
171 if (LinkInArchive(File))
172 return error("Cannot link archive '" + File.toString() + "'");
175 case sys::Bytecode_FileType:
176 case sys::CompressedBytecode_FileType: {
177 verbose("Linking bytecode file '" + File.toString() + "'");
178 std::auto_ptr<Module> M(LoadObject(File));
180 return error("Cannot load file '" + File.toString() + "'" + Error);
181 if (LinkInModule(M.get()))
182 return error("Cannot link file '" + File.toString() + "'" + Error);
184 verbose("Linked in file '" + File.toString() + "'");
188 case sys::ELF_Relocatable_FileType:
189 case sys::ELF_SharedObject_FileType:
190 case sys::Mach_O_Object_FileType:
191 case sys::Mach_O_FixedVirtualMemorySharedLib_FileType:
192 case sys::Mach_O_DynamicallyLinkedSharedLib_FileType:
193 case sys::Mach_O_DynamicallyLinkedSharedLibStub_FileType:
194 case sys::COFF_FileType:
201 /// LinkFiles - takes a module and a list of files and links them all together.
202 /// It locates the file either in the current directory, as its absolute
203 /// or relative pathname, or as a file somewhere in LLVM_LIB_SEARCH_PATH.
206 /// Files - A vector of sys::Path indicating the LLVM bytecode filenames
207 /// to be linked. The names can refer to a mixture of pure LLVM
208 /// bytecode files and archive (ar) formatted files.
211 /// FALSE - No errors.
212 /// TRUE - Some error occurred.
214 bool Linker::LinkInFiles(const std::vector<sys::Path> &Files) {
216 for (unsigned i = 0; i < Files.size(); ++i)
217 if (LinkInFile(Files[i], is_native))