1 //===--- SanitizerArgs.cpp - Arguments for sanitizer tools ---------------===// 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 #include "clang/Driver/SanitizerArgs.h" 9 #include "ToolChains/CommonArgs.h" 10 #include "clang/Basic/Sanitizers.h" 11 #include "clang/Driver/Driver.h" 12 #include "clang/Driver/DriverDiagnostic.h" 13 #include "clang/Driver/Options.h" 14 #include "clang/Driver/ToolChain.h" 15 #include "llvm/ADT/StringExtras.h" 16 #include "llvm/ADT/StringSwitch.h" 17 #include "llvm/Support/AArch64TargetParser.h" 18 #include "llvm/Support/Path.h" 19 #include "llvm/Support/SpecialCaseList.h" 20 #include "llvm/Support/TargetParser.h" 21 #include "llvm/Support/VirtualFileSystem.h" 22 #include "llvm/Transforms/Instrumentation/AddressSanitizerOptions.h" 23 #include <memory> 24 25 using namespace clang; 26 using namespace clang::driver; 27 using namespace llvm::opt; 28 29 static const SanitizerMask NeedsUbsanRt = 30 SanitizerKind::Undefined | SanitizerKind::Integer | 31 SanitizerKind::ImplicitConversion | SanitizerKind::Nullability | 32 SanitizerKind::CFI | SanitizerKind::FloatDivideByZero | 33 SanitizerKind::ObjCCast; 34 static const SanitizerMask NeedsUbsanCxxRt = 35 SanitizerKind::Vptr | SanitizerKind::CFI; 36 static const SanitizerMask NotAllowedWithTrap = SanitizerKind::Vptr; 37 static const SanitizerMask NotAllowedWithMinimalRuntime = 38 SanitizerKind::Function | SanitizerKind::Vptr; 39 static const SanitizerMask RequiresPIE = 40 SanitizerKind::DataFlow | SanitizerKind::HWAddress | SanitizerKind::Scudo; 41 static const SanitizerMask NeedsUnwindTables = 42 SanitizerKind::Address | SanitizerKind::HWAddress | SanitizerKind::Thread | 43 SanitizerKind::Memory | SanitizerKind::DataFlow; 44 static const SanitizerMask SupportsCoverage = 45 SanitizerKind::Address | SanitizerKind::HWAddress | 46 SanitizerKind::KernelAddress | SanitizerKind::KernelHWAddress | 47 SanitizerKind::MemtagStack | SanitizerKind::MemtagHeap | 48 SanitizerKind::MemtagGlobals | SanitizerKind::Memory | 49 SanitizerKind::KernelMemory | SanitizerKind::Leak | 50 SanitizerKind::Undefined | SanitizerKind::Integer | SanitizerKind::Bounds | 51 SanitizerKind::ImplicitConversion | SanitizerKind::Nullability | 52 SanitizerKind::DataFlow | SanitizerKind::Fuzzer | 53 SanitizerKind::FuzzerNoLink | SanitizerKind::FloatDivideByZero | 54 SanitizerKind::SafeStack | SanitizerKind::ShadowCallStack | 55 SanitizerKind::Thread | SanitizerKind::ObjCCast; 56 static const SanitizerMask RecoverableByDefault = 57 SanitizerKind::Undefined | SanitizerKind::Integer | 58 SanitizerKind::ImplicitConversion | SanitizerKind::Nullability | 59 SanitizerKind::FloatDivideByZero | SanitizerKind::ObjCCast; 60 static const SanitizerMask Unrecoverable = 61 SanitizerKind::Unreachable | SanitizerKind::Return; 62 static const SanitizerMask AlwaysRecoverable = 63 SanitizerKind::KernelAddress | SanitizerKind::KernelHWAddress; 64 static const SanitizerMask NeedsLTO = SanitizerKind::CFI; 65 static const SanitizerMask TrappingSupported = 66 (SanitizerKind::Undefined & ~SanitizerKind::Vptr) | SanitizerKind::Integer | 67 SanitizerKind::Nullability | SanitizerKind::LocalBounds | 68 SanitizerKind::CFI | SanitizerKind::FloatDivideByZero | 69 SanitizerKind::ObjCCast; 70 static const SanitizerMask TrappingDefault = SanitizerKind::CFI; 71 static const SanitizerMask CFIClasses = 72 SanitizerKind::CFIVCall | SanitizerKind::CFINVCall | 73 SanitizerKind::CFIMFCall | SanitizerKind::CFIDerivedCast | 74 SanitizerKind::CFIUnrelatedCast; 75 static const SanitizerMask CompatibleWithMinimalRuntime = 76 TrappingSupported | SanitizerKind::Scudo | SanitizerKind::ShadowCallStack | 77 SanitizerKind::MemtagStack | SanitizerKind::MemtagHeap | 78 SanitizerKind::MemtagGlobals; 79 80 enum CoverageFeature { 81 CoverageFunc = 1 << 0, 82 CoverageBB = 1 << 1, 83 CoverageEdge = 1 << 2, 84 CoverageIndirCall = 1 << 3, 85 CoverageTraceBB = 1 << 4, // Deprecated. 86 CoverageTraceCmp = 1 << 5, 87 CoverageTraceDiv = 1 << 6, 88 CoverageTraceGep = 1 << 7, 89 Coverage8bitCounters = 1 << 8, // Deprecated. 90 CoverageTracePC = 1 << 9, 91 CoverageTracePCGuard = 1 << 10, 92 CoverageNoPrune = 1 << 11, 93 CoverageInline8bitCounters = 1 << 12, 94 CoveragePCTable = 1 << 13, 95 CoverageStackDepth = 1 << 14, 96 CoverageInlineBoolFlag = 1 << 15, 97 CoverageTraceLoads = 1 << 16, 98 CoverageTraceStores = 1 << 17, 99 }; 100 101 /// Parse a -fsanitize= or -fno-sanitize= argument's values, diagnosing any 102 /// invalid components. Returns a SanitizerMask. 103 static SanitizerMask parseArgValues(const Driver &D, const llvm::opt::Arg *A, 104 bool DiagnoseErrors); 105 106 /// Parse -f(no-)?sanitize-coverage= flag values, diagnosing any invalid 107 /// components. Returns OR of members of \c CoverageFeature enumeration. 108 static int parseCoverageFeatures(const Driver &D, const llvm::opt::Arg *A, 109 bool DiagnoseErrors); 110 111 /// Produce an argument string from ArgList \p Args, which shows how it 112 /// provides some sanitizer kind from \p Mask. For example, the argument list 113 /// "-fsanitize=thread,vptr -fsanitize=address" with mask \c NeedsUbsanRt 114 /// would produce "-fsanitize=vptr". 115 static std::string lastArgumentForMask(const Driver &D, 116 const llvm::opt::ArgList &Args, 117 SanitizerMask Mask); 118 119 /// Produce an argument string from argument \p A, which shows how it provides 120 /// a value in \p Mask. For instance, the argument 121 /// "-fsanitize=address,alignment" with mask \c NeedsUbsanRt would produce 122 /// "-fsanitize=alignment". 123 static std::string describeSanitizeArg(const llvm::opt::Arg *A, 124 SanitizerMask Mask); 125 126 /// Produce a string containing comma-separated names of sanitizers in \p 127 /// Sanitizers set. 128 static std::string toString(const clang::SanitizerSet &Sanitizers); 129 130 static void validateSpecialCaseListFormat(const Driver &D, 131 std::vector<std::string> &SCLFiles, 132 unsigned MalformedSCLErrorDiagID, 133 bool DiagnoseErrors) { 134 if (SCLFiles.empty()) 135 return; 136 137 std::string BLError; 138 std::unique_ptr<llvm::SpecialCaseList> SCL( 139 llvm::SpecialCaseList::create(SCLFiles, D.getVFS(), BLError)); 140 if (!SCL.get() && DiagnoseErrors) 141 D.Diag(MalformedSCLErrorDiagID) << BLError; 142 } 143 144 static void addDefaultIgnorelists(const Driver &D, SanitizerMask Kinds, 145 std::vector<std::string> &IgnorelistFiles, 146 bool DiagnoseErrors) { 147 struct Ignorelist { 148 const char *File; 149 SanitizerMask Mask; 150 } Ignorelists[] = {{"asan_ignorelist.txt", SanitizerKind::Address}, 151 {"hwasan_ignorelist.txt", SanitizerKind::HWAddress}, 152 {"memtag_ignorelist.txt", SanitizerKind::MemTag}, 153 {"msan_ignorelist.txt", SanitizerKind::Memory}, 154 {"tsan_ignorelist.txt", SanitizerKind::Thread}, 155 {"dfsan_abilist.txt", SanitizerKind::DataFlow}, 156 {"cfi_ignorelist.txt", SanitizerKind::CFI}, 157 {"ubsan_ignorelist.txt", 158 SanitizerKind::Undefined | SanitizerKind::Integer | 159 SanitizerKind::Nullability | 160 SanitizerKind::FloatDivideByZero}}; 161 162 for (auto BL : Ignorelists) { 163 if (!(Kinds & BL.Mask)) 164 continue; 165 166 clang::SmallString<64> Path(D.ResourceDir); 167 llvm::sys::path::append(Path, "share", BL.File); 168 if (D.getVFS().exists(Path)) 169 IgnorelistFiles.push_back(std::string(Path.str())); 170 else if (BL.Mask == SanitizerKind::CFI && DiagnoseErrors) 171 // If cfi_ignorelist.txt cannot be found in the resource dir, driver 172 // should fail. 173 D.Diag(clang::diag::err_drv_missing_sanitizer_ignorelist) << Path; 174 } 175 validateSpecialCaseListFormat( 176 D, IgnorelistFiles, clang::diag::err_drv_malformed_sanitizer_ignorelist, 177 DiagnoseErrors); 178 } 179 180 /// Parse -f(no-)?sanitize-(coverage-)?(allow|ignore)list argument's values, 181 /// diagnosing any invalid file paths and validating special case list format. 182 static void parseSpecialCaseListArg(const Driver &D, 183 const llvm::opt::ArgList &Args, 184 std::vector<std::string> &SCLFiles, 185 llvm::opt::OptSpecifier SCLOptionID, 186 llvm::opt::OptSpecifier NoSCLOptionID, 187 unsigned MalformedSCLErrorDiagID, 188 bool DiagnoseErrors) { 189 for (const auto *Arg : Args) { 190 // Match -fsanitize-(coverage-)?(allow|ignore)list. 191 if (Arg->getOption().matches(SCLOptionID)) { 192 Arg->claim(); 193 std::string SCLPath = Arg->getValue(); 194 if (D.getVFS().exists(SCLPath)) { 195 SCLFiles.push_back(SCLPath); 196 } else if (DiagnoseErrors) { 197 D.Diag(clang::diag::err_drv_no_such_file) << SCLPath; 198 } 199 // Match -fno-sanitize-ignorelist. 200 } else if (Arg->getOption().matches(NoSCLOptionID)) { 201 Arg->claim(); 202 SCLFiles.clear(); 203 } 204 } 205 validateSpecialCaseListFormat(D, SCLFiles, MalformedSCLErrorDiagID, 206 DiagnoseErrors); 207 } 208 209 /// Sets group bits for every group that has at least one representative already 210 /// enabled in \p Kinds. 211 static SanitizerMask setGroupBits(SanitizerMask Kinds) { 212 #define SANITIZER(NAME, ID) 213 #define SANITIZER_GROUP(NAME, ID, ALIAS) \ 214 if (Kinds & SanitizerKind::ID) \ 215 Kinds |= SanitizerKind::ID##Group; 216 #include "clang/Basic/Sanitizers.def" 217 return Kinds; 218 } 219 220 static SanitizerMask parseSanitizeTrapArgs(const Driver &D, 221 const llvm::opt::ArgList &Args, 222 bool DiagnoseErrors) { 223 SanitizerMask TrapRemove; // During the loop below, the accumulated set of 224 // sanitizers disabled by the current sanitizer 225 // argument or any argument after it. 226 SanitizerMask TrappingKinds; 227 SanitizerMask TrappingSupportedWithGroups = setGroupBits(TrappingSupported); 228 229 for (const llvm::opt::Arg *Arg : llvm::reverse(Args)) { 230 if (Arg->getOption().matches(options::OPT_fsanitize_trap_EQ)) { 231 Arg->claim(); 232 SanitizerMask Add = parseArgValues(D, Arg, true); 233 Add &= ~TrapRemove; 234 SanitizerMask InvalidValues = Add & ~TrappingSupportedWithGroups; 235 if (InvalidValues && DiagnoseErrors) { 236 SanitizerSet S; 237 S.Mask = InvalidValues; 238 D.Diag(diag::err_drv_unsupported_option_argument) 239 << Arg->getOption().getName() << toString(S); 240 } 241 TrappingKinds |= expandSanitizerGroups(Add) & ~TrapRemove; 242 } else if (Arg->getOption().matches(options::OPT_fno_sanitize_trap_EQ)) { 243 Arg->claim(); 244 TrapRemove |= 245 expandSanitizerGroups(parseArgValues(D, Arg, DiagnoseErrors)); 246 } 247 } 248 249 // Apply default trapping behavior. 250 TrappingKinds |= TrappingDefault & ~TrapRemove; 251 252 return TrappingKinds; 253 } 254 255 bool SanitizerArgs::needsFuzzerInterceptors() const { 256 return needsFuzzer() && !needsAsanRt() && !needsTsanRt() && !needsMsanRt(); 257 } 258 259 bool SanitizerArgs::needsUbsanRt() const { 260 // All of these include ubsan. 261 if (needsAsanRt() || needsMsanRt() || needsHwasanRt() || needsTsanRt() || 262 needsDfsanRt() || needsLsanRt() || needsCfiDiagRt() || 263 (needsScudoRt() && !requiresMinimalRuntime())) 264 return false; 265 266 return (Sanitizers.Mask & NeedsUbsanRt & ~TrapSanitizers.Mask) || 267 CoverageFeatures; 268 } 269 270 bool SanitizerArgs::needsCfiRt() const { 271 return !(Sanitizers.Mask & SanitizerKind::CFI & ~TrapSanitizers.Mask) && 272 CfiCrossDso && !ImplicitCfiRuntime; 273 } 274 275 bool SanitizerArgs::needsCfiDiagRt() const { 276 return (Sanitizers.Mask & SanitizerKind::CFI & ~TrapSanitizers.Mask) && 277 CfiCrossDso && !ImplicitCfiRuntime; 278 } 279 280 bool SanitizerArgs::requiresPIE() const { 281 return NeedPIE || (Sanitizers.Mask & RequiresPIE); 282 } 283 284 bool SanitizerArgs::needsUnwindTables() const { 285 return static_cast<bool>(Sanitizers.Mask & NeedsUnwindTables); 286 } 287 288 bool SanitizerArgs::needsLTO() const { 289 return static_cast<bool>(Sanitizers.Mask & NeedsLTO); 290 } 291 292 SanitizerArgs::SanitizerArgs(const ToolChain &TC, 293 const llvm::opt::ArgList &Args, 294 bool DiagnoseErrors) { 295 SanitizerMask AllRemove; // During the loop below, the accumulated set of 296 // sanitizers disabled by the current sanitizer 297 // argument or any argument after it. 298 SanitizerMask AllAddedKinds; // Mask of all sanitizers ever enabled by 299 // -fsanitize= flags (directly or via group 300 // expansion), some of which may be disabled 301 // later. Used to carefully prune 302 // unused-argument diagnostics. 303 SanitizerMask DiagnosedKinds; // All Kinds we have diagnosed up to now. 304 // Used to deduplicate diagnostics. 305 SanitizerMask Kinds; 306 const SanitizerMask Supported = setGroupBits(TC.getSupportedSanitizers()); 307 308 CfiCrossDso = Args.hasFlag(options::OPT_fsanitize_cfi_cross_dso, 309 options::OPT_fno_sanitize_cfi_cross_dso, false); 310 311 ToolChain::RTTIMode RTTIMode = TC.getRTTIMode(); 312 313 const Driver &D = TC.getDriver(); 314 SanitizerMask TrappingKinds = parseSanitizeTrapArgs(D, Args, DiagnoseErrors); 315 SanitizerMask InvalidTrappingKinds = TrappingKinds & NotAllowedWithTrap; 316 317 MinimalRuntime = 318 Args.hasFlag(options::OPT_fsanitize_minimal_runtime, 319 options::OPT_fno_sanitize_minimal_runtime, MinimalRuntime); 320 321 // The object size sanitizer should not be enabled at -O0. 322 Arg *OptLevel = Args.getLastArg(options::OPT_O_Group); 323 bool RemoveObjectSizeAtO0 = 324 !OptLevel || OptLevel->getOption().matches(options::OPT_O0); 325 326 for (const llvm::opt::Arg *Arg : llvm::reverse(Args)) { 327 if (Arg->getOption().matches(options::OPT_fsanitize_EQ)) { 328 Arg->claim(); 329 SanitizerMask Add = parseArgValues(D, Arg, DiagnoseErrors); 330 331 if (RemoveObjectSizeAtO0) { 332 AllRemove |= SanitizerKind::ObjectSize; 333 334 // The user explicitly enabled the object size sanitizer. Warn 335 // that this does nothing at -O0. 336 if ((Add & SanitizerKind::ObjectSize) && DiagnoseErrors) 337 D.Diag(diag::warn_drv_object_size_disabled_O0) 338 << Arg->getAsString(Args); 339 } 340 341 AllAddedKinds |= expandSanitizerGroups(Add); 342 343 // Avoid diagnosing any sanitizer which is disabled later. 344 Add &= ~AllRemove; 345 // At this point we have not expanded groups, so any unsupported 346 // sanitizers in Add are those which have been explicitly enabled. 347 // Diagnose them. 348 if (SanitizerMask KindsToDiagnose = 349 Add & InvalidTrappingKinds & ~DiagnosedKinds) { 350 if (DiagnoseErrors) { 351 std::string Desc = describeSanitizeArg(Arg, KindsToDiagnose); 352 D.Diag(diag::err_drv_argument_not_allowed_with) 353 << Desc << "-fsanitize-trap=undefined"; 354 } 355 DiagnosedKinds |= KindsToDiagnose; 356 } 357 Add &= ~InvalidTrappingKinds; 358 359 if (MinimalRuntime) { 360 if (SanitizerMask KindsToDiagnose = 361 Add & NotAllowedWithMinimalRuntime & ~DiagnosedKinds) { 362 if (DiagnoseErrors) { 363 std::string Desc = describeSanitizeArg(Arg, KindsToDiagnose); 364 D.Diag(diag::err_drv_argument_not_allowed_with) 365 << Desc << "-fsanitize-minimal-runtime"; 366 } 367 DiagnosedKinds |= KindsToDiagnose; 368 } 369 Add &= ~NotAllowedWithMinimalRuntime; 370 } 371 372 // FIXME: Make CFI on member function calls compatible with cross-DSO CFI. 373 // There are currently two problems: 374 // - Virtual function call checks need to pass a pointer to the function 375 // address to llvm.type.test and a pointer to the address point to the 376 // diagnostic function. Currently we pass the same pointer to both 377 // places. 378 // - Non-virtual function call checks may need to check multiple type 379 // identifiers. 380 // Fixing both of those may require changes to the cross-DSO CFI 381 // interface. 382 if (CfiCrossDso && (Add & SanitizerKind::CFIMFCall & ~DiagnosedKinds)) { 383 if (DiagnoseErrors) 384 D.Diag(diag::err_drv_argument_not_allowed_with) 385 << "-fsanitize=cfi-mfcall" 386 << "-fsanitize-cfi-cross-dso"; 387 Add &= ~SanitizerKind::CFIMFCall; 388 DiagnosedKinds |= SanitizerKind::CFIMFCall; 389 } 390 391 if (SanitizerMask KindsToDiagnose = Add & ~Supported & ~DiagnosedKinds) { 392 if (DiagnoseErrors) { 393 std::string Desc = describeSanitizeArg(Arg, KindsToDiagnose); 394 D.Diag(diag::err_drv_unsupported_opt_for_target) 395 << Desc << TC.getTriple().str(); 396 } 397 DiagnosedKinds |= KindsToDiagnose; 398 } 399 Add &= Supported; 400 401 // Test for -fno-rtti + explicit -fsanitizer=vptr before expanding groups 402 // so we don't error out if -fno-rtti and -fsanitize=undefined were 403 // passed. 404 if ((Add & SanitizerKind::Vptr) && (RTTIMode == ToolChain::RM_Disabled)) { 405 if (const llvm::opt::Arg *NoRTTIArg = TC.getRTTIArg()) { 406 assert(NoRTTIArg->getOption().matches(options::OPT_fno_rtti) && 407 "RTTI disabled without -fno-rtti option?"); 408 // The user explicitly passed -fno-rtti with -fsanitize=vptr, but 409 // the vptr sanitizer requires RTTI, so this is a user error. 410 if (DiagnoseErrors) 411 D.Diag(diag::err_drv_argument_not_allowed_with) 412 << "-fsanitize=vptr" << NoRTTIArg->getAsString(Args); 413 } else { 414 // The vptr sanitizer requires RTTI, but RTTI is disabled (by 415 // default). Warn that the vptr sanitizer is being disabled. 416 if (DiagnoseErrors) 417 D.Diag(diag::warn_drv_disabling_vptr_no_rtti_default); 418 } 419 420 // Take out the Vptr sanitizer from the enabled sanitizers 421 AllRemove |= SanitizerKind::Vptr; 422 } 423 424 Add = expandSanitizerGroups(Add); 425 // Group expansion may have enabled a sanitizer which is disabled later. 426 Add &= ~AllRemove; 427 // Silently discard any unsupported sanitizers implicitly enabled through 428 // group expansion. 429 Add &= ~InvalidTrappingKinds; 430 if (MinimalRuntime) { 431 Add &= ~NotAllowedWithMinimalRuntime; 432 } 433 if (CfiCrossDso) 434 Add &= ~SanitizerKind::CFIMFCall; 435 Add &= Supported; 436 437 if (Add & SanitizerKind::Fuzzer) 438 Add |= SanitizerKind::FuzzerNoLink; 439 440 // Enable coverage if the fuzzing flag is set. 441 if (Add & SanitizerKind::FuzzerNoLink) { 442 CoverageFeatures |= CoverageInline8bitCounters | CoverageIndirCall | 443 CoverageTraceCmp | CoveragePCTable; 444 // Due to TLS differences, stack depth tracking is only enabled on Linux 445 if (TC.getTriple().isOSLinux()) 446 CoverageFeatures |= CoverageStackDepth; 447 } 448 449 Kinds |= Add; 450 } else if (Arg->getOption().matches(options::OPT_fno_sanitize_EQ)) { 451 Arg->claim(); 452 SanitizerMask Remove = parseArgValues(D, Arg, DiagnoseErrors); 453 AllRemove |= expandSanitizerGroups(Remove); 454 } 455 } 456 457 std::pair<SanitizerMask, SanitizerMask> IncompatibleGroups[] = { 458 std::make_pair(SanitizerKind::Address, 459 SanitizerKind::Thread | SanitizerKind::Memory), 460 std::make_pair(SanitizerKind::Thread, SanitizerKind::Memory), 461 std::make_pair(SanitizerKind::Leak, 462 SanitizerKind::Thread | SanitizerKind::Memory), 463 std::make_pair(SanitizerKind::KernelAddress, 464 SanitizerKind::Address | SanitizerKind::Leak | 465 SanitizerKind::Thread | SanitizerKind::Memory), 466 std::make_pair(SanitizerKind::HWAddress, 467 SanitizerKind::Address | SanitizerKind::Thread | 468 SanitizerKind::Memory | SanitizerKind::KernelAddress), 469 std::make_pair(SanitizerKind::Scudo, 470 SanitizerKind::Address | SanitizerKind::HWAddress | 471 SanitizerKind::Leak | SanitizerKind::Thread | 472 SanitizerKind::Memory | SanitizerKind::KernelAddress), 473 std::make_pair(SanitizerKind::SafeStack, 474 (TC.getTriple().isOSFuchsia() ? SanitizerMask() 475 : SanitizerKind::Leak) | 476 SanitizerKind::Address | SanitizerKind::HWAddress | 477 SanitizerKind::Thread | SanitizerKind::Memory | 478 SanitizerKind::KernelAddress), 479 std::make_pair(SanitizerKind::KernelHWAddress, 480 SanitizerKind::Address | SanitizerKind::HWAddress | 481 SanitizerKind::Leak | SanitizerKind::Thread | 482 SanitizerKind::Memory | SanitizerKind::KernelAddress | 483 SanitizerKind::SafeStack), 484 std::make_pair(SanitizerKind::KernelMemory, 485 SanitizerKind::Address | SanitizerKind::HWAddress | 486 SanitizerKind::Leak | SanitizerKind::Thread | 487 SanitizerKind::Memory | SanitizerKind::KernelAddress | 488 SanitizerKind::Scudo | SanitizerKind::SafeStack), 489 std::make_pair(SanitizerKind::MemTag, 490 SanitizerKind::Address | SanitizerKind::KernelAddress | 491 SanitizerKind::HWAddress | 492 SanitizerKind::KernelHWAddress)}; 493 // Enable toolchain specific default sanitizers if not explicitly disabled. 494 SanitizerMask Default = TC.getDefaultSanitizers() & ~AllRemove; 495 496 // Disable default sanitizers that are incompatible with explicitly requested 497 // ones. 498 for (auto G : IncompatibleGroups) { 499 SanitizerMask Group = G.first; 500 if ((Default & Group) && (Kinds & G.second)) 501 Default &= ~Group; 502 } 503 504 Kinds |= Default; 505 506 // We disable the vptr sanitizer if it was enabled by group expansion but RTTI 507 // is disabled. 508 if ((Kinds & SanitizerKind::Vptr) && (RTTIMode == ToolChain::RM_Disabled)) { 509 Kinds &= ~SanitizerKind::Vptr; 510 } 511 512 // Check that LTO is enabled if we need it. 513 if ((Kinds & NeedsLTO) && !D.isUsingLTO() && DiagnoseErrors) { 514 D.Diag(diag::err_drv_argument_only_allowed_with) 515 << lastArgumentForMask(D, Args, Kinds & NeedsLTO) << "-flto"; 516 } 517 518 if ((Kinds & SanitizerKind::ShadowCallStack) && 519 ((TC.getTriple().isAArch64() && 520 !llvm::AArch64::isX18ReservedByDefault(TC.getTriple())) || 521 TC.getTriple().isRISCV()) && 522 !Args.hasArg(options::OPT_ffixed_x18) && DiagnoseErrors) { 523 D.Diag(diag::err_drv_argument_only_allowed_with) 524 << lastArgumentForMask(D, Args, Kinds & SanitizerKind::ShadowCallStack) 525 << "-ffixed-x18"; 526 } 527 528 // Report error if there are non-trapping sanitizers that require 529 // c++abi-specific parts of UBSan runtime, and they are not provided by the 530 // toolchain. We don't have a good way to check the latter, so we just 531 // check if the toolchan supports vptr. 532 if (~Supported & SanitizerKind::Vptr) { 533 SanitizerMask KindsToDiagnose = Kinds & ~TrappingKinds & NeedsUbsanCxxRt; 534 // The runtime library supports the Microsoft C++ ABI, but only well enough 535 // for CFI. FIXME: Remove this once we support vptr on Windows. 536 if (TC.getTriple().isOSWindows()) 537 KindsToDiagnose &= ~SanitizerKind::CFI; 538 if (KindsToDiagnose) { 539 SanitizerSet S; 540 S.Mask = KindsToDiagnose; 541 if (DiagnoseErrors) 542 D.Diag(diag::err_drv_unsupported_opt_for_target) 543 << ("-fno-sanitize-trap=" + toString(S)) << TC.getTriple().str(); 544 Kinds &= ~KindsToDiagnose; 545 } 546 } 547 548 // Warn about incompatible groups of sanitizers. 549 for (auto G : IncompatibleGroups) { 550 SanitizerMask Group = G.first; 551 if (Kinds & Group) { 552 if (SanitizerMask Incompatible = Kinds & G.second) { 553 if (DiagnoseErrors) 554 D.Diag(clang::diag::err_drv_argument_not_allowed_with) 555 << lastArgumentForMask(D, Args, Group) 556 << lastArgumentForMask(D, Args, Incompatible); 557 Kinds &= ~Incompatible; 558 } 559 } 560 } 561 // FIXME: Currently -fsanitize=leak is silently ignored in the presence of 562 // -fsanitize=address. Perhaps it should print an error, or perhaps 563 // -f(-no)sanitize=leak should change whether leak detection is enabled by 564 // default in ASan? 565 566 // Parse -f(no-)?sanitize-recover flags. 567 SanitizerMask RecoverableKinds = RecoverableByDefault | AlwaysRecoverable; 568 SanitizerMask DiagnosedUnrecoverableKinds; 569 SanitizerMask DiagnosedAlwaysRecoverableKinds; 570 for (const auto *Arg : Args) { 571 if (Arg->getOption().matches(options::OPT_fsanitize_recover_EQ)) { 572 SanitizerMask Add = parseArgValues(D, Arg, DiagnoseErrors); 573 // Report error if user explicitly tries to recover from unrecoverable 574 // sanitizer. 575 if (SanitizerMask KindsToDiagnose = 576 Add & Unrecoverable & ~DiagnosedUnrecoverableKinds) { 577 SanitizerSet SetToDiagnose; 578 SetToDiagnose.Mask |= KindsToDiagnose; 579 if (DiagnoseErrors) 580 D.Diag(diag::err_drv_unsupported_option_argument) 581 << Arg->getOption().getName() << toString(SetToDiagnose); 582 DiagnosedUnrecoverableKinds |= KindsToDiagnose; 583 } 584 RecoverableKinds |= expandSanitizerGroups(Add); 585 Arg->claim(); 586 } else if (Arg->getOption().matches(options::OPT_fno_sanitize_recover_EQ)) { 587 SanitizerMask Remove = parseArgValues(D, Arg, DiagnoseErrors); 588 // Report error if user explicitly tries to disable recovery from 589 // always recoverable sanitizer. 590 if (SanitizerMask KindsToDiagnose = 591 Remove & AlwaysRecoverable & ~DiagnosedAlwaysRecoverableKinds) { 592 SanitizerSet SetToDiagnose; 593 SetToDiagnose.Mask |= KindsToDiagnose; 594 if (DiagnoseErrors) 595 D.Diag(diag::err_drv_unsupported_option_argument) 596 << Arg->getOption().getName() << toString(SetToDiagnose); 597 DiagnosedAlwaysRecoverableKinds |= KindsToDiagnose; 598 } 599 RecoverableKinds &= ~expandSanitizerGroups(Remove); 600 Arg->claim(); 601 } 602 } 603 RecoverableKinds &= Kinds; 604 RecoverableKinds &= ~Unrecoverable; 605 606 TrappingKinds &= Kinds; 607 RecoverableKinds &= ~TrappingKinds; 608 609 // Setup ignorelist files. 610 // Add default ignorelist from resource directory for activated sanitizers, 611 // and validate special case lists format. 612 if (!Args.hasArgNoClaim(options::OPT_fno_sanitize_ignorelist)) 613 addDefaultIgnorelists(D, Kinds, SystemIgnorelistFiles, DiagnoseErrors); 614 615 // Parse -f(no-)?sanitize-ignorelist options. 616 // This also validates special case lists format. 617 parseSpecialCaseListArg( 618 D, Args, UserIgnorelistFiles, options::OPT_fsanitize_ignorelist_EQ, 619 options::OPT_fno_sanitize_ignorelist, 620 clang::diag::err_drv_malformed_sanitizer_ignorelist, DiagnoseErrors); 621 622 // Parse -f[no-]sanitize-memory-track-origins[=level] options. 623 if (AllAddedKinds & SanitizerKind::Memory) { 624 if (Arg *A = 625 Args.getLastArg(options::OPT_fsanitize_memory_track_origins_EQ, 626 options::OPT_fsanitize_memory_track_origins, 627 options::OPT_fno_sanitize_memory_track_origins)) { 628 if (A->getOption().matches(options::OPT_fsanitize_memory_track_origins)) { 629 MsanTrackOrigins = 2; 630 } else if (A->getOption().matches( 631 options::OPT_fno_sanitize_memory_track_origins)) { 632 MsanTrackOrigins = 0; 633 } else { 634 StringRef S = A->getValue(); 635 if (S.getAsInteger(0, MsanTrackOrigins) || MsanTrackOrigins < 0 || 636 MsanTrackOrigins > 2) { 637 if (DiagnoseErrors) 638 D.Diag(clang::diag::err_drv_invalid_value) 639 << A->getAsString(Args) << S; 640 } 641 } 642 } 643 MsanUseAfterDtor = Args.hasFlag( 644 options::OPT_fsanitize_memory_use_after_dtor, 645 options::OPT_fno_sanitize_memory_use_after_dtor, MsanUseAfterDtor); 646 MsanParamRetval = Args.hasFlag( 647 options::OPT_fsanitize_memory_param_retval, 648 options::OPT_fno_sanitize_memory_param_retval, MsanParamRetval); 649 NeedPIE |= !(TC.getTriple().isOSLinux() && 650 TC.getTriple().getArch() == llvm::Triple::x86_64); 651 } else if (AllAddedKinds & SanitizerKind::KernelMemory) { 652 MsanUseAfterDtor = false; 653 MsanParamRetval = Args.hasFlag( 654 options::OPT_fsanitize_memory_param_retval, 655 options::OPT_fno_sanitize_memory_param_retval, MsanParamRetval); 656 } else { 657 MsanUseAfterDtor = false; 658 MsanParamRetval = false; 659 } 660 661 if (AllAddedKinds & SanitizerKind::MemTag) { 662 StringRef S = 663 Args.getLastArgValue(options::OPT_fsanitize_memtag_mode_EQ, "sync"); 664 if (S == "async" || S == "sync") { 665 MemtagMode = S.str(); 666 } else { 667 D.Diag(clang::diag::err_drv_invalid_value_with_suggestion) 668 << "-fsanitize-memtag-mode=" << S << "{async, sync}"; 669 MemtagMode = "sync"; 670 } 671 } 672 673 if (AllAddedKinds & SanitizerKind::Thread) { 674 TsanMemoryAccess = Args.hasFlag( 675 options::OPT_fsanitize_thread_memory_access, 676 options::OPT_fno_sanitize_thread_memory_access, TsanMemoryAccess); 677 TsanFuncEntryExit = Args.hasFlag( 678 options::OPT_fsanitize_thread_func_entry_exit, 679 options::OPT_fno_sanitize_thread_func_entry_exit, TsanFuncEntryExit); 680 TsanAtomics = 681 Args.hasFlag(options::OPT_fsanitize_thread_atomics, 682 options::OPT_fno_sanitize_thread_atomics, TsanAtomics); 683 } 684 685 if (AllAddedKinds & SanitizerKind::CFI) { 686 // Without PIE, external function address may resolve to a PLT record, which 687 // can not be verified by the target module. 688 NeedPIE |= CfiCrossDso; 689 CfiICallGeneralizePointers = 690 Args.hasArg(options::OPT_fsanitize_cfi_icall_generalize_pointers); 691 692 if (CfiCrossDso && CfiICallGeneralizePointers && DiagnoseErrors) 693 D.Diag(diag::err_drv_argument_not_allowed_with) 694 << "-fsanitize-cfi-cross-dso" 695 << "-fsanitize-cfi-icall-generalize-pointers"; 696 697 CfiCanonicalJumpTables = 698 Args.hasFlag(options::OPT_fsanitize_cfi_canonical_jump_tables, 699 options::OPT_fno_sanitize_cfi_canonical_jump_tables, true); 700 } 701 702 Stats = Args.hasFlag(options::OPT_fsanitize_stats, 703 options::OPT_fno_sanitize_stats, false); 704 705 if (MinimalRuntime) { 706 SanitizerMask IncompatibleMask = 707 Kinds & ~setGroupBits(CompatibleWithMinimalRuntime); 708 if (IncompatibleMask && DiagnoseErrors) 709 D.Diag(clang::diag::err_drv_argument_not_allowed_with) 710 << "-fsanitize-minimal-runtime" 711 << lastArgumentForMask(D, Args, IncompatibleMask); 712 713 SanitizerMask NonTrappingCfi = Kinds & SanitizerKind::CFI & ~TrappingKinds; 714 if (NonTrappingCfi && DiagnoseErrors) 715 D.Diag(clang::diag::err_drv_argument_only_allowed_with) 716 << "fsanitize-minimal-runtime" 717 << "fsanitize-trap=cfi"; 718 } 719 720 // Parse -f(no-)?sanitize-coverage flags if coverage is supported by the 721 // enabled sanitizers. 722 for (const auto *Arg : Args) { 723 if (Arg->getOption().matches(options::OPT_fsanitize_coverage)) { 724 int LegacySanitizeCoverage; 725 if (Arg->getNumValues() == 1 && 726 !StringRef(Arg->getValue(0)) 727 .getAsInteger(0, LegacySanitizeCoverage)) { 728 CoverageFeatures = 0; 729 Arg->claim(); 730 if (LegacySanitizeCoverage != 0 && DiagnoseErrors) { 731 D.Diag(diag::warn_drv_deprecated_arg) 732 << Arg->getAsString(Args) << "-fsanitize-coverage=trace-pc-guard"; 733 } 734 continue; 735 } 736 CoverageFeatures |= parseCoverageFeatures(D, Arg, DiagnoseErrors); 737 738 // Disable coverage and not claim the flags if there is at least one 739 // non-supporting sanitizer. 740 if (!(AllAddedKinds & ~AllRemove & ~setGroupBits(SupportsCoverage))) { 741 Arg->claim(); 742 } else { 743 CoverageFeatures = 0; 744 } 745 } else if (Arg->getOption().matches(options::OPT_fno_sanitize_coverage)) { 746 Arg->claim(); 747 CoverageFeatures &= ~parseCoverageFeatures(D, Arg, DiagnoseErrors); 748 } 749 } 750 // Choose at most one coverage type: function, bb, or edge. 751 if (DiagnoseErrors) { 752 if ((CoverageFeatures & CoverageFunc) && (CoverageFeatures & CoverageBB)) 753 D.Diag(clang::diag::err_drv_argument_not_allowed_with) 754 << "-fsanitize-coverage=func" 755 << "-fsanitize-coverage=bb"; 756 if ((CoverageFeatures & CoverageFunc) && (CoverageFeatures & CoverageEdge)) 757 D.Diag(clang::diag::err_drv_argument_not_allowed_with) 758 << "-fsanitize-coverage=func" 759 << "-fsanitize-coverage=edge"; 760 if ((CoverageFeatures & CoverageBB) && (CoverageFeatures & CoverageEdge)) 761 D.Diag(clang::diag::err_drv_argument_not_allowed_with) 762 << "-fsanitize-coverage=bb" 763 << "-fsanitize-coverage=edge"; 764 // Basic block tracing and 8-bit counters require some type of coverage 765 // enabled. 766 if (CoverageFeatures & CoverageTraceBB) 767 D.Diag(clang::diag::warn_drv_deprecated_arg) 768 << "-fsanitize-coverage=trace-bb" 769 << "-fsanitize-coverage=trace-pc-guard"; 770 if (CoverageFeatures & Coverage8bitCounters) 771 D.Diag(clang::diag::warn_drv_deprecated_arg) 772 << "-fsanitize-coverage=8bit-counters" 773 << "-fsanitize-coverage=trace-pc-guard"; 774 } 775 776 int InsertionPointTypes = CoverageFunc | CoverageBB | CoverageEdge; 777 int InstrumentationTypes = CoverageTracePC | CoverageTracePCGuard | 778 CoverageInline8bitCounters | CoverageTraceLoads | 779 CoverageTraceStores | CoverageInlineBoolFlag; 780 if ((CoverageFeatures & InsertionPointTypes) && 781 !(CoverageFeatures & InstrumentationTypes) && DiagnoseErrors) { 782 D.Diag(clang::diag::warn_drv_deprecated_arg) 783 << "-fsanitize-coverage=[func|bb|edge]" 784 << "-fsanitize-coverage=[func|bb|edge],[trace-pc-guard|trace-pc]"; 785 } 786 787 // trace-pc w/o func/bb/edge implies edge. 788 if (!(CoverageFeatures & InsertionPointTypes)) { 789 if (CoverageFeatures & 790 (CoverageTracePC | CoverageTracePCGuard | CoverageInline8bitCounters | 791 CoverageInlineBoolFlag)) 792 CoverageFeatures |= CoverageEdge; 793 794 if (CoverageFeatures & CoverageStackDepth) 795 CoverageFeatures |= CoverageFunc; 796 } 797 798 // Parse -fsanitize-coverage-(allow|ignore)list options if coverage enabled. 799 // This also validates special case lists format. 800 // Here, OptSpecifier() acts as a never-matching command-line argument. 801 // So, there is no way to clear coverage lists but you can append to them. 802 if (CoverageFeatures) { 803 parseSpecialCaseListArg( 804 D, Args, CoverageAllowlistFiles, 805 options::OPT_fsanitize_coverage_allowlist, OptSpecifier(), 806 clang::diag::err_drv_malformed_sanitizer_coverage_allowlist, 807 DiagnoseErrors); 808 parseSpecialCaseListArg( 809 D, Args, CoverageIgnorelistFiles, 810 options::OPT_fsanitize_coverage_ignorelist, OptSpecifier(), 811 clang::diag::err_drv_malformed_sanitizer_coverage_ignorelist, 812 DiagnoseErrors); 813 } 814 815 SharedRuntime = 816 Args.hasFlag(options::OPT_shared_libsan, options::OPT_static_libsan, 817 TC.getTriple().isAndroid() || TC.getTriple().isOSFuchsia() || 818 TC.getTriple().isOSDarwin()); 819 820 ImplicitCfiRuntime = TC.getTriple().isAndroid(); 821 822 if (AllAddedKinds & SanitizerKind::Address) { 823 NeedPIE |= TC.getTriple().isOSFuchsia(); 824 if (Arg *A = 825 Args.getLastArg(options::OPT_fsanitize_address_field_padding)) { 826 StringRef S = A->getValue(); 827 // Legal values are 0 and 1, 2, but in future we may add more levels. 828 if ((S.getAsInteger(0, AsanFieldPadding) || AsanFieldPadding < 0 || 829 AsanFieldPadding > 2) && 830 DiagnoseErrors) { 831 D.Diag(clang::diag::err_drv_invalid_value) << A->getAsString(Args) << S; 832 } 833 } 834 835 if (Arg *WindowsDebugRTArg = 836 Args.getLastArg(options::OPT__SLASH_MTd, options::OPT__SLASH_MT, 837 options::OPT__SLASH_MDd, options::OPT__SLASH_MD, 838 options::OPT__SLASH_LDd, options::OPT__SLASH_LD)) { 839 switch (WindowsDebugRTArg->getOption().getID()) { 840 case options::OPT__SLASH_MTd: 841 case options::OPT__SLASH_MDd: 842 case options::OPT__SLASH_LDd: 843 if (DiagnoseErrors) { 844 D.Diag(clang::diag::err_drv_argument_not_allowed_with) 845 << WindowsDebugRTArg->getAsString(Args) 846 << lastArgumentForMask(D, Args, SanitizerKind::Address); 847 D.Diag(clang::diag::note_drv_address_sanitizer_debug_runtime); 848 } 849 } 850 } 851 852 AsanUseAfterScope = Args.hasFlag( 853 options::OPT_fsanitize_address_use_after_scope, 854 options::OPT_fno_sanitize_address_use_after_scope, AsanUseAfterScope); 855 856 AsanPoisonCustomArrayCookie = Args.hasFlag( 857 options::OPT_fsanitize_address_poison_custom_array_cookie, 858 options::OPT_fno_sanitize_address_poison_custom_array_cookie, 859 AsanPoisonCustomArrayCookie); 860 861 AsanOutlineInstrumentation = 862 Args.hasFlag(options::OPT_fsanitize_address_outline_instrumentation, 863 options::OPT_fno_sanitize_address_outline_instrumentation, 864 AsanOutlineInstrumentation); 865 866 // As a workaround for a bug in gold 2.26 and earlier, dead stripping of 867 // globals in ASan is disabled by default on most ELF targets. 868 // See https://sourceware.org/bugzilla/show_bug.cgi?id=19002 869 AsanGlobalsDeadStripping = Args.hasFlag( 870 options::OPT_fsanitize_address_globals_dead_stripping, 871 options::OPT_fno_sanitize_address_globals_dead_stripping, 872 !TC.getTriple().isOSBinFormatELF() || TC.getTriple().isOSFuchsia() || 873 TC.getTriple().isPS()); 874 875 AsanUseOdrIndicator = 876 Args.hasFlag(options::OPT_fsanitize_address_use_odr_indicator, 877 options::OPT_fno_sanitize_address_use_odr_indicator, 878 AsanUseOdrIndicator); 879 880 if (AllAddedKinds & SanitizerKind::PointerCompare & ~AllRemove) { 881 AsanInvalidPointerCmp = true; 882 } 883 884 if (AllAddedKinds & SanitizerKind::PointerSubtract & ~AllRemove) { 885 AsanInvalidPointerSub = true; 886 } 887 888 if (TC.getTriple().isOSDarwin() && 889 (Args.hasArg(options::OPT_mkernel) || 890 Args.hasArg(options::OPT_fapple_kext))) { 891 AsanDtorKind = llvm::AsanDtorKind::None; 892 } 893 894 if (const auto *Arg = 895 Args.getLastArg(options::OPT_sanitize_address_destructor_EQ)) { 896 auto parsedAsanDtorKind = AsanDtorKindFromString(Arg->getValue()); 897 if (parsedAsanDtorKind == llvm::AsanDtorKind::Invalid && DiagnoseErrors) { 898 TC.getDriver().Diag(clang::diag::err_drv_unsupported_option_argument) 899 << Arg->getOption().getName() << Arg->getValue(); 900 } 901 AsanDtorKind = parsedAsanDtorKind; 902 } 903 904 if (const auto *Arg = Args.getLastArg( 905 options::OPT_sanitize_address_use_after_return_EQ)) { 906 auto parsedAsanUseAfterReturn = 907 AsanDetectStackUseAfterReturnModeFromString(Arg->getValue()); 908 if (parsedAsanUseAfterReturn == 909 llvm::AsanDetectStackUseAfterReturnMode::Invalid && 910 DiagnoseErrors) { 911 TC.getDriver().Diag(clang::diag::err_drv_unsupported_option_argument) 912 << Arg->getOption().getName() << Arg->getValue(); 913 } 914 AsanUseAfterReturn = parsedAsanUseAfterReturn; 915 } 916 917 } else { 918 AsanUseAfterScope = false; 919 // -fsanitize=pointer-compare/pointer-subtract requires -fsanitize=address. 920 SanitizerMask DetectInvalidPointerPairs = 921 SanitizerKind::PointerCompare | SanitizerKind::PointerSubtract; 922 if ((AllAddedKinds & DetectInvalidPointerPairs & ~AllRemove) && 923 DiagnoseErrors) { 924 TC.getDriver().Diag(clang::diag::err_drv_argument_only_allowed_with) 925 << lastArgumentForMask(D, Args, 926 SanitizerKind::PointerCompare | 927 SanitizerKind::PointerSubtract) 928 << "-fsanitize=address"; 929 } 930 } 931 932 if (AllAddedKinds & SanitizerKind::HWAddress) { 933 if (Arg *HwasanAbiArg = 934 Args.getLastArg(options::OPT_fsanitize_hwaddress_abi_EQ)) { 935 HwasanAbi = HwasanAbiArg->getValue(); 936 if (HwasanAbi != "platform" && HwasanAbi != "interceptor" && 937 DiagnoseErrors) 938 D.Diag(clang::diag::err_drv_invalid_value) 939 << HwasanAbiArg->getAsString(Args) << HwasanAbi; 940 } else { 941 HwasanAbi = "interceptor"; 942 } 943 if (TC.getTriple().getArch() == llvm::Triple::x86_64) 944 HwasanUseAliases = Args.hasFlag( 945 options::OPT_fsanitize_hwaddress_experimental_aliasing, 946 options::OPT_fno_sanitize_hwaddress_experimental_aliasing, 947 HwasanUseAliases); 948 } 949 950 if (AllAddedKinds & SanitizerKind::SafeStack) { 951 // SafeStack runtime is built into the system on Android and Fuchsia. 952 SafeStackRuntime = 953 !TC.getTriple().isAndroid() && !TC.getTriple().isOSFuchsia(); 954 } 955 956 LinkRuntimes = 957 Args.hasFlag(options::OPT_fsanitize_link_runtime, 958 options::OPT_fno_sanitize_link_runtime, LinkRuntimes); 959 960 // Parse -link-cxx-sanitizer flag. 961 LinkCXXRuntimes = Args.hasArg(options::OPT_fsanitize_link_cxx_runtime, 962 options::OPT_fno_sanitize_link_cxx_runtime, 963 LinkCXXRuntimes) || 964 D.CCCIsCXX(); 965 966 NeedsMemProfRt = Args.hasFlag(options::OPT_fmemory_profile, 967 options::OPT_fmemory_profile_EQ, 968 options::OPT_fno_memory_profile, false); 969 970 // Finally, initialize the set of available and recoverable sanitizers. 971 Sanitizers.Mask |= Kinds; 972 RecoverableSanitizers.Mask |= RecoverableKinds; 973 TrapSanitizers.Mask |= TrappingKinds; 974 assert(!(RecoverableKinds & TrappingKinds) && 975 "Overlap between recoverable and trapping sanitizers"); 976 } 977 978 static std::string toString(const clang::SanitizerSet &Sanitizers) { 979 std::string Res; 980 #define SANITIZER(NAME, ID) \ 981 if (Sanitizers.has(SanitizerKind::ID)) { \ 982 if (!Res.empty()) \ 983 Res += ","; \ 984 Res += NAME; \ 985 } 986 #include "clang/Basic/Sanitizers.def" 987 return Res; 988 } 989 990 static void addSpecialCaseListOpt(const llvm::opt::ArgList &Args, 991 llvm::opt::ArgStringList &CmdArgs, 992 const char *SCLOptFlag, 993 const std::vector<std::string> &SCLFiles) { 994 for (const auto &SCLPath : SCLFiles) { 995 SmallString<64> SCLOpt(SCLOptFlag); 996 SCLOpt += SCLPath; 997 CmdArgs.push_back(Args.MakeArgString(SCLOpt)); 998 } 999 } 1000 1001 static void addIncludeLinkerOption(const ToolChain &TC, 1002 const llvm::opt::ArgList &Args, 1003 llvm::opt::ArgStringList &CmdArgs, 1004 StringRef SymbolName) { 1005 SmallString<64> LinkerOptionFlag; 1006 LinkerOptionFlag = "--linker-option=/include:"; 1007 if (TC.getTriple().getArch() == llvm::Triple::x86) { 1008 // Win32 mangles C function names with a '_' prefix. 1009 LinkerOptionFlag += '_'; 1010 } 1011 LinkerOptionFlag += SymbolName; 1012 CmdArgs.push_back(Args.MakeArgString(LinkerOptionFlag)); 1013 } 1014 1015 static bool hasTargetFeatureMTE(const llvm::opt::ArgStringList &CmdArgs) { 1016 for (auto Start = CmdArgs.begin(), End = CmdArgs.end(); Start != End; 1017 ++Start) { 1018 auto It = std::find(Start, End, StringRef("+mte")); 1019 if (It == End) 1020 break; 1021 if (It > Start && *std::prev(It) == StringRef("-target-feature")) 1022 return true; 1023 Start = It; 1024 } 1025 return false; 1026 } 1027 1028 void SanitizerArgs::addArgs(const ToolChain &TC, const llvm::opt::ArgList &Args, 1029 llvm::opt::ArgStringList &CmdArgs, 1030 types::ID InputType) const { 1031 // NVPTX doesn't currently support sanitizers. Bailing out here means 1032 // that e.g. -fsanitize=address applies only to host code, which is what we 1033 // want for now. 1034 // 1035 // AMDGPU sanitizer support is experimental and controlled by -fgpu-sanitize. 1036 if (TC.getTriple().isNVPTX() || 1037 (TC.getTriple().isAMDGPU() && 1038 !Args.hasFlag(options::OPT_fgpu_sanitize, options::OPT_fno_gpu_sanitize, 1039 true))) 1040 return; 1041 1042 // Translate available CoverageFeatures to corresponding clang-cc1 flags. 1043 // Do it even if Sanitizers.empty() since some forms of coverage don't require 1044 // sanitizers. 1045 std::pair<int, const char *> CoverageFlags[] = { 1046 std::make_pair(CoverageFunc, "-fsanitize-coverage-type=1"), 1047 std::make_pair(CoverageBB, "-fsanitize-coverage-type=2"), 1048 std::make_pair(CoverageEdge, "-fsanitize-coverage-type=3"), 1049 std::make_pair(CoverageIndirCall, "-fsanitize-coverage-indirect-calls"), 1050 std::make_pair(CoverageTraceBB, "-fsanitize-coverage-trace-bb"), 1051 std::make_pair(CoverageTraceCmp, "-fsanitize-coverage-trace-cmp"), 1052 std::make_pair(CoverageTraceDiv, "-fsanitize-coverage-trace-div"), 1053 std::make_pair(CoverageTraceGep, "-fsanitize-coverage-trace-gep"), 1054 std::make_pair(Coverage8bitCounters, "-fsanitize-coverage-8bit-counters"), 1055 std::make_pair(CoverageTracePC, "-fsanitize-coverage-trace-pc"), 1056 std::make_pair(CoverageTracePCGuard, 1057 "-fsanitize-coverage-trace-pc-guard"), 1058 std::make_pair(CoverageInline8bitCounters, 1059 "-fsanitize-coverage-inline-8bit-counters"), 1060 std::make_pair(CoverageInlineBoolFlag, 1061 "-fsanitize-coverage-inline-bool-flag"), 1062 std::make_pair(CoveragePCTable, "-fsanitize-coverage-pc-table"), 1063 std::make_pair(CoverageNoPrune, "-fsanitize-coverage-no-prune"), 1064 std::make_pair(CoverageStackDepth, "-fsanitize-coverage-stack-depth"), 1065 std::make_pair(CoverageTraceLoads, "-fsanitize-coverage-trace-loads"), 1066 std::make_pair(CoverageTraceStores, "-fsanitize-coverage-trace-stores")}; 1067 for (auto F : CoverageFlags) { 1068 if (CoverageFeatures & F.first) 1069 CmdArgs.push_back(F.second); 1070 } 1071 addSpecialCaseListOpt( 1072 Args, CmdArgs, "-fsanitize-coverage-allowlist=", CoverageAllowlistFiles); 1073 addSpecialCaseListOpt(Args, CmdArgs, "-fsanitize-coverage-ignorelist=", 1074 CoverageIgnorelistFiles); 1075 1076 if (TC.getTriple().isOSWindows() && needsUbsanRt()) { 1077 // Instruct the code generator to embed linker directives in the object file 1078 // that cause the required runtime libraries to be linked. 1079 CmdArgs.push_back( 1080 Args.MakeArgString("--dependent-lib=" + 1081 TC.getCompilerRTBasename(Args, "ubsan_standalone"))); 1082 if (types::isCXX(InputType)) 1083 CmdArgs.push_back(Args.MakeArgString( 1084 "--dependent-lib=" + 1085 TC.getCompilerRTBasename(Args, "ubsan_standalone_cxx"))); 1086 } 1087 if (TC.getTriple().isOSWindows() && needsStatsRt()) { 1088 CmdArgs.push_back(Args.MakeArgString( 1089 "--dependent-lib=" + TC.getCompilerRTBasename(Args, "stats_client"))); 1090 1091 // The main executable must export the stats runtime. 1092 // FIXME: Only exporting from the main executable (e.g. based on whether the 1093 // translation unit defines main()) would save a little space, but having 1094 // multiple copies of the runtime shouldn't hurt. 1095 CmdArgs.push_back(Args.MakeArgString( 1096 "--dependent-lib=" + TC.getCompilerRTBasename(Args, "stats"))); 1097 addIncludeLinkerOption(TC, Args, CmdArgs, "__sanitizer_stats_register"); 1098 } 1099 1100 if (Sanitizers.empty()) 1101 return; 1102 CmdArgs.push_back(Args.MakeArgString("-fsanitize=" + toString(Sanitizers))); 1103 1104 if (!RecoverableSanitizers.empty()) 1105 CmdArgs.push_back(Args.MakeArgString("-fsanitize-recover=" + 1106 toString(RecoverableSanitizers))); 1107 1108 if (!TrapSanitizers.empty()) 1109 CmdArgs.push_back( 1110 Args.MakeArgString("-fsanitize-trap=" + toString(TrapSanitizers))); 1111 1112 addSpecialCaseListOpt(Args, CmdArgs, 1113 "-fsanitize-ignorelist=", UserIgnorelistFiles); 1114 addSpecialCaseListOpt(Args, CmdArgs, 1115 "-fsanitize-system-ignorelist=", SystemIgnorelistFiles); 1116 1117 if (MsanTrackOrigins) 1118 CmdArgs.push_back(Args.MakeArgString("-fsanitize-memory-track-origins=" + 1119 Twine(MsanTrackOrigins))); 1120 1121 if (MsanUseAfterDtor) 1122 CmdArgs.push_back("-fsanitize-memory-use-after-dtor"); 1123 1124 if (MsanParamRetval) 1125 CmdArgs.push_back("-fsanitize-memory-param-retval"); 1126 1127 // FIXME: Pass these parameters as function attributes, not as -llvm flags. 1128 if (!TsanMemoryAccess) { 1129 CmdArgs.push_back("-mllvm"); 1130 CmdArgs.push_back("-tsan-instrument-memory-accesses=0"); 1131 CmdArgs.push_back("-mllvm"); 1132 CmdArgs.push_back("-tsan-instrument-memintrinsics=0"); 1133 } 1134 if (!TsanFuncEntryExit) { 1135 CmdArgs.push_back("-mllvm"); 1136 CmdArgs.push_back("-tsan-instrument-func-entry-exit=0"); 1137 } 1138 if (!TsanAtomics) { 1139 CmdArgs.push_back("-mllvm"); 1140 CmdArgs.push_back("-tsan-instrument-atomics=0"); 1141 } 1142 1143 if (HwasanUseAliases) { 1144 CmdArgs.push_back("-mllvm"); 1145 CmdArgs.push_back("-hwasan-experimental-use-page-aliases=1"); 1146 } 1147 1148 if (CfiCrossDso) 1149 CmdArgs.push_back("-fsanitize-cfi-cross-dso"); 1150 1151 if (CfiICallGeneralizePointers) 1152 CmdArgs.push_back("-fsanitize-cfi-icall-generalize-pointers"); 1153 1154 if (CfiCanonicalJumpTables) 1155 CmdArgs.push_back("-fsanitize-cfi-canonical-jump-tables"); 1156 1157 if (Stats) 1158 CmdArgs.push_back("-fsanitize-stats"); 1159 1160 if (MinimalRuntime) 1161 CmdArgs.push_back("-fsanitize-minimal-runtime"); 1162 1163 if (AsanFieldPadding) 1164 CmdArgs.push_back(Args.MakeArgString("-fsanitize-address-field-padding=" + 1165 Twine(AsanFieldPadding))); 1166 1167 if (AsanUseAfterScope) 1168 CmdArgs.push_back("-fsanitize-address-use-after-scope"); 1169 1170 if (AsanPoisonCustomArrayCookie) 1171 CmdArgs.push_back("-fsanitize-address-poison-custom-array-cookie"); 1172 1173 if (AsanGlobalsDeadStripping) 1174 CmdArgs.push_back("-fsanitize-address-globals-dead-stripping"); 1175 1176 if (AsanUseOdrIndicator) 1177 CmdArgs.push_back("-fsanitize-address-use-odr-indicator"); 1178 1179 if (AsanInvalidPointerCmp) { 1180 CmdArgs.push_back("-mllvm"); 1181 CmdArgs.push_back("-asan-detect-invalid-pointer-cmp"); 1182 } 1183 1184 if (AsanInvalidPointerSub) { 1185 CmdArgs.push_back("-mllvm"); 1186 CmdArgs.push_back("-asan-detect-invalid-pointer-sub"); 1187 } 1188 1189 if (AsanOutlineInstrumentation) { 1190 CmdArgs.push_back("-mllvm"); 1191 CmdArgs.push_back("-asan-instrumentation-with-call-threshold=0"); 1192 } 1193 1194 // Only pass the option to the frontend if the user requested, 1195 // otherwise the frontend will just use the codegen default. 1196 if (AsanDtorKind != llvm::AsanDtorKind::Invalid) { 1197 CmdArgs.push_back(Args.MakeArgString("-fsanitize-address-destructor=" + 1198 AsanDtorKindToString(AsanDtorKind))); 1199 } 1200 1201 if (AsanUseAfterReturn != llvm::AsanDetectStackUseAfterReturnMode::Invalid) { 1202 CmdArgs.push_back(Args.MakeArgString( 1203 "-fsanitize-address-use-after-return=" + 1204 AsanDetectStackUseAfterReturnModeToString(AsanUseAfterReturn))); 1205 } 1206 1207 if (!HwasanAbi.empty()) { 1208 CmdArgs.push_back("-default-function-attr"); 1209 CmdArgs.push_back(Args.MakeArgString("hwasan-abi=" + HwasanAbi)); 1210 } 1211 1212 if (Sanitizers.has(SanitizerKind::HWAddress) && !HwasanUseAliases) { 1213 CmdArgs.push_back("-target-feature"); 1214 CmdArgs.push_back("+tagged-globals"); 1215 } 1216 1217 // MSan: Workaround for PR16386. 1218 // ASan: This is mainly to help LSan with cases such as 1219 // https://github.com/google/sanitizers/issues/373 1220 // We can't make this conditional on -fsanitize=leak, as that flag shouldn't 1221 // affect compilation. 1222 if (Sanitizers.has(SanitizerKind::Memory) || 1223 Sanitizers.has(SanitizerKind::Address)) 1224 CmdArgs.push_back("-fno-assume-sane-operator-new"); 1225 1226 // libFuzzer wants to intercept calls to certain library functions, so the 1227 // following -fno-builtin-* flags force the compiler to emit interposable 1228 // libcalls to these functions. Other sanitizers effectively do the same thing 1229 // by marking all library call sites with NoBuiltin attribute in their LLVM 1230 // pass. (see llvm::maybeMarkSanitizerLibraryCallNoBuiltin) 1231 if (Sanitizers.has(SanitizerKind::FuzzerNoLink)) { 1232 CmdArgs.push_back("-fno-builtin-bcmp"); 1233 CmdArgs.push_back("-fno-builtin-memcmp"); 1234 CmdArgs.push_back("-fno-builtin-strncmp"); 1235 CmdArgs.push_back("-fno-builtin-strcmp"); 1236 CmdArgs.push_back("-fno-builtin-strncasecmp"); 1237 CmdArgs.push_back("-fno-builtin-strcasecmp"); 1238 CmdArgs.push_back("-fno-builtin-strstr"); 1239 CmdArgs.push_back("-fno-builtin-strcasestr"); 1240 CmdArgs.push_back("-fno-builtin-memmem"); 1241 } 1242 1243 // Require -fvisibility= flag on non-Windows when compiling if vptr CFI is 1244 // enabled. 1245 if (Sanitizers.hasOneOf(CFIClasses) && !TC.getTriple().isOSWindows() && 1246 !Args.hasArg(options::OPT_fvisibility_EQ)) { 1247 TC.getDriver().Diag(clang::diag::err_drv_argument_only_allowed_with) 1248 << lastArgumentForMask(TC.getDriver(), Args, 1249 Sanitizers.Mask & CFIClasses) 1250 << "-fvisibility="; 1251 } 1252 1253 if (Sanitizers.has(SanitizerKind::MemtagStack) && 1254 !hasTargetFeatureMTE(CmdArgs)) 1255 TC.getDriver().Diag(diag::err_stack_tagging_requires_hardware_feature); 1256 } 1257 1258 SanitizerMask parseArgValues(const Driver &D, const llvm::opt::Arg *A, 1259 bool DiagnoseErrors) { 1260 assert((A->getOption().matches(options::OPT_fsanitize_EQ) || 1261 A->getOption().matches(options::OPT_fno_sanitize_EQ) || 1262 A->getOption().matches(options::OPT_fsanitize_recover_EQ) || 1263 A->getOption().matches(options::OPT_fno_sanitize_recover_EQ) || 1264 A->getOption().matches(options::OPT_fsanitize_trap_EQ) || 1265 A->getOption().matches(options::OPT_fno_sanitize_trap_EQ)) && 1266 "Invalid argument in parseArgValues!"); 1267 SanitizerMask Kinds; 1268 for (int i = 0, n = A->getNumValues(); i != n; ++i) { 1269 const char *Value = A->getValue(i); 1270 SanitizerMask Kind; 1271 // Special case: don't accept -fsanitize=all. 1272 if (A->getOption().matches(options::OPT_fsanitize_EQ) && 1273 0 == strcmp("all", Value)) 1274 Kind = SanitizerMask(); 1275 else 1276 Kind = parseSanitizerValue(Value, /*AllowGroups=*/true); 1277 1278 if (Kind) 1279 Kinds |= Kind; 1280 else if (DiagnoseErrors) 1281 D.Diag(clang::diag::err_drv_unsupported_option_argument) 1282 << A->getOption().getName() << Value; 1283 } 1284 return Kinds; 1285 } 1286 1287 int parseCoverageFeatures(const Driver &D, const llvm::opt::Arg *A, 1288 bool DiagnoseErrors) { 1289 assert(A->getOption().matches(options::OPT_fsanitize_coverage) || 1290 A->getOption().matches(options::OPT_fno_sanitize_coverage)); 1291 int Features = 0; 1292 for (int i = 0, n = A->getNumValues(); i != n; ++i) { 1293 const char *Value = A->getValue(i); 1294 int F = llvm::StringSwitch<int>(Value) 1295 .Case("func", CoverageFunc) 1296 .Case("bb", CoverageBB) 1297 .Case("edge", CoverageEdge) 1298 .Case("indirect-calls", CoverageIndirCall) 1299 .Case("trace-bb", CoverageTraceBB) 1300 .Case("trace-cmp", CoverageTraceCmp) 1301 .Case("trace-div", CoverageTraceDiv) 1302 .Case("trace-gep", CoverageTraceGep) 1303 .Case("8bit-counters", Coverage8bitCounters) 1304 .Case("trace-pc", CoverageTracePC) 1305 .Case("trace-pc-guard", CoverageTracePCGuard) 1306 .Case("no-prune", CoverageNoPrune) 1307 .Case("inline-8bit-counters", CoverageInline8bitCounters) 1308 .Case("inline-bool-flag", CoverageInlineBoolFlag) 1309 .Case("pc-table", CoveragePCTable) 1310 .Case("stack-depth", CoverageStackDepth) 1311 .Case("trace-loads", CoverageTraceLoads) 1312 .Case("trace-stores", CoverageTraceStores) 1313 .Default(0); 1314 if (F == 0 && DiagnoseErrors) 1315 D.Diag(clang::diag::err_drv_unsupported_option_argument) 1316 << A->getOption().getName() << Value; 1317 Features |= F; 1318 } 1319 return Features; 1320 } 1321 1322 std::string lastArgumentForMask(const Driver &D, const llvm::opt::ArgList &Args, 1323 SanitizerMask Mask) { 1324 for (llvm::opt::ArgList::const_reverse_iterator I = Args.rbegin(), 1325 E = Args.rend(); 1326 I != E; ++I) { 1327 const auto *Arg = *I; 1328 if (Arg->getOption().matches(options::OPT_fsanitize_EQ)) { 1329 SanitizerMask AddKinds = 1330 expandSanitizerGroups(parseArgValues(D, Arg, false)); 1331 if (AddKinds & Mask) 1332 return describeSanitizeArg(Arg, Mask); 1333 } else if (Arg->getOption().matches(options::OPT_fno_sanitize_EQ)) { 1334 SanitizerMask RemoveKinds = 1335 expandSanitizerGroups(parseArgValues(D, Arg, false)); 1336 Mask &= ~RemoveKinds; 1337 } 1338 } 1339 llvm_unreachable("arg list didn't provide expected value"); 1340 } 1341 1342 std::string describeSanitizeArg(const llvm::opt::Arg *A, SanitizerMask Mask) { 1343 assert(A->getOption().matches(options::OPT_fsanitize_EQ) && 1344 "Invalid argument in describeSanitizerArg!"); 1345 1346 std::string Sanitizers; 1347 for (int i = 0, n = A->getNumValues(); i != n; ++i) { 1348 if (expandSanitizerGroups( 1349 parseSanitizerValue(A->getValue(i), /*AllowGroups=*/true)) & 1350 Mask) { 1351 if (!Sanitizers.empty()) 1352 Sanitizers += ","; 1353 Sanitizers += A->getValue(i); 1354 } 1355 } 1356 1357 assert(!Sanitizers.empty() && "arg didn't provide expected value"); 1358 return "-fsanitize=" + Sanitizers; 1359 } 1360