1 //===- Config.h -------------------------------------------------*- C++ -*-===//
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 #ifndef LLD_ELF_CONFIG_H
11 #define LLD_ELF_CONFIG_H
13 #include "llvm/ADT/MapVector.h"
14 #include "llvm/ADT/StringRef.h"
15 #include "llvm/ADT/StringSet.h"
16 #include "llvm/Support/CachePruning.h"
17 #include "llvm/Support/CodeGen.h"
18 #include "llvm/Support/ELF.h"
19 #include "llvm/Support/Endian.h"
38 enum class BuildIdKind { None, Fast, Md5, Sha1, Hexstring, Uuid };
40 // For --discard-{all,locals,none}.
41 enum class DiscardPolicy { Default, All, Locals, None };
43 // For --strip-{all,debug}.
44 enum class StripPolicy { None, All, Debug };
46 // For --unresolved-symbols.
47 enum class UnresolvedPolicy { ReportError, Warn, WarnAll, Ignore, IgnoreAll };
49 // For --sort-section and linkerscript sorting rules.
50 enum class SortSectionPolicy { Default, None, Alignment, Name, Priority };
53 enum class Target2Policy { Abs, Rel, GotRel };
55 struct SymbolVersion {
61 // This struct contains symbols version definition that
62 // can be found in version script if it is used for link.
63 struct VersionDefinition {
66 std::vector<SymbolVersion> Globals;
67 size_t NameOff = 0; // Offset in the string table
70 // This struct contains the global configuration for the linker.
71 // Most fields are direct mapping from the command line options
72 // and such fields have the same name as the corresponding options.
73 // Most fields are initialized by the driver.
74 struct Configuration {
75 InputFile *FirstElf = nullptr;
77 llvm::CachePruningPolicy ThinLTOCachePolicy;
78 llvm::StringMap<uint64_t> SectionStartMap;
79 llvm::StringRef DynamicLinker;
80 llvm::StringRef Entry;
81 llvm::StringRef Emulation;
84 llvm::StringRef LTOAAPipeline;
85 llvm::StringRef LTONewPmPasses;
86 llvm::StringRef MapFile;
87 llvm::StringRef OutputFile;
88 llvm::StringRef OptRemarksFilename;
89 llvm::StringRef SoName;
90 llvm::StringRef Sysroot;
91 llvm::StringRef ThinLTOCacheDir;
93 std::vector<VersionDefinition> VersionDefinitions;
94 std::vector<llvm::StringRef> AuxiliaryList;
95 std::vector<llvm::StringRef> SearchPaths;
96 std::vector<llvm::StringRef> SymbolOrderingFile;
97 std::vector<llvm::StringRef> Undefined;
98 std::vector<SymbolVersion> VersionScriptGlobals;
99 std::vector<SymbolVersion> VersionScriptLocals;
100 std::vector<uint8_t> BuildIdVector;
101 bool AllowMultipleDefinition;
102 bool AsNeeded = false;
104 bool BsymbolicFunctions;
105 bool ColorDiagnostics = false;
106 bool CompressDebugSections;
108 bool Demangle = true;
119 bool MipsN32Abi = false;
121 bool NoUndefinedVersion;
125 bool OptRemarksWithHotness;
127 bool PrintGcSections;
139 bool WarnMissingEntry;
151 DiscardPolicy Discard;
152 SortSectionPolicy SortSection;
154 UnresolvedPolicy UnresolvedSymbols;
155 Target2Policy Target2;
156 BuildIdKind BuildId = BuildIdKind::None;
157 ELFKind EKind = ELFNoneKind;
158 uint16_t DefaultSymbolVersion = llvm::ELF::VER_NDX_GLOBAL;
159 uint16_t EMachine = llvm::ELF::EM_NONE;
160 uint64_t ErrorLimit = 20;
162 uint64_t MaxPageSize;
164 unsigned LTOPartitions;
167 unsigned ThinLTOJobs;
169 // The following config options do not directly correspond to any
170 // particualr command line options.
172 // True if we need to pass through relocations in input files to the
173 // output file. Usually false because we consume relocations.
176 // True if the target is ELF64. False if ELF32.
179 // True if the target is little-endian. False if big-endian.
182 // endianness::little if IsLE is true. endianness::big otherwise.
183 llvm::support::endianness Endianness;
185 // True if the target is the little-endian MIPS64.
187 // The reason why we have this variable only for the MIPS is because
188 // we use this often. Some ELF headers for MIPS64EL are in a
189 // mixed-endian (which is horrible and I'd say that's a serious spec
190 // bug), and we need to know whether we are reading MIPS ELF files or
191 // not in various places.
193 // (Note that MIPS64EL is not a typo for MIPS64LE. This is the official
194 // name whatever that means. A fun hypothesis is that "EL" is short for
195 // little-endian written in the little-endian order, but I don't know
199 // The ELF spec defines two types of relocation table entries, RELA and
200 // REL. RELA is a triplet of (offset, info, addend) while REL is a
201 // tuple of (offset, info). Addends for REL are implicit and read from
202 // the location where the relocations are applied. So, REL is more
203 // compact than RELA but requires a bit of more work to process.
205 // (From the linker writer's view, this distinction is not necessary.
206 // If the ELF had chosen whichever and sticked with it, it would have
207 // been easier to write code to process relocations, but it's too late
208 // to change the spec.)
210 // Each ABI defines its relocation type. IsRela is true if target
211 // uses RELA. As far as we know, all 64-bit ABIs are using RELA. A
212 // few 32-bit ABIs are using RELA too.
215 // True if we are creating position-independent code.
218 // 4 for ELF32, 8 for ELF64.
222 // The only instance of Configuration struct.
223 extern Configuration *Config;