//
// The LLVM Compiler Infrastructure
//
-// This file was developed by the LLVM research group and is distributed under
-// the University of Illinois Open Source License. See LICENSE.TXT for details.
+// 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 defines the interface to the module linker.
+// This file defines the interface to the module/file/archive linker.
//
//===----------------------------------------------------------------------===//
#define LLVM_LINKER_H
#include <string>
+#include <vector>
+#include <set>
namespace llvm {
class Module;
-// LinkModules - This function links two modules together, with the resulting
-// left module modified to be the composite of the two input modules. If an
-// error occurs, true is returned and ErrorMsg (if not null) is set to indicate
-// the problem.
-//
-bool LinkModules(Module *Dest, const Module *Src, std::string *ErrorMsg = 0);
+/// This is the heart of the linker. The \p Src module is linked into the \p
+/// Dest module. If an error occurs, true is returned, otherwise false. If \p
+/// ErrorMsg is not null and an error occurs, \p *ErrorMsg will be set to a
+/// readable string that indicates the nature of the error. Note that this can
+/// destroy the Src module in arbitrary ways.
+///
+/// @returns true if there's an error
+/// @brief Link two modules together
+bool LinkModules(
+ Module* Dest, ///< Module into which \p Src is linked
+ Module* Src, ///< Module linked into \p Dest
+ std::string* ErrorMsg ///< Optional error message string
+);
+
+/// This function links the bytecode \p Files into the \p HeadModule. Note that
+/// this does not do any linking of unresolved symbols. The \p Files are all
+/// completely linked into \p HeadModule regardless of unresolved symbols. This
+/// function just loads each bytecode file and calls LinkModules on them.
+/// @returns true if an error occurs, false otherwise
+bool LinkFiles (
+ const char * progname, ///< Name of the program being linked (for output)
+ Module * HeadModule, ///< Main (resulting) module to be linked into
+ const std::vector<std::string> & Files, ///< Files to link in
+ bool Verbose ///< Link verbosely, indicating each action
+);
+
+/// This function links one archive, \p Filename, that contains bytecode into
+/// \p HeadModule. If an error occurs, true is returned, otherwise false. If
+/// \p ErrorMsg is not null and an error occurs, \p *ErrorMsg will be set to a
+/// readable string that indicates the nature of the error.
+/// @returns true if there's an error
+/// @brief Link in one archive.
+bool LinkInArchive(
+ Module* HeadModule, ///< Main (resulting) module to be linked into
+ const std::string& Filename, ///< Filename of the archive to link
+ std::string* ErrorMsg, ///< Error message if an error occurs.
+ bool Verbose ///< Link verbosely, indicating each action
+);
+
+/// This function provides the ability to handle the -L and -l options on a
+/// linker's command line. It will link into \p HeadModule any modules found in
+/// the \p Libraries (which might be found in the \p LibPaths).
+/// @brief Link libraries into a module
+void LinkLibraries (
+ const char * progname, ///< Name of the program being linked (for output)
+ Module* HeadModule, ///< Main (resulting) module to be linked into
+ const std::vector<std::string> & Libraries, ///< Set of libraries to link in
+ const std::vector<std::string> & LibPaths, ///< Set of library paths
+ bool Verbose, ///< Link verbosely, indicating each action
+ bool Native ///< Linking is for a native executable
+);
+/// This function looks at Module \p M and returns a set of strings,
+/// \p DefinedSymbols, that is the publicly visible defined symbols in
+/// module \p M.
+void GetAllDefinedSymbols (Module *M, std::set<std::string> &DefinedSymbols);
+
+/// This function looks at Module \p M and returns a set of strings,
+/// \p UnefinedSymbols, that is the publicly visible undefined symbols in
+/// module \p M.
+void GetAllUndefinedSymbols(Module *M, std::set<std::string> &UndefinedSymbols);
+
+/// This function looks through a set of \p Paths to find a library with the
+/// name \p Filename. If \p SharedObjectOnly is true, it only finds a match
+/// if the file is a shared library.
+std::string FindLib(const std::string &Filename,
+ const std::vector<std::string> &Paths,
+ bool SharedObjectOnly = false);
+
} // End llvm namespace
#endif
-