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 25 namespace lld::coff { 26 27 using llvm::COFF::IMAGE_FILE_MACHINE_UNKNOWN; 28 using llvm::COFF::WindowsSubsystem; 29 using llvm::StringRef; 30 class DefinedAbsolute; 31 class StringChunk; 32 class Symbol; 33 class InputFile; 34 class SectionChunk; 35 36 // Short aliases. 37 static const auto AMD64 = llvm::COFF::IMAGE_FILE_MACHINE_AMD64; 38 static const auto ARM64 = llvm::COFF::IMAGE_FILE_MACHINE_ARM64; 39 static const auto ARM64EC = llvm::COFF::IMAGE_FILE_MACHINE_ARM64EC; 40 static const auto ARM64X = llvm::COFF::IMAGE_FILE_MACHINE_ARM64X; 41 static const auto ARMNT = llvm::COFF::IMAGE_FILE_MACHINE_ARMNT; 42 static const auto I386 = llvm::COFF::IMAGE_FILE_MACHINE_I386; 43 44 enum class ExportSource { 45 Unset, 46 Directives, 47 Export, 48 ModuleDefinition, 49 }; 50 51 enum class EmitKind { Obj, LLVM, ASM }; 52 53 // Represents an /export option. 54 struct 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 83 enum class DebugType { 84 None = 0x0, 85 CV = 0x1, /// CodeView 86 PData = 0x2, /// Procedure Data 87 Fixup = 0x4, /// Relocation Table 88 }; 89 90 enum 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 98 enum 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 105 enum class BuildIDHash { 106 None, 107 PDB, 108 Binary, 109 }; 110 111 // Global configuration. 112 struct Configuration { 113 enum ManifestKind { Default, SideBySide, Embed, No }; 114 bool is64() const { return llvm::COFF::is64Bit(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