1//===- Config.h -------------------------------------------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8
9#ifndef LLD_COFF_CONFIG_H
10#define LLD_COFF_CONFIG_H
11
12#include "llvm/ADT/MapVector.h"
13#include "llvm/ADT/SetVector.h"
14#include "llvm/ADT/SmallVector.h"
15#include "llvm/ADT/StringMap.h"
16#include "llvm/ADT/StringRef.h"
17#include "llvm/Object/COFF.h"
18#include "llvm/Support/CachePruning.h"
19#include "llvm/Support/VirtualFileSystem.h"
20#include <cstdint>
21#include <map>
22#include <set>
23#include <string>
24
25namespace lld::coff {
26
27using llvm::COFF::IMAGE_FILE_MACHINE_UNKNOWN;
28using llvm::COFF::WindowsSubsystem;
29using llvm::StringRef;
30class DefinedAbsolute;
31class StringChunk;
32class Symbol;
33class InputFile;
34class SectionChunk;
35
36// Short aliases.
37static const auto AMD64 = llvm::COFF::IMAGE_FILE_MACHINE_AMD64;
38static const auto ARM64 = llvm::COFF::IMAGE_FILE_MACHINE_ARM64;
39static const auto ARM64EC = llvm::COFF::IMAGE_FILE_MACHINE_ARM64EC;
40static const auto ARM64X = llvm::COFF::IMAGE_FILE_MACHINE_ARM64X;
41static const auto ARMNT = llvm::COFF::IMAGE_FILE_MACHINE_ARMNT;
42static const auto I386 = llvm::COFF::IMAGE_FILE_MACHINE_I386;
43
44enum class ExportSource {
45 Unset,
46 Directives,
47 Export,
48 ModuleDefinition,
49};
50
51enum class EmitKind { Obj, LLVM, ASM };
52
53// Represents an /export option.
54struct Export {
55 StringRef name; // N in /export:N or /export:E=N
56 StringRef extName; // E in /export:E=N
57 StringRef aliasTarget; // GNU specific: N in "alias == N"
58 Symbol *sym = nullptr;
59 uint16_t ordinal = 0;
60 bool noname = false;
61 bool data = false;
62 bool isPrivate = false;
63 bool constant = false;
64
65 // If an export is a form of /export:foo=dllname.bar, that means
66 // that foo should be exported as an alias to bar in the DLL.
67 // forwardTo is set to "dllname.bar" part. Usually empty.
68 StringRef forwardTo;
69 StringChunk *forwardChunk = nullptr;
70
71 ExportSource source = ExportSource::Unset;
72 StringRef symbolName;
73 StringRef exportName; // Name in DLL
74
75 bool operator==(const Export &e) const {
76 return (name == e.name && extName == e.extName &&
77 aliasTarget == e.aliasTarget &&
78 ordinal == e.ordinal && noname == e.noname &&
79 data == e.data && isPrivate == e.isPrivate);
80 }
81};
82
83enum class DebugType {
84 None = 0x0,
85 CV = 0x1, /// CodeView
86 PData = 0x2, /// Procedure Data
87 Fixup = 0x4, /// Relocation Table
88};
89
90enum GuardCFLevel {
91 Off = 0x0,
92 CF = 0x1, /// Emit gfids tables
93 LongJmp = 0x2, /// Emit longjmp tables
94 EHCont = 0x4, /// Emit ehcont tables
95 All = 0x7 /// Enable all protections
96};
97
98enum class ICFLevel {
99 None,
100 Safe, // Safe ICF for all sections.
101 All, // Aggressive ICF for code, but safe ICF for data, similar to MSVC's
102 // behavior.
103};
104
105enum class BuildIDHash {
106 None,
107 PDB,
108 Binary,
109};
110
111// Global configuration.
112struct Configuration {
113 enum ManifestKind { Default, SideBySide, Embed, No };
114 bool is64() const { return llvm::COFF::is64Bit(Machine: machine); }
115
116 llvm::COFF::MachineTypes machine = IMAGE_FILE_MACHINE_UNKNOWN;
117 size_t wordsize;
118 bool verbose = false;
119 WindowsSubsystem subsystem = llvm::COFF::IMAGE_SUBSYSTEM_UNKNOWN;
120 Symbol *entry = nullptr;
121 bool noEntry = false;
122 std::string outputFile;
123 std::string importName;
124 bool demangle = true;
125 bool doGC = true;
126 ICFLevel doICF = ICFLevel::None;
127 bool tailMerge;
128 bool relocatable = true;
129 bool forceMultiple = false;
130 bool forceMultipleRes = false;
131 bool forceUnresolved = false;
132 bool debug = false;
133 bool includeDwarfChunks = false;
134 bool debugGHashes = false;
135 bool writeSymtab = false;
136 bool driver = false;
137 bool driverUponly = false;
138 bool driverWdm = false;
139 bool showTiming = false;
140 bool showSummary = false;
141 bool printSearchPaths = false;
142 unsigned debugTypes = static_cast<unsigned>(DebugType::None);
143 llvm::SmallVector<llvm::StringRef, 0> mllvmOpts;
144 std::vector<std::string> natvisFiles;
145 llvm::StringMap<std::string> namedStreams;
146 llvm::SmallString<128> pdbAltPath;
147 int pdbPageSize = 4096;
148 llvm::SmallString<128> pdbPath;
149 llvm::SmallString<128> pdbSourcePath;
150 std::vector<llvm::StringRef> argv;
151
152 // Symbols in this set are considered as live by the garbage collector.
153 std::vector<Symbol *> gcroot;
154
155 std::set<std::string> noDefaultLibs;
156 bool noDefaultLibAll = false;
157
158 // True if we are creating a DLL.
159 bool dll = false;
160 StringRef implib;
161 bool noimplib = false;
162 std::vector<Export> exports;
163 bool hadExplicitExports;
164 std::set<std::string> delayLoads;
165 std::map<std::string, int> dllOrder;
166 Symbol *delayLoadHelper = nullptr;
167
168 bool saveTemps = false;
169
170 // /guard:cf
171 int guardCF = GuardCFLevel::Off;
172
173 // Used for SafeSEH.
174 bool safeSEH = false;
175 Symbol *sehTable = nullptr;
176 Symbol *sehCount = nullptr;
177 bool noSEH = false;
178
179 // Used for /opt:lldlto=N
180 unsigned ltoo = 2;
181 // Used for /opt:lldltocgo=N
182 std::optional<unsigned> ltoCgo;
183
184 // Used for /opt:lldltojobs=N
185 std::string thinLTOJobs;
186 // Used for /opt:lldltopartitions=N
187 unsigned ltoPartitions = 1;
188
189 // Used for /lldltocache=path
190 StringRef ltoCache;
191 // Used for /lldltocachepolicy=policy
192 llvm::CachePruningPolicy ltoCachePolicy;
193
194 // Used for /opt:[no]ltodebugpassmanager
195 bool ltoDebugPassManager = false;
196
197 // Used for /merge:from=to (e.g. /merge:.rdata=.text)
198 std::map<StringRef, StringRef> merge;
199
200 // Used for /section=.name,{DEKPRSW} to set section attributes.
201 std::map<StringRef, uint32_t> section;
202
203 // Options for manifest files.
204 ManifestKind manifest = Default;
205 int manifestID = 1;
206 llvm::SetVector<StringRef> manifestDependencies;
207 bool manifestUAC = true;
208 std::vector<std::string> manifestInput;
209 StringRef manifestLevel = "'asInvoker'";
210 StringRef manifestUIAccess = "'false'";
211 StringRef manifestFile;
212
213 // used for /dwodir
214 StringRef dwoDir;
215
216 // Used for /aligncomm.
217 std::map<std::string, int> alignComm;
218
219 // Used for /failifmismatch.
220 std::map<StringRef, std::pair<StringRef, InputFile *>> mustMatch;
221
222 // Used for /alternatename.
223 std::map<StringRef, StringRef> alternateNames;
224
225 // Used for /order.
226 llvm::StringMap<int> order;
227
228 // Used for /lldmap.
229 std::string lldmapFile;
230
231 // Used for /map.
232 std::string mapFile;
233
234 // Used for /mapinfo.
235 bool mapInfo = false;
236
237 // Used for /thinlto-index-only:
238 llvm::StringRef thinLTOIndexOnlyArg;
239
240 // Used for /thinlto-prefix-replace:
241 // Replace the prefix in paths generated for ThinLTO, replacing
242 // thinLTOPrefixReplaceOld with thinLTOPrefixReplaceNew. If
243 // thinLTOPrefixReplaceNativeObject is defined, replace the prefix of object
244 // file paths written to the response file given in the
245 // --thinlto-index-only=${response} option with
246 // thinLTOPrefixReplaceNativeObject, instead of thinLTOPrefixReplaceNew.
247 llvm::StringRef thinLTOPrefixReplaceOld;
248 llvm::StringRef thinLTOPrefixReplaceNew;
249 llvm::StringRef thinLTOPrefixReplaceNativeObject;
250
251 // Used for /thinlto-object-suffix-replace:
252 std::pair<llvm::StringRef, llvm::StringRef> thinLTOObjectSuffixReplace;
253
254 // Used for /lto-obj-path:
255 llvm::StringRef ltoObjPath;
256
257 // Used for /lto-cs-profile-generate:
258 bool ltoCSProfileGenerate = false;
259
260 // Used for /lto-cs-profile-path
261 llvm::StringRef ltoCSProfileFile;
262
263 // Used for /lto-pgo-warn-mismatch:
264 bool ltoPGOWarnMismatch = true;
265
266 // Used for /call-graph-ordering-file:
267 llvm::MapVector<std::pair<const SectionChunk *, const SectionChunk *>,
268 uint64_t>
269 callGraphProfile;
270 bool callGraphProfileSort = false;
271
272 // Used for /print-symbol-order:
273 StringRef printSymbolOrder;
274
275 // Used for /vfsoverlay:
276 std::unique_ptr<llvm::vfs::FileSystem> vfs;
277
278 uint64_t align = 4096;
279 uint64_t imageBase = -1;
280 uint64_t fileAlign = 512;
281 uint64_t stackReserve = 1024 * 1024;
282 uint64_t stackCommit = 4096;
283 uint64_t heapReserve = 1024 * 1024;
284 uint64_t heapCommit = 4096;
285 uint32_t majorImageVersion = 0;
286 uint32_t minorImageVersion = 0;
287 // If changing the default os/subsys version here, update the default in
288 // the MinGW driver accordingly.
289 uint32_t majorOSVersion = 6;
290 uint32_t minorOSVersion = 0;
291 uint32_t majorSubsystemVersion = 6;
292 uint32_t minorSubsystemVersion = 0;
293 uint32_t timestamp = 0;
294 uint32_t functionPadMin = 0;
295 uint32_t timeTraceGranularity = 0;
296 uint16_t dependentLoadFlags = 0;
297 bool dynamicBase = true;
298 bool allowBind = true;
299 bool cetCompat = false;
300 bool nxCompat = true;
301 bool allowIsolation = true;
302 bool terminalServerAware = true;
303 bool largeAddressAware = false;
304 bool highEntropyVA = false;
305 bool appContainer = false;
306 bool mingw = false;
307 bool warnMissingOrderSymbol = true;
308 bool warnLocallyDefinedImported = true;
309 bool warnDebugInfoUnusable = true;
310 bool warnLongSectionNames = true;
311 bool warnStdcallFixup = true;
312 bool incremental = true;
313 bool integrityCheck = false;
314 bool killAt = false;
315 bool repro = false;
316 bool swaprunCD = false;
317 bool swaprunNet = false;
318 bool thinLTOEmitImportsFiles;
319 bool thinLTOIndexOnly;
320 bool timeTraceEnabled = false;
321 bool autoImport = false;
322 bool pseudoRelocs = false;
323 bool stdcallFixup = false;
324 bool writeCheckSum = false;
325 EmitKind emit = EmitKind::Obj;
326 bool allowDuplicateWeak = false;
327 BuildIDHash buildIDHash = BuildIDHash::None;
328};
329
330} // namespace lld::coff
331
332#endif
333

source code of lld/COFF/Config.h