| /* |
| * Copyright (C) 2011-2019 Apple Inc. All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions |
| * are met: |
| * 1. Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * 2. Redistributions in binary form must reproduce the above copyright |
| * notice, this list of conditions and the following disclaimer in the |
| * documentation and/or other materials provided with the distribution. |
| * |
| * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY |
| * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
| * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR |
| * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, |
| * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
| * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
| * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY |
| * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| #include "config.h" |
| #include "Options.h" |
| |
| #include "AssemblerCommon.h" |
| #include "CPU.h" |
| #include "LLIntCommon.h" |
| #include "MinimumReservedZoneSize.h" |
| #include "SigillCrashAnalyzer.h" |
| #include <algorithm> |
| #include <limits> |
| #include <math.h> |
| #include <mutex> |
| #include <stdlib.h> |
| #include <string.h> |
| #include <wtf/ASCIICType.h> |
| #include <wtf/Compiler.h> |
| #include <wtf/DataLog.h> |
| #include <wtf/NumberOfCores.h> |
| #include <wtf/PointerPreparations.h> |
| #include <wtf/StdLibExtras.h> |
| #include <wtf/text/StringBuilder.h> |
| #include <wtf/threads/Signals.h> |
| |
| #if PLATFORM(COCOA) |
| #include <crt_externs.h> |
| #endif |
| |
| #if ENABLE(JIT) |
| #include "MacroAssembler.h" |
| #endif |
| |
| namespace JSC { |
| |
| static bool parse(const char* string, bool& value) |
| { |
| if (equalLettersIgnoringASCIICase(string, "true") || equalLettersIgnoringASCIICase(string, "yes") || !strcmp(string, "1")) { |
| value = true; |
| return true; |
| } |
| if (equalLettersIgnoringASCIICase(string, "false") || equalLettersIgnoringASCIICase(string, "no") || !strcmp(string, "0")) { |
| value = false; |
| return true; |
| } |
| return false; |
| } |
| |
| static bool parse(const char* string, int32_t& value) |
| { |
| return sscanf(string, "%d", &value) == 1; |
| } |
| |
| static bool parse(const char* string, unsigned& value) |
| { |
| return sscanf(string, "%u", &value) == 1; |
| } |
| |
| static bool UNUSED_FUNCTION parse(const char* string, unsigned long& value) |
| { |
| return sscanf(string, "%lu", &value); |
| } |
| |
| static bool UNUSED_FUNCTION parse(const char* string, unsigned long long& value) |
| { |
| return sscanf(string, "%llu", &value); |
| } |
| |
| static bool parse(const char* string, double& value) |
| { |
| return sscanf(string, "%lf", &value) == 1; |
| } |
| |
| static bool parse(const char* string, OptionRange& value) |
| { |
| return value.init(string); |
| } |
| |
| static bool parse(const char* string, const char*& value) |
| { |
| if (!strlen(string)) { |
| value = nullptr; |
| return true; |
| } |
| |
| // FIXME <https://webkit.org/b/169057>: This could leak if this option is set more than once. |
| // Given that Options are typically used for testing, this isn't considered to be a problem. |
| value = WTF::fastStrDup(string); |
| return true; |
| } |
| |
| static bool parse(const char* string, GCLogging::Level& value) |
| { |
| if (equalLettersIgnoringASCIICase(string, "none") || equalLettersIgnoringASCIICase(string, "no") || equalLettersIgnoringASCIICase(string, "false") || !strcmp(string, "0")) { |
| value = GCLogging::None; |
| return true; |
| } |
| |
| if (equalLettersIgnoringASCIICase(string, "basic") || equalLettersIgnoringASCIICase(string, "yes") || equalLettersIgnoringASCIICase(string, "true") || !strcmp(string, "1")) { |
| value = GCLogging::Basic; |
| return true; |
| } |
| |
| if (equalLettersIgnoringASCIICase(string, "verbose") || !strcmp(string, "2")) { |
| value = GCLogging::Verbose; |
| return true; |
| } |
| |
| return false; |
| } |
| |
| bool Options::isAvailable(Options::ID id, Options::Availability availability) |
| { |
| if (availability == Availability::Restricted) |
| return g_jscConfig.restrictedOptionsEnabled; |
| ASSERT(availability == Availability::Configurable); |
| |
| UNUSED_PARAM(id); |
| #if !defined(NDEBUG) |
| if (id == maxSingleAllocationSizeID) |
| return true; |
| #endif |
| #if OS(DARWIN) |
| if (id == useSigillCrashAnalyzerID) |
| return true; |
| #endif |
| #if ENABLE(ASSEMBLER) && OS(LINUX) |
| if (id == logJITCodeForPerfID) |
| return true; |
| #endif |
| if (id == traceLLIntExecutionID) |
| return !!LLINT_TRACING; |
| if (id == traceLLIntSlowPathID) |
| return !!LLINT_TRACING; |
| return false; |
| } |
| |
| template<typename T> |
| bool overrideOptionWithHeuristic(T& variable, Options::ID id, const char* name, Options::Availability availability) |
| { |
| bool available = (availability == Options::Availability::Normal) |
| || Options::isAvailable(id, availability); |
| |
| const char* stringValue = getenv(name); |
| if (!stringValue) |
| return false; |
| |
| if (available && parse(stringValue, variable)) |
| return true; |
| |
| fprintf(stderr, "WARNING: failed to parse %s=%s\n", name, stringValue); |
| return false; |
| } |
| |
| bool Options::overrideAliasedOptionWithHeuristic(const char* name) |
| { |
| const char* stringValue = getenv(name); |
| if (!stringValue) |
| return false; |
| |
| String aliasedOption; |
| aliasedOption = String(&name[4]) + "=" + stringValue; |
| if (Options::setOption(aliasedOption.utf8().data())) |
| return true; |
| |
| fprintf(stderr, "WARNING: failed to parse %s=%s\n", name, stringValue); |
| return false; |
| } |
| |
| static unsigned computeNumberOfWorkerThreads(int maxNumberOfWorkerThreads, int minimum = 1) |
| { |
| int cpusToUse = std::min(kernTCSMAwareNumberOfProcessorCores(), maxNumberOfWorkerThreads); |
| |
| // Be paranoid, it is the OS we're dealing with, after all. |
| ASSERT(cpusToUse >= 1); |
| return std::max(cpusToUse, minimum); |
| } |
| |
| static int32_t computePriorityDeltaOfWorkerThreads(int32_t twoCorePriorityDelta, int32_t multiCorePriorityDelta) |
| { |
| if (kernTCSMAwareNumberOfProcessorCores() <= 2) |
| return twoCorePriorityDelta; |
| |
| return multiCorePriorityDelta; |
| } |
| |
| static bool jitEnabledByDefault() |
| { |
| return is32Bit() || isAddress64Bit(); |
| } |
| |
| static unsigned computeNumberOfGCMarkers(unsigned maxNumberOfGCMarkers) |
| { |
| return computeNumberOfWorkerThreads(maxNumberOfGCMarkers); |
| } |
| |
| const char* const OptionRange::s_nullRangeStr = "<null>"; |
| |
| bool OptionRange::init(const char* rangeString) |
| { |
| // rangeString should be in the form of [!]<low>[:<high>] |
| // where low and high are unsigned |
| |
| bool invert = false; |
| |
| if (!rangeString) { |
| m_state = InitError; |
| return false; |
| } |
| |
| if (!strcmp(rangeString, s_nullRangeStr)) { |
| m_state = Uninitialized; |
| return true; |
| } |
| |
| const char* p = rangeString; |
| |
| if (*p == '!') { |
| invert = true; |
| p++; |
| } |
| |
| int scanResult = sscanf(p, " %u:%u", &m_lowLimit, &m_highLimit); |
| |
| if (!scanResult || scanResult == EOF) { |
| m_state = InitError; |
| return false; |
| } |
| |
| if (scanResult == 1) |
| m_highLimit = m_lowLimit; |
| |
| if (m_lowLimit > m_highLimit) { |
| m_state = InitError; |
| return false; |
| } |
| |
| // FIXME <https://webkit.org/b/169057>: This could leak if this particular option is set more than once. |
| // Given that these options are used for testing, this isn't considered to be problem. |
| m_rangeString = WTF::fastStrDup(rangeString); |
| m_state = invert ? Inverted : Normal; |
| |
| return true; |
| } |
| |
| bool OptionRange::isInRange(unsigned count) |
| { |
| if (m_state < Normal) |
| return true; |
| |
| if ((m_lowLimit <= count) && (count <= m_highLimit)) |
| return m_state == Normal ? true : false; |
| |
| return m_state == Normal ? false : true; |
| } |
| |
| void OptionRange::dump(PrintStream& out) const |
| { |
| out.print(m_rangeString); |
| } |
| |
| // Realize the names for each of the options: |
| const Options::EntryInfo Options::s_optionsInfo[Options::numberOfOptions] = { |
| #define FILL_OPTION_INFO(type_, name_, defaultValue_, availability_, description_) \ |
| { #name_, description_, Options::Type::type_, Availability::availability_ }, |
| FOR_EACH_JSC_OPTION(FILL_OPTION_INFO) |
| #undef FILL_OPTION_INFO |
| }; |
| |
| static void scaleJITPolicy() |
| { |
| auto& scaleFactor = Options::jitPolicyScale(); |
| if (scaleFactor > 1.0) |
| scaleFactor = 1.0; |
| else if (scaleFactor < 0.0) |
| scaleFactor = 0.0; |
| |
| struct OptionToScale { |
| Options::ID id; |
| int32_t minVal; |
| }; |
| |
| static const OptionToScale optionsToScale[] = { |
| { Options::thresholdForJITAfterWarmUpID, 0 }, |
| { Options::thresholdForJITSoonID, 0 }, |
| { Options::thresholdForOptimizeAfterWarmUpID, 1 }, |
| { Options::thresholdForOptimizeAfterLongWarmUpID, 1 }, |
| { Options::thresholdForOptimizeSoonID, 1 }, |
| { Options::thresholdForFTLOptimizeSoonID, 2 }, |
| { Options::thresholdForFTLOptimizeAfterWarmUpID, 2 } |
| }; |
| |
| const int numberOfOptionsToScale = sizeof(optionsToScale) / sizeof(OptionToScale); |
| for (int i = 0; i < numberOfOptionsToScale; i++) { |
| Option option(optionsToScale[i].id); |
| ASSERT(option.type() == Options::Type::Int32); |
| option.int32Val() *= scaleFactor; |
| option.int32Val() = std::max(option.int32Val(), optionsToScale[i].minVal); |
| } |
| } |
| |
| static void overrideDefaults() |
| { |
| #if !PLATFORM(IOS_FAMILY) |
| if (WTF::numberOfProcessorCores() < 4) |
| #endif |
| { |
| Options::maximumMutatorUtilization() = 0.6; |
| Options::concurrentGCMaxHeadroom() = 1.4; |
| Options::minimumGCPauseMS() = 1; |
| Options::useStochasticMutatorScheduler() = false; |
| if (WTF::numberOfProcessorCores() <= 1) |
| Options::gcIncrementScale() = 1; |
| else |
| Options::gcIncrementScale() = 0; |
| } |
| |
| #if PLATFORM(IOS_FAMILY) |
| // On iOS, we control heap growth using process memory footprint. Therefore these values can be agressive. |
| Options::smallHeapRAMFraction() = 0.8; |
| Options::mediumHeapRAMFraction() = 0.9; |
| |
| #if !PLATFORM(WATCHOS) && defined(__LP64__) |
| Options::useSigillCrashAnalyzer() = true; |
| #endif |
| #endif |
| |
| #if !ENABLE(SIGNAL_BASED_VM_TRAPS) |
| Options::usePollingTraps() = true; |
| #endif |
| |
| #if !ENABLE(WEBASSEMBLY_FAST_MEMORY) |
| Options::useWebAssemblyFastMemory() = false; |
| #endif |
| |
| #if !HAVE(MACH_EXCEPTIONS) |
| Options::useMachForExceptions() = false; |
| #endif |
| } |
| |
| static void correctOptions() |
| { |
| unsigned thresholdForGlobalLexicalBindingEpoch = Options::thresholdForGlobalLexicalBindingEpoch(); |
| if (thresholdForGlobalLexicalBindingEpoch == 0 || thresholdForGlobalLexicalBindingEpoch == 1) |
| Options::thresholdForGlobalLexicalBindingEpoch() = UINT_MAX; |
| } |
| |
| static void recomputeDependentOptions() |
| { |
| #if !defined(NDEBUG) |
| Options::validateDFGExceptionHandling() = true; |
| #endif |
| #if !ENABLE(JIT) |
| Options::useLLInt() = true; |
| Options::useJIT() = false; |
| Options::useBaselineJIT() = false; |
| Options::useDFGJIT() = false; |
| Options::useFTLJIT() = false; |
| Options::useDOMJIT() = false; |
| Options::useRegExpJIT() = false; |
| #endif |
| #if !ENABLE(CONCURRENT_JS) |
| Options::useConcurrentJIT() = false; |
| #endif |
| #if !ENABLE(YARR_JIT) |
| Options::useRegExpJIT() = false; |
| #endif |
| #if !ENABLE(DFG_JIT) |
| Options::useDFGJIT() = false; |
| Options::useFTLJIT() = false; |
| #endif |
| #if !ENABLE(FTL_JIT) |
| Options::useFTLJIT() = false; |
| #endif |
| |
| #if !CPU(X86_64) && !CPU(ARM64) |
| Options::useConcurrentGC() = false; |
| #endif |
| |
| if (!Options::useJIT()) { |
| Options::useSigillCrashAnalyzer() = false; |
| Options::useWebAssembly() = false; |
| } |
| |
| if (!jitEnabledByDefault() && !Options::useJIT()) |
| Options::useLLInt() = true; |
| |
| if (!Options::useWebAssembly()) |
| Options::useFastTLSForWasmContext() = false; |
| |
| if (Options::dumpDisassembly() |
| || Options::dumpDFGDisassembly() |
| || Options::dumpFTLDisassembly() |
| || Options::dumpBytecodeAtDFGTime() |
| || Options::dumpGraphAtEachPhase() |
| || Options::dumpDFGGraphAtEachPhase() |
| || Options::dumpDFGFTLGraphAtEachPhase() |
| || Options::dumpB3GraphAtEachPhase() |
| || Options::dumpAirGraphAtEachPhase() |
| || Options::verboseCompilation() |
| || Options::verboseFTLCompilation() |
| || Options::logCompilationChanges() |
| || Options::validateGraph() |
| || Options::validateGraphAtEachPhase() |
| || Options::verboseOSR() |
| || Options::verboseCompilationQueue() |
| || Options::reportCompileTimes() |
| || Options::reportBaselineCompileTimes() |
| || Options::reportDFGCompileTimes() |
| || Options::reportFTLCompileTimes() |
| || Options::logPhaseTimes() |
| || Options::verboseCFA() |
| || Options::verboseDFGFailure() |
| || Options::verboseFTLFailure() |
| || Options::dumpRandomizingFuzzerAgentPredictions()) |
| Options::alwaysComputeHash() = true; |
| |
| if (!Options::useConcurrentGC()) |
| Options::collectContinuously() = false; |
| |
| if (Option(Options::jitPolicyScaleID).isOverridden()) |
| scaleJITPolicy(); |
| |
| if (Options::forceEagerCompilation()) { |
| Options::thresholdForJITAfterWarmUp() = 10; |
| Options::thresholdForJITSoon() = 10; |
| Options::thresholdForOptimizeAfterWarmUp() = 20; |
| Options::thresholdForOptimizeAfterLongWarmUp() = 20; |
| Options::thresholdForOptimizeSoon() = 20; |
| Options::thresholdForFTLOptimizeAfterWarmUp() = 20; |
| Options::thresholdForFTLOptimizeSoon() = 20; |
| Options::maximumEvalCacheableSourceLength() = 150000; |
| Options::useConcurrentJIT() = false; |
| } |
| #if ENABLE(SEPARATED_WX_HEAP) |
| // Override globally for now. Longer term we'll just make the default |
| // be to have this option enabled, and have platforms that don't support |
| // it just silently use a single mapping. |
| Options::useSeparatedWXHeap() = true; |
| #else |
| Options::useSeparatedWXHeap() = false; |
| #endif |
| |
| if (Options::alwaysUseShadowChicken()) |
| Options::maximumInliningDepth() = 1; |
| |
| // Compute the maximum value of the reoptimization retry counter. This is simply |
| // the largest value at which we don't overflow the execute counter, when using it |
| // to left-shift the execution counter by this amount. Currently the value ends |
| // up being 18, so this loop is not so terrible; it probably takes up ~100 cycles |
| // total on a 32-bit processor. |
| Options::reoptimizationRetryCounterMax() = 0; |
| while ((static_cast<int64_t>(Options::thresholdForOptimizeAfterLongWarmUp()) << (Options::reoptimizationRetryCounterMax() + 1)) <= static_cast<int64_t>(std::numeric_limits<int32_t>::max())) |
| Options::reoptimizationRetryCounterMax()++; |
| |
| ASSERT((static_cast<int64_t>(Options::thresholdForOptimizeAfterLongWarmUp()) << Options::reoptimizationRetryCounterMax()) > 0); |
| ASSERT((static_cast<int64_t>(Options::thresholdForOptimizeAfterLongWarmUp()) << Options::reoptimizationRetryCounterMax()) <= static_cast<int64_t>(std::numeric_limits<int32_t>::max())); |
| |
| #if !defined(NDEBUG) |
| if (Options::maxSingleAllocationSize()) |
| fastSetMaxSingleAllocationSize(Options::maxSingleAllocationSize()); |
| else |
| fastSetMaxSingleAllocationSize(std::numeric_limits<size_t>::max()); |
| #endif |
| |
| if (Options::useZombieMode()) { |
| Options::sweepSynchronously() = true; |
| Options::scribbleFreeCells() = true; |
| } |
| |
| if (Options::reservedZoneSize() < minimumReservedZoneSize) |
| Options::reservedZoneSize() = minimumReservedZoneSize; |
| if (Options::softReservedZoneSize() < Options::reservedZoneSize() + minimumReservedZoneSize) |
| Options::softReservedZoneSize() = Options::reservedZoneSize() + minimumReservedZoneSize; |
| |
| #if USE(JSVALUE32_64) |
| // FIXME: Make probe OSR exit work on 32-bit: |
| // https://bugs.webkit.org/show_bug.cgi?id=177956 |
| Options::useProbeOSRExit() = false; |
| #endif |
| |
| if (!Options::useCodeCache()) |
| Options::diskCachePath() = nullptr; |
| |
| if (Options::randomIntegrityAuditRate() < 0) |
| Options::randomIntegrityAuditRate() = 0; |
| else if (Options::randomIntegrityAuditRate() > 1.0) |
| Options::randomIntegrityAuditRate() = 1.0; |
| } |
| |
| void Options::initialize() |
| { |
| static std::once_flag initializeOptionsOnceFlag; |
| |
| std::call_once( |
| initializeOptionsOnceFlag, |
| [] { |
| #ifndef NDEBUG |
| Config::enableRestrictedOptions(); |
| #endif |
| // Initialize each of the options with their default values: |
| #define INIT_OPTION(type_, name_, defaultValue_, availability_, description_) \ |
| name_() = defaultValue_; \ |
| name_##Default() = defaultValue_; |
| FOR_EACH_JSC_OPTION(INIT_OPTION) |
| #undef INIT_OPTION |
| |
| overrideDefaults(); |
| |
| // Allow environment vars to override options if applicable. |
| // The evn var should be the name of the option prefixed with |
| // "JSC_". |
| #if PLATFORM(COCOA) |
| bool hasBadOptions = false; |
| for (char** envp = *_NSGetEnviron(); *envp; envp++) { |
| const char* env = *envp; |
| if (!strncmp("JSC_", env, 4)) { |
| if (!Options::setOption(&env[4])) { |
| dataLog("ERROR: invalid option: ", *envp, "\n"); |
| hasBadOptions = true; |
| } |
| } |
| } |
| if (hasBadOptions && Options::validateOptions()) |
| CRASH(); |
| #else // PLATFORM(COCOA) |
| #define OVERRIDE_OPTION_WITH_HEURISTICS(type_, name_, defaultValue_, availability_, description_) \ |
| overrideOptionWithHeuristic(name_(), name_##ID, "JSC_" #name_, Availability::availability_); |
| FOR_EACH_JSC_OPTION(OVERRIDE_OPTION_WITH_HEURISTICS) |
| #undef OVERRIDE_OPTION_WITH_HEURISTICS |
| #endif // PLATFORM(COCOA) |
| |
| #define OVERRIDE_ALIASED_OPTION_WITH_HEURISTICS(aliasedName_, unaliasedName_, equivalence_) \ |
| overrideAliasedOptionWithHeuristic("JSC_" #aliasedName_); |
| FOR_EACH_JSC_ALIASED_OPTION(OVERRIDE_ALIASED_OPTION_WITH_HEURISTICS) |
| #undef OVERRIDE_ALIASED_OPTION_WITH_HEURISTICS |
| |
| #if 0 |
| ; // Deconfuse editors that do auto indentation |
| #endif |
| |
| correctOptions(); |
| |
| recomputeDependentOptions(); |
| |
| // Do range checks where needed and make corrections to the options: |
| ASSERT(Options::thresholdForOptimizeAfterLongWarmUp() >= Options::thresholdForOptimizeAfterWarmUp()); |
| ASSERT(Options::thresholdForOptimizeAfterWarmUp() >= Options::thresholdForOptimizeSoon()); |
| ASSERT(Options::thresholdForOptimizeAfterWarmUp() >= 0); |
| ASSERT(Options::criticalGCMemoryThreshold() > 0.0 && Options::criticalGCMemoryThreshold() < 1.0); |
| |
| dumpOptionsIfNeeded(); |
| ensureOptionsAreCoherent(); |
| |
| #if HAVE(MACH_EXCEPTIONS) |
| if (Options::useMachForExceptions()) |
| handleSignalsWithMach(); |
| #endif |
| |
| #if ASAN_ENABLED && OS(LINUX) && ENABLE(WEBASSEMBLY_FAST_MEMORY) |
| if (Options::useWebAssemblyFastMemory()) { |
| const char* asanOptions = getenv("ASAN_OPTIONS"); |
| bool okToUseWebAssemblyFastMemory = asanOptions |
| && (strstr(asanOptions, "allow_user_segv_handler=1") || strstr(asanOptions, "handle_segv=0")); |
| if (!okToUseWebAssemblyFastMemory) { |
| dataLogLn("WARNING: ASAN interferes with JSC signal handlers; useWebAssemblyFastMemory will be disabled."); |
| Options::useWebAssemblyFastMemory() = false; |
| } |
| } |
| #endif |
| |
| #if CPU(X86_64) && OS(DARWIN) |
| Options::dumpZappedCellCrashData() = |
| (hwPhysicalCPUMax() >= 4) && (hwL3CacheSize() >= static_cast<int64_t>(6 * MB)); |
| #endif |
| }); |
| } |
| |
| void Options::dumpOptionsIfNeeded() |
| { |
| if (Options::dumpOptions()) { |
| DumpLevel level = static_cast<DumpLevel>(Options::dumpOptions()); |
| if (level > DumpLevel::Verbose) |
| level = DumpLevel::Verbose; |
| |
| const char* title = nullptr; |
| switch (level) { |
| case DumpLevel::None: |
| break; |
| case DumpLevel::Overridden: |
| title = "Overridden JSC options:"; |
| break; |
| case DumpLevel::All: |
| title = "All JSC options:"; |
| break; |
| case DumpLevel::Verbose: |
| title = "All JSC options with descriptions:"; |
| break; |
| } |
| |
| StringBuilder builder; |
| dumpAllOptions(builder, level, title, nullptr, " ", "\n", DumpDefaults); |
| dataLog(builder.toString()); |
| } |
| } |
| |
| static bool isSeparator(char c) |
| { |
| return isASCIISpace(c) || (c == ','); |
| } |
| |
| bool Options::setOptions(const char* optionsStr) |
| { |
| RELEASE_ASSERT(!g_jscConfig.isPermanentlyFrozen); |
| Vector<char*> options; |
| |
| size_t length = strlen(optionsStr); |
| char* optionsStrCopy = WTF::fastStrDup(optionsStr); |
| char* end = optionsStrCopy + length; |
| char* p = optionsStrCopy; |
| |
| while (p < end) { |
| // Skip separators (white space or commas). |
| while (p < end && isSeparator(*p)) |
| p++; |
| if (p == end) |
| break; |
| |
| char* optionStart = p; |
| p = strstr(p, "="); |
| if (!p) { |
| dataLogF("'=' not found in option string: %p\n", optionStart); |
| WTF::fastFree(optionsStrCopy); |
| return false; |
| } |
| p++; |
| |
| char* valueBegin = p; |
| bool hasStringValue = false; |
| const int minStringLength = 2; // The min is an empty string i.e. 2 double quotes. |
| if ((p + minStringLength < end) && (*p == '"')) { |
| p = strstr(p + 1, "\""); |
| if (!p) { |
| dataLogF("Missing trailing '\"' in option string: %p\n", optionStart); |
| WTF::fastFree(optionsStrCopy); |
| return false; // End of string not found. |
| } |
| hasStringValue = true; |
| } |
| |
| // Find next separator (white space or commas). |
| while (p < end && !isSeparator(*p)) |
| p++; |
| if (!p) |
| p = end; // No more " " separator. Hence, this is the last arg. |
| |
| // If we have a well-formed string value, strip the quotes. |
| if (hasStringValue) { |
| char* valueEnd = p; |
| ASSERT((*valueBegin == '"') && ((valueEnd - valueBegin) >= minStringLength) && (valueEnd[-1] == '"')); |
| memmove(valueBegin, valueBegin + 1, valueEnd - valueBegin - minStringLength); |
| valueEnd[-minStringLength] = '\0'; |
| } |
| |
| // Strip leading -- if present. |
| if ((p - optionStart > 2) && optionStart[0] == '-' && optionStart[1] == '-') |
| optionStart += 2; |
| |
| *p++ = '\0'; |
| options.append(optionStart); |
| } |
| |
| bool success = true; |
| for (auto& option : options) { |
| bool optionSuccess = setOption(option); |
| if (!optionSuccess) { |
| dataLogF("Failed to set option : %s\n", option); |
| success = false; |
| } |
| } |
| |
| correctOptions(); |
| |
| recomputeDependentOptions(); |
| |
| dumpOptionsIfNeeded(); |
| |
| ensureOptionsAreCoherent(); |
| |
| WTF::fastFree(optionsStrCopy); |
| |
| return success; |
| } |
| |
| // Parses a single command line option in the format "<optionName>=<value>" |
| // (no spaces allowed) and set the specified option if appropriate. |
| bool Options::setOptionWithoutAlias(const char* arg) |
| { |
| // arg should look like this: |
| // <jscOptionName>=<appropriate value> |
| const char* equalStr = strchr(arg, '='); |
| if (!equalStr) |
| return false; |
| |
| const char* valueStr = equalStr + 1; |
| |
| // For each option, check if the specify arg is a match. If so, set the arg |
| // if the value makes sense. Otherwise, move on to checking the next option. |
| #define SET_OPTION_IF_MATCH(type_, name_, defaultValue_, availability_, description_) \ |
| if (strlen(#name_) == static_cast<size_t>(equalStr - arg) \ |
| && !strncmp(arg, #name_, equalStr - arg)) { \ |
| if (Availability::availability_ != Availability::Normal \ |
| && !isAvailable(name_##ID, Availability::availability_)) \ |
| return false; \ |
| OptionEntry::type_ value; \ |
| value = (defaultValue_); \ |
| bool success = parse(valueStr, value); \ |
| if (success) { \ |
| name_() = value; \ |
| correctOptions(); \ |
| recomputeDependentOptions(); \ |
| return true; \ |
| } \ |
| return false; \ |
| } |
| |
| FOR_EACH_JSC_OPTION(SET_OPTION_IF_MATCH) |
| #undef SET_OPTION_IF_MATCH |
| |
| return false; // No option matched. |
| } |
| |
| static bool invertBoolOptionValue(const char* valueStr, const char*& invertedValueStr) |
| { |
| bool boolValue; |
| if (!parse(valueStr, boolValue)) |
| return false; |
| invertedValueStr = boolValue ? "false" : "true"; |
| return true; |
| } |
| |
| |
| bool Options::setAliasedOption(const char* arg) |
| { |
| // arg should look like this: |
| // <jscOptionName>=<appropriate value> |
| const char* equalStr = strchr(arg, '='); |
| if (!equalStr) |
| return false; |
| |
| IGNORE_WARNINGS_BEGIN("tautological-compare") |
| |
| // For each option, check if the specify arg is a match. If so, set the arg |
| // if the value makes sense. Otherwise, move on to checking the next option. |
| #define FOR_EACH_OPTION(aliasedName_, unaliasedName_, equivalence) \ |
| if (strlen(#aliasedName_) == static_cast<size_t>(equalStr - arg) \ |
| && !strncmp(arg, #aliasedName_, equalStr - arg)) { \ |
| String unaliasedOption(#unaliasedName_); \ |
| if (equivalence == SameOption) \ |
| unaliasedOption = unaliasedOption + equalStr; \ |
| else { \ |
| ASSERT(equivalence == InvertedOption); \ |
| const char* invertedValueStr = nullptr; \ |
| if (!invertBoolOptionValue(equalStr + 1, invertedValueStr)) \ |
| return false; \ |
| unaliasedOption = unaliasedOption + "=" + invertedValueStr; \ |
| } \ |
| return setOptionWithoutAlias(unaliasedOption.utf8().data()); \ |
| } |
| |
| FOR_EACH_JSC_ALIASED_OPTION(FOR_EACH_OPTION) |
| #undef FOR_EACH_OPTION |
| |
| IGNORE_WARNINGS_END |
| |
| return false; // No option matched. |
| } |
| |
| bool Options::setOption(const char* arg) |
| { |
| bool success = setOptionWithoutAlias(arg); |
| if (success) |
| return true; |
| return setAliasedOption(arg); |
| } |
| |
| |
| void Options::dumpAllOptions(StringBuilder& builder, DumpLevel level, const char* title, |
| const char* separator, const char* optionHeader, const char* optionFooter, DumpDefaultsOption dumpDefaultsOption) |
| { |
| if (title) { |
| builder.append(title); |
| builder.append('\n'); |
| } |
| |
| for (int id = 0; id < numberOfOptions; id++) { |
| if (separator && id) |
| builder.append(separator); |
| dumpOption(builder, level, static_cast<ID>(id), optionHeader, optionFooter, dumpDefaultsOption); |
| } |
| } |
| |
| void Options::dumpAllOptionsInALine(StringBuilder& builder) |
| { |
| dumpAllOptions(builder, DumpLevel::All, nullptr, " ", nullptr, nullptr, DontDumpDefaults); |
| } |
| |
| void Options::dumpAllOptions(FILE* stream, DumpLevel level, const char* title) |
| { |
| StringBuilder builder; |
| dumpAllOptions(builder, level, title, nullptr, " ", "\n", DumpDefaults); |
| fprintf(stream, "%s", builder.toString().utf8().data()); |
| } |
| |
| void Options::dumpOption(StringBuilder& builder, DumpLevel level, Options::ID id, |
| const char* header, const char* footer, DumpDefaultsOption dumpDefaultsOption) |
| { |
| if (id >= numberOfOptions) |
| return; // Illegal option. |
| |
| Option option(id); |
| Availability availability = option.availability(); |
| if (availability != Availability::Normal && !isAvailable(id, availability)) |
| return; |
| |
| bool wasOverridden = option.isOverridden(); |
| bool needsDescription = (level == DumpLevel::Verbose && option.description()); |
| |
| if (level == DumpLevel::Overridden && !wasOverridden) |
| return; |
| |
| if (header) |
| builder.append(header); |
| builder.append(option.name(), '='); |
| option.dump(builder); |
| |
| if (wasOverridden && (dumpDefaultsOption == DumpDefaults)) { |
| builder.appendLiteral(" (default: "); |
| option.defaultOption().dump(builder); |
| builder.appendLiteral(")"); |
| } |
| |
| if (needsDescription) |
| builder.append(" ... ", option.description()); |
| |
| builder.append(footer); |
| } |
| |
| void Options::ensureOptionsAreCoherent() |
| { |
| bool coherent = true; |
| if (!(useLLInt() || useJIT())) { |
| coherent = false; |
| dataLog("INCOHERENT OPTIONS: at least one of useLLInt or useJIT must be true\n"); |
| } |
| if (!coherent) |
| CRASH(); |
| } |
| |
| void Option::dump(StringBuilder& builder) const |
| { |
| switch (type()) { |
| case Options::Type::Bool: |
| builder.append(m_entry.valBool ? "true" : "false"); |
| break; |
| case Options::Type::Unsigned: |
| builder.appendNumber(m_entry.valUnsigned); |
| break; |
| case Options::Type::Size: |
| builder.appendNumber(m_entry.valSize); |
| break; |
| case Options::Type::Double: |
| builder.appendFixedPrecisionNumber(m_entry.valDouble); |
| break; |
| case Options::Type::Int32: |
| builder.appendNumber(m_entry.valInt32); |
| break; |
| case Options::Type::OptionRange: |
| builder.append(m_entry.valOptionRange.rangeString()); |
| break; |
| case Options::Type::OptionString: { |
| const char* option = m_entry.valOptionString; |
| if (!option) |
| option = ""; |
| builder.append('"'); |
| builder.append(option); |
| builder.append('"'); |
| break; |
| } |
| case Options::Type::GCLogLevel: { |
| builder.append(GCLogging::levelAsString(m_entry.valGCLogLevel)); |
| break; |
| } |
| } |
| } |
| |
| bool Option::operator==(const Option& other) const |
| { |
| switch (type()) { |
| case Options::Type::Bool: |
| return m_entry.valBool == other.m_entry.valBool; |
| case Options::Type::Unsigned: |
| return m_entry.valUnsigned == other.m_entry.valUnsigned; |
| case Options::Type::Size: |
| return m_entry.valSize == other.m_entry.valSize; |
| case Options::Type::Double: |
| return (m_entry.valDouble == other.m_entry.valDouble) || (std::isnan(m_entry.valDouble) && std::isnan(other.m_entry.valDouble)); |
| case Options::Type::Int32: |
| return m_entry.valInt32 == other.m_entry.valInt32; |
| case Options::Type::OptionRange: |
| return m_entry.valOptionRange.rangeString() == other.m_entry.valOptionRange.rangeString(); |
| case Options::Type::OptionString: |
| return (m_entry.valOptionString == other.m_entry.valOptionString) |
| || (m_entry.valOptionString && other.m_entry.valOptionString && !strcmp(m_entry.valOptionString, other.m_entry.valOptionString)); |
| case Options::Type::GCLogLevel: |
| return m_entry.valGCLogLevel == other.m_entry.valGCLogLevel; |
| } |
| return false; |
| } |
| |
| } // namespace JSC |
