llvm-capstone/lld/MachO/Driver.h
Kyungwoo Lee 484c961ccd [lld-macho] Postprocess LC Linker Option
LLD resolves symbols regardless of LTO modes early when reading and parsing input files in order. The object files built from LTO passes are appended later.
Because LLD eagerly resolves the LC linker options while parsing a new object file (and its chain of dependent libraries), the prior decision on pending prevailing symbols (belonging to some bitcode files) can change to ones in those native libraries that are just loaded.

This patch delays processing LC linker options until all the native object files are added after LTO is done, similar to LD64. This way we preserve the decision on prevailing symbols LLD made, regardless of LTO modes.
 - When parsing a new object file in `parseLinkerOptions()`, it just parses LC linker options in the header, and saves those contents to `unprocessedLCLinkerOptions`.
 - After LTO is finished, `resolveLCLinkerOptions()` is called to recursively load dependent libraries, starting with initial linker options collected in `unprocessedLCLinkerOptions` (which also updates during recursions)

Reviewed By: #lld-macho, int3

Differential Revision: https://reviews.llvm.org/D157716
2023-08-13 13:39:04 -07:00

118 lines
3.5 KiB
C++

//===- Driver.h -------------------------------------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
#ifndef LLD_MACHO_DRIVER_H
#define LLD_MACHO_DRIVER_H
#include "lld/Common/LLVM.h"
#include "llvm/ADT/SetVector.h"
#include "llvm/ADT/StringRef.h"
#include "llvm/BinaryFormat/MachO.h"
#include "llvm/Option/OptTable.h"
#include "llvm/Support/MemoryBuffer.h"
#include <optional>
#include <set>
#include <type_traits>
namespace lld::macho {
class DylibFile;
class InputFile;
class MachOOptTable : public llvm::opt::GenericOptTable {
public:
MachOOptTable();
llvm::opt::InputArgList parse(ArrayRef<const char *> argv);
void printHelp(const char *argv0, bool showHidden) const;
};
// Create enum with OPT_xxx values for each option in Options.td
enum {
OPT_INVALID = 0,
#define OPTION(...) LLVM_MAKE_OPT_ID(__VA_ARGS__),
#include "Options.inc"
#undef OPTION
};
void parseLCLinkerOption(llvm::SmallVectorImpl<StringRef> &LCLinkerOptions,
InputFile *f, unsigned argc, StringRef data);
void resolveLCLinkerOptions();
std::string createResponseFile(const llvm::opt::InputArgList &args);
// Check for both libfoo.dylib and libfoo.tbd (in that order).
std::optional<StringRef> resolveDylibPath(llvm::StringRef path);
DylibFile *loadDylib(llvm::MemoryBufferRef mbref, DylibFile *umbrella = nullptr,
bool isBundleLoader = false,
bool explicitlyLinked = false);
void resetLoadedDylibs();
// Search for all possible combinations of `{root}/{name}.{extension}`.
// If \p extensions are not specified, then just search for `{root}/{name}`.
std::optional<llvm::StringRef>
findPathCombination(const llvm::Twine &name,
const std::vector<llvm::StringRef> &roots,
ArrayRef<llvm::StringRef> extensions = {""});
// If -syslibroot is specified, absolute paths to non-object files may be
// rerooted.
llvm::StringRef rerootPath(llvm::StringRef path);
uint32_t getModTime(llvm::StringRef path);
void printArchiveMemberLoad(StringRef reason, const InputFile *);
// Map simulator platforms to their underlying device platform.
llvm::MachO::PlatformType removeSimulator(llvm::MachO::PlatformType platform);
// Helper class to export dependency info.
class DependencyTracker {
public:
explicit DependencyTracker(llvm::StringRef path);
// Adds the given path to the set of not-found files.
inline void logFileNotFound(const Twine &path) {
if (active)
notFounds.insert(path.str());
}
// Writes the dependencies to specified path. The content is first sorted by
// OpCode and then by the filename (in alphabetical order).
void write(llvm::StringRef version,
const llvm::SetVector<InputFile *> &inputs,
llvm::StringRef output);
private:
enum DepOpCode : uint8_t {
// Denotes the linker version.
Version = 0x00,
// Denotes the input files.
Input = 0x10,
// Denotes the files that do not exist(?)
NotFound = 0x11,
// Denotes the output files.
Output = 0x40,
};
const llvm::StringRef path;
bool active;
// The paths need to be alphabetically ordered.
// We need to own the paths because some of them are temporarily
// constructed.
std::set<std::string> notFounds;
};
extern std::unique_ptr<DependencyTracker> depTracker;
} // namespace lld::macho
#endif