Home | History | Annotate | Download | only in Core 
      1 //===-- AnalyzerOptions.cpp - Analysis Engine Options -----------*- C++ -*-===//
      2 //
      3 //                     The LLVM Compiler Infrastructure
      4 //
      5 // This file is distributed under the University of Illinois Open Source
      6 // License. See LICENSE.TXT for details.
      7 //
      8 //===----------------------------------------------------------------------===//
      9 //
     10 // This file contains special accessors for analyzer configuration options
     11 // with string representations.
     12 //
     13 //===----------------------------------------------------------------------===//
     14 
     15 #include "clang/StaticAnalyzer/Core/AnalyzerOptions.h"
     16 #include "llvm/ADT/SmallString.h"
     17 #include "llvm/ADT/StringSwitch.h"
     18 #include "llvm/Support/ErrorHandling.h"
     19 #include "llvm/Support/raw_ostream.h"
     20 
     21 using namespace clang;
     22 using namespace llvm;
     23 
     24 AnalyzerOptions::UserModeKind AnalyzerOptions::getUserMode() {
     25   if (UserMode == UMK_NotSet) {
     26     StringRef ModeStr(Config.GetOrCreateValue("mode", "deep").getValue());
     27     UserMode = llvm::StringSwitch<UserModeKind>(ModeStr)
     28       .Case("shallow", UMK_Shallow)
     29       .Case("deep", UMK_Deep)
     30       .Default(UMK_NotSet);
     31     assert(UserMode != UMK_NotSet && "User mode is invalid.");
     32   }
     33   return UserMode;
     34 }
     35 
     36 IPAKind AnalyzerOptions::getIPAMode() {
     37   if (IPAMode == IPAK_NotSet) {
     38 
     39     // Use the User Mode to set the default IPA value.
     40     // Note, we have to add the string to the Config map for the ConfigDumper
     41     // checker to function properly.
     42     const char *DefaultIPA = 0;
     43     UserModeKind HighLevelMode = getUserMode();
     44     if (HighLevelMode == UMK_Shallow)
     45       DefaultIPA = "inlining";
     46     else if (HighLevelMode == UMK_Deep)
     47       DefaultIPA = "dynamic-bifurcate";
     48     assert(DefaultIPA);
     49 
     50     // Lookup the ipa configuration option, use the default from User Mode.
     51     StringRef ModeStr(Config.GetOrCreateValue("ipa", DefaultIPA).getValue());
     52     IPAKind IPAConfig = llvm::StringSwitch<IPAKind>(ModeStr)
     53             .Case("none", IPAK_None)
     54             .Case("basic-inlining", IPAK_BasicInlining)
     55             .Case("inlining", IPAK_Inlining)
     56             .Case("dynamic", IPAK_DynamicDispatch)
     57             .Case("dynamic-bifurcate", IPAK_DynamicDispatchBifurcate)
     58             .Default(IPAK_NotSet);
     59     assert(IPAConfig != IPAK_NotSet && "IPA Mode is invalid.");
     60 
     61     // Set the member variable.
     62     IPAMode = IPAConfig;
     63   }
     64 
     65   return IPAMode;
     66 }
     67 
     68 bool
     69 AnalyzerOptions::mayInlineCXXMemberFunction(CXXInlineableMemberKind K) {
     70   if (getIPAMode() < IPAK_Inlining)
     71     return false;
     72 
     73   if (!CXXMemberInliningMode) {
     74     static const char *ModeKey = "c++-inlining";
     75 
     76     StringRef ModeStr(Config.GetOrCreateValue(ModeKey,
     77                                               "destructors").getValue());
     78 
     79     CXXInlineableMemberKind &MutableMode =
     80       const_cast<CXXInlineableMemberKind &>(CXXMemberInliningMode);
     81 
     82     MutableMode = llvm::StringSwitch<CXXInlineableMemberKind>(ModeStr)
     83       .Case("constructors", CIMK_Constructors)
     84       .Case("destructors", CIMK_Destructors)
     85       .Case("none", CIMK_None)
     86       .Case("methods", CIMK_MemberFunctions)
     87       .Default(CXXInlineableMemberKind());
     88 
     89     if (!MutableMode) {
     90       // FIXME: We should emit a warning here about an unknown inlining kind,
     91       // but the AnalyzerOptions doesn't have access to a diagnostic engine.
     92       MutableMode = CIMK_None;
     93     }
     94   }
     95 
     96   return CXXMemberInliningMode >= K;
     97 }
     98 
     99 static StringRef toString(bool b) { return b ? "true" : "false"; }
    100 
    101 bool AnalyzerOptions::getBooleanOption(StringRef Name, bool DefaultVal) {
    102   // FIXME: We should emit a warning here if the value is something other than
    103   // "true", "false", or the empty string (meaning the default value),
    104   // but the AnalyzerOptions doesn't have access to a diagnostic engine.
    105   StringRef V(Config.GetOrCreateValue(Name, toString(DefaultVal)).getValue());
    106   return llvm::StringSwitch<bool>(V)
    107       .Case("true", true)
    108       .Case("false", false)
    109       .Default(DefaultVal);
    110 }
    111 
    112 bool AnalyzerOptions::getBooleanOption(Optional<bool> &V, StringRef Name,
    113                                        bool DefaultVal) {
    114   if (!V.hasValue())
    115     V = getBooleanOption(Name, DefaultVal);
    116   return V.getValue();
    117 }
    118 
    119 bool AnalyzerOptions::includeTemporaryDtorsInCFG() {
    120   return getBooleanOption(IncludeTemporaryDtorsInCFG,
    121                           "cfg-temporary-dtors",
    122                           /* Default = */ false);
    123 }
    124 
    125 bool AnalyzerOptions::mayInlineCXXStandardLibrary() {
    126   return getBooleanOption(InlineCXXStandardLibrary,
    127                           "c++-stdlib-inlining",
    128                           /*Default=*/true);
    129 }
    130 
    131 bool AnalyzerOptions::mayInlineTemplateFunctions() {
    132   return getBooleanOption(InlineTemplateFunctions,
    133                           "c++-template-inlining",
    134                           /*Default=*/true);
    135 }
    136 
    137 bool AnalyzerOptions::mayInlineCXXContainerCtorsAndDtors() {
    138   return getBooleanOption(InlineCXXContainerCtorsAndDtors,
    139                           "c++-container-inlining",
    140                           /*Default=*/false);
    141 }
    142 
    143 bool AnalyzerOptions::mayInlineCXXSharedPtrDtor() {
    144   return getBooleanOption(InlineCXXSharedPtrDtor,
    145                           "c++-shared_ptr-inlining",
    146                           /*Default=*/false);
    147 }
    148 
    149 
    150 bool AnalyzerOptions::mayInlineObjCMethod() {
    151   return getBooleanOption(ObjCInliningMode,
    152                           "objc-inlining",
    153                           /* Default = */ true);
    154 }
    155 
    156 bool AnalyzerOptions::shouldSuppressNullReturnPaths() {
    157   return getBooleanOption(SuppressNullReturnPaths,
    158                           "suppress-null-return-paths",
    159                           /* Default = */ true);
    160 }
    161 
    162 bool AnalyzerOptions::shouldAvoidSuppressingNullArgumentPaths() {
    163   return getBooleanOption(AvoidSuppressingNullArgumentPaths,
    164                           "avoid-suppressing-null-argument-paths",
    165                           /* Default = */ false);
    166 }
    167 
    168 bool AnalyzerOptions::shouldSuppressInlinedDefensiveChecks() {
    169   return getBooleanOption(SuppressInlinedDefensiveChecks,
    170                           "suppress-inlined-defensive-checks",
    171                           /* Default = */ true);
    172 }
    173 
    174 bool AnalyzerOptions::shouldSuppressFromCXXStandardLibrary() {
    175   return getBooleanOption(SuppressFromCXXStandardLibrary,
    176                           "suppress-c++-stdlib",
    177                           /* Default = */ false);
    178 }
    179 
    180 bool AnalyzerOptions::shouldReportIssuesInMainSourceFile() {
    181   return getBooleanOption(ReportIssuesInMainSourceFile,
    182                           "report-in-main-source-file",
    183                           /* Default = */ false);
    184 }
    185 
    186 int AnalyzerOptions::getOptionAsInteger(StringRef Name, int DefaultVal) {
    187   SmallString<10> StrBuf;
    188   llvm::raw_svector_ostream OS(StrBuf);
    189   OS << DefaultVal;
    190 
    191   StringRef V(Config.GetOrCreateValue(Name, OS.str()).getValue());
    192   int Res = DefaultVal;
    193   bool b = V.getAsInteger(10, Res);
    194   assert(!b && "analyzer-config option should be numeric");
    195   (void) b;
    196   return Res;
    197 }
    198 
    199 unsigned AnalyzerOptions::getAlwaysInlineSize() {
    200   if (!AlwaysInlineSize.hasValue())
    201     AlwaysInlineSize = getOptionAsInteger("ipa-always-inline-size", 3);
    202   return AlwaysInlineSize.getValue();
    203 }
    204 
    205 unsigned AnalyzerOptions::getMaxInlinableSize() {
    206   if (!MaxInlinableSize.hasValue()) {
    207 
    208     int DefaultValue = 0;
    209     UserModeKind HighLevelMode = getUserMode();
    210     switch (HighLevelMode) {
    211       default:
    212         llvm_unreachable("Invalid mode.");
    213       case UMK_Shallow:
    214         DefaultValue = 4;
    215         break;
    216       case UMK_Deep:
    217         DefaultValue = 50;
    218         break;
    219     }
    220 
    221     MaxInlinableSize = getOptionAsInteger("max-inlinable-size", DefaultValue);
    222   }
    223   return MaxInlinableSize.getValue();
    224 }
    225 
    226 unsigned AnalyzerOptions::getGraphTrimInterval() {
    227   if (!GraphTrimInterval.hasValue())
    228     GraphTrimInterval = getOptionAsInteger("graph-trim-interval", 1000);
    229   return GraphTrimInterval.getValue();
    230 }
    231 
    232 unsigned AnalyzerOptions::getMaxTimesInlineLarge() {
    233   if (!MaxTimesInlineLarge.hasValue())
    234     MaxTimesInlineLarge = getOptionAsInteger("max-times-inline-large", 32);
    235   return MaxTimesInlineLarge.getValue();
    236 }
    237 
    238 unsigned AnalyzerOptions::getMaxNodesPerTopLevelFunction() {
    239   if (!MaxNodesPerTopLevelFunction.hasValue()) {
    240     int DefaultValue = 0;
    241     UserModeKind HighLevelMode = getUserMode();
    242     switch (HighLevelMode) {
    243       default:
    244         llvm_unreachable("Invalid mode.");
    245       case UMK_Shallow:
    246         DefaultValue = 75000;
    247         break;
    248       case UMK_Deep:
    249         DefaultValue = 150000;
    250         break;
    251     }
    252     MaxNodesPerTopLevelFunction = getOptionAsInteger("max-nodes", DefaultValue);
    253   }
    254   return MaxNodesPerTopLevelFunction.getValue();
    255 }
    256 
    257 bool AnalyzerOptions::shouldSynthesizeBodies() {
    258   return getBooleanOption("faux-bodies", true);
    259 }
    260 
    261 bool AnalyzerOptions::shouldPrunePaths() {
    262   return getBooleanOption("prune-paths", true);
    263 }
    264 
    265 bool AnalyzerOptions::shouldConditionalizeStaticInitializers() {
    266   return getBooleanOption("cfg-conditional-static-initializers", true);
    267 }
    268 
    269