1 | // Licensed to the .NET Foundation under one or more agreements. |
2 | // The .NET Foundation licenses this file to you under the MIT license. |
3 | // See the LICENSE file in the project root for more information. |
4 | //***************************************************************************** |
5 | // CLRConfigValues.h |
6 | // |
7 | |
8 | // |
9 | // Unified method of accessing configuration values from environment variables, |
10 | // registry and config file. |
11 | // |
12 | //***************************************************************************** |
13 | |
14 | // IMPORTANT: Before adding a new config value, please read up on naming conventions (see |
15 | // code:#NamingConventions) |
16 | // |
17 | // ========== |
18 | // CONTENTS |
19 | // ========== |
20 | // * How to define config values (see code:#Define) |
21 | // * How to access config values (see code:#Access) |
22 | // * Naming conventions (see code:#NamingConventions) |
23 | // |
24 | // |
25 | // ===================================== |
26 | // #Define - Use one of the following macros to define config values. (See code:#DWORDs and code:#Strings) |
27 | // ===================================== |
28 | // |
29 | // By default, all macros are DEBUG ONLY. Add the "RETAIL_" prefix to make the config value available in retail builds. |
30 | // |
31 | // #DWORDs: |
32 | // -------------------------------------------------------------------------- |
33 | // CONFIG_DWORD_INFO(symbol, name, defaultValue, description) |
34 | // -------------------------------------------------------------------------- |
35 | // Use this macro to define a basic DWORD value. CLRConfig will look in environment variables (adding |
36 | // COMPlus_ to the name), the registry (HKLM and HKCU), and all the config files for this value. To customize |
37 | // where CLRConfig looks, use the extended version of the macro below. IMPORTANT: please follow the |
38 | // code:#NamingConventions for the symbol and the name! |
39 | // |
40 | // Example: CONFIG_DWORD_INFO(INTERNAL_AllowCrossModuleInlining, W("AllowCrossModuleInlining"), 0, "") |
41 | // |
42 | // -------------------------------------------------------------------------- |
43 | // CONFIG_DWORD_INFO_EX(symbol, name, defaultValue, description, lookupOptions) |
44 | // -------------------------------------------------------------------------- |
45 | // To customize where CLRConfig looks to get a DWORD, use the extended (_EX) version of the macro. For a list |
46 | // of options and their descriptions, see code:CLRConfig.LookupOptions |
47 | // |
48 | // Example: CONFIG_DWORD_INFO_EX(INTERNAL_EnableInternetHREFexes, W("EnableInternetHREFexes"), 0, "", |
49 | // (CLRConfig::LookupOptions) (CLRConfig::IgnoreEnv | CLRConfig::IgnoreHKCU)) |
50 | // |
51 | // #Strings: |
52 | // -------------------------------------------------------------------------- |
53 | // CONFIG_STRING_INFO(symbol, name, description) |
54 | // -------------------------------------------------------------------------- |
55 | // Defines a string value. Same rules apply as DWORDs. |
56 | // |
57 | // -------------------------------------------------------------------------- |
58 | // CONFIG_STRING_INFO_EX(symbol, name, description, lookupOptions) |
59 | // -------------------------------------------------------------------------- |
60 | // Extended version of the String macro. Again, similar to the DWORD extended macro. |
61 | // |
62 | // |
63 | // =============================================================== |
64 | // #Access - Use the following overloaded method to access config values. |
65 | // =============================================================== |
66 | // From anywhere, use CLRConfig::GetConfigValue(CLRConfig::<symbol>) to access any value defined in this |
67 | // file. |
68 | // |
69 | // |
70 | // =============================================================== |
71 | // #NamingConventions |
72 | // =============================================================== |
73 | // ---------------- |
74 | // #Symbol - used to access values from the source. (using CLRConfig::<symbol>) |
75 | // ---------------- |
76 | // The symbol for each config value is named as such: |
77 | // ### <Class>_<feature area>_<name> ### |
78 | // |
79 | // <Class> indicates which of the following buckets the value is in: |
80 | // * INTERNAL ? this value is for internal (CLR team) use only |
81 | // * UNSUPPORTED ? this value is available to partners/developers, but is not officially supported |
82 | // * EXTERNAL ? this value is available for anyone to use and is publicly documented |
83 | // |
84 | // Examples: |
85 | // * INTERNAL_Security_FullAccessChecks |
86 | // * UNSUPPORTED_Security_DisableTransparency |
87 | // * EXTERNAL_Security_LegacyHMACMode |
88 | // |
89 | // ---------------- |
90 | // #Name - the name of the registry value or environment variable that CLRConfig looks up. |
91 | // ---------------- |
92 | // The name of each value is the same as the symbol, with one exception. Names of external values do NOT |
93 | // contain the EXTERNAL prefix. |
94 | // |
95 | // For compatibility reasons, current names do not follow the convention. |
96 | // |
97 | // Examples: |
98 | // * W("INTERNAL_Security_FullAccessChecks") |
99 | // * W("UNSUPPORTED_Security_DisableTransparency") |
100 | // * W("Security_LegacyHMACMode") <---------------------- (No EXTERNAL prefix) |
101 | |
102 | /// |
103 | /// AppDomain |
104 | /// |
105 | CONFIG_DWORD_INFO(INTERNAL_ADBreakOnCannotUnload, W("ADBreakOnCannotUnload" ), 0, "Used to troubleshoot failures to unload appdomain (e.g. someone sitting in unmanged code). In some cases by the time we throw the appropriate exception the thread has moved from the offending call. This setting allows in an instrumented build to stop exactly at the right moment." ) |
106 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_AddRejitNops, W("AddRejitNops" ), "Control for the profiler rejit feature infrastructure" ) |
107 | CONFIG_DWORD_INFO(INTERNAL_ADDumpSB, W("ADDumpSB" ), 0, "Not used" ) |
108 | CONFIG_DWORD_INFO(INTERNAL_ADForceSB, W("ADForceSB" ), 0, "Forces sync block creation for all objects" ) |
109 | CONFIG_DWORD_INFO(INTERNAL_ADLogMemory, W("ADLogMemory" ), 0, "Superseded by test hooks" ) |
110 | CONFIG_DWORD_INFO(INTERNAL_ADTakeDHSnapShot, W("ADTakeDHSnapShot" ), 0, "Superseded by test hooks" ) |
111 | CONFIG_DWORD_INFO(INTERNAL_ADTakeSnapShot, W("ADTakeSnapShot" ), 0, "Superseded by test hooks" ) |
112 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_EnableFullDebug, W("EnableFullDebug" ), "Heavy-weight checking for AD boundary violations (AD leaks)" ) |
113 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_ADULazyMemoryRelease, W("ADULazyMemoryRelease" ), 1, "On by default. Turned off in cases when people try to catch memory leaks, in which case AD unload should be immediately followed by GC)" ) |
114 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_ADURetryCount, W("ADURetryCount" ), "Controls timeout of AD unload. Used for workarounds when machine is too slow, there are network issues etc." ) |
115 | |
116 | // For the proposal and discussion on why finalizers are not run on shutdown by default anymore in CoreCLR, see the API review: |
117 | // https://github.com/dotnet/corefx/issues/5205 |
118 | #define DEFAULT_FinalizeOnShutdown (0) |
119 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_FinalizeOnShutdown, W("FinalizeOnShutdown" ), DEFAULT_FinalizeOnShutdown, "When enabled, on shutdown, blocks all user threads and calls finalizers for all finalizable objects, including live objects" ) |
120 | |
121 | /// |
122 | /// ARM |
123 | /// |
124 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_ARMEnabled, W("ARMEnabled" ), (DWORD)0, "AppDomain Resource Monitoring. Set to 1 to enable it" ) |
125 | |
126 | /// |
127 | /// Jit Pitching |
128 | /// |
129 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_JitPitchEnabled, W("JitPitchEnabled" ), (DWORD)0, "Set it to 1 to enable Jit Pitching" ) |
130 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_JitPitchMemThreshold, W("JitPitchMemThreshold" ), (DWORD)0, "Do Jit Pitching when code heap usage is larger than this (in bytes)" ) |
131 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_JitPitchMethodSizeThreshold, W("JitPitchMethodSizeThreshold" ), (DWORD)0, "Do Jit Pitching for methods whose native code size larger than this (in bytes)" ) |
132 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_JitPitchTimeInterval, W("JitPitchTimeInterval" ), (DWORD)0, "Time interval between Jit Pitchings in ms" ) |
133 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_JitPitchPrintStat, W("JitPitchPrintStat" ), (DWORD)0, "Print statistics about Jit Pitching" ) |
134 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_JitPitchMinVal, W("JitPitchMinVal" ), (DWORD)0, "Do Jit Pitching if the value of the inner counter greater than this value (for debugging purpose only)" ) |
135 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_JitPitchMaxVal, W("JitPitchMaxVal" ), (DWORD)0xffffffff, "Do Jit Pitching the value of the inner counter less then this value (for debuggin purpose only)" ) |
136 | |
137 | /// |
138 | /// Assembly Loader |
139 | /// |
140 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_DesignerNamespaceResolutionEnabled, W("designerNamespaceResolution" ), FALSE, "Set it to 1 to enable DesignerNamespaceResolve event for WinRT types" , CLRConfig::IgnoreEnv | CLRConfig::IgnoreHKLM | CLRConfig::IgnoreHKCU | CLRConfig::FavorConfigFile) |
141 | CONFIG_DWORD_INFO_EX(INTERNAL_GetAssemblyIfLoadedIgnoreRidMap, W("GetAssemblyIfLoadedIgnoreRidMap" ), 0, "Used to force loader to ignore assemblies cached in the rid-map" , CLRConfig::REGUTIL_default) |
142 | |
143 | /// |
144 | /// Conditional breakpoints |
145 | /// |
146 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_BreakOnBadExit, W("BreakOnBadExit" ), 0, "" , CLRConfig::REGUTIL_default) |
147 | CONFIG_STRING_INFO(INTERNAL_BreakOnClassBuild, W("BreakOnClassBuild" ), "Very useful for debugging class layout code." ) |
148 | CONFIG_STRING_INFO(INTERNAL_BreakOnClassLoad, W("BreakOnClassLoad" ), "Very useful for debugging class loading code." ) |
149 | CONFIG_STRING_INFO(INTERNAL_BreakOnComToClrNativeInfoInit, W("BreakOnComToClrNativeInfoInit" ), "Throws an assert when native information about a COM -> CLR call are about to be gathered." ) |
150 | CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnDebugBreak, W("BreakOnDebugBreak" ), 0, "Allows an assert in debug builds when a user break is hit" , CLRConfig::REGUTIL_default) |
151 | CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnDILoad, W("BreakOnDILoad" ), 0, "Allows an assert when the DI is loaded" , CLRConfig::REGUTIL_default) |
152 | CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnDumpToken, W("BreakOnDumpToken" ), 0xffffffff, "Breaks when using internal logging on a particular token value." , CLRConfig::REGUTIL_default) |
153 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_BreakOnEELoad, W("BreakOnEELoad" ), 0, "" , CLRConfig::REGUTIL_default) |
154 | CONFIG_DWORD_INFO(INTERNAL_BreakOnEEShutdown, W("BreakOnEEShutdown" ), 0, "" ) |
155 | CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnExceptionInGetThrowable, W("BreakOnExceptionInGetThrowable" ), 0, "" , CLRConfig::REGUTIL_default) |
156 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_BreakOnFinalizeTimeOut, W("BreakOnFinalizeTimeOut" ), 0, "Triggers a debug break on the finalizer thread when it has exceeded the maximum wait time" ) |
157 | CONFIG_DWORD_INFO(INTERNAL_BreakOnFindMethod, W("BreakOnFindMethod" ), 0, "Breaks in findMethodInternal when it searches for the specified token." ) |
158 | CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnFirstPass, W("BreakOnFirstPass" ), 0, "" , CLRConfig::REGUTIL_default) |
159 | CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnHR, W("BreakOnHR" ), 0, "Debug.cpp, IfFailxxx use this macro to stop if hr matches " , CLRConfig::REGUTIL_default) |
160 | CONFIG_STRING_INFO(INTERNAL_BreakOnInstantiation, W("BreakOnInstantiation" ), "Very useful for debugging generic class instantiation." ) |
161 | CONFIG_STRING_INFO(INTERNAL_BreakOnInteropStubSetup, W("BreakOnInteropStubSetup" ), "Throws an assert when marshaling stub for the given method is about to be built." ) |
162 | CONFIG_STRING_INFO_EX(INTERNAL_BreakOnInteropVTableBuild, W("BreakOnInteropVTableBuild" ), "Specifies a type name for which an assert should be thrown when building interop v-table." , CLRConfig::REGUTIL_default) |
163 | CONFIG_STRING_INFO(INTERNAL_BreakOnMethodName, W("BreakOnMethodName" ), "Very useful for debugging method override placement code." ) |
164 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_BreakOnNGenRegistryAccessCount, W("BreakOnNGenRegistryAccessCount" ), 0, "Breaks on the Nth' root store write" , CLRConfig::REGUTIL_default) |
165 | CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnNotify, W("BreakOnNotify" ), 0, "" , CLRConfig::REGUTIL_default) |
166 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnRetailAssert, W("BreakOnRetailAssert" ), 0, "Used for debugging \"retail\" asserts (fatal errors)" , CLRConfig::REGUTIL_default) |
167 | CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnSecondPass, W("BreakOnSecondPass" ), 0, "" , CLRConfig::REGUTIL_default) |
168 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_BreakOnSO, W("BreakOnSO" ), 0, "" , CLRConfig::REGUTIL_default) |
169 | CONFIG_STRING_INFO(INTERNAL_BreakOnStructMarshalSetup, W("BreakOnStructMarshalSetup" ), "Throws an assert when field marshalers for the given type with layout are about to be created." ) |
170 | CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnUEF, W("BreakOnUEF" ), 0, "" , CLRConfig::REGUTIL_default) |
171 | CONFIG_DWORD_INFO_EX(INTERNAL_BreakOnUncaughtException, W("BreakOnUncaughtException" ), 0, "" , CLRConfig::REGUTIL_default) |
172 | |
173 | /// |
174 | |
175 | /// Debugger |
176 | /// |
177 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_EnableDiagnostics, W("EnableDiagnostics" ), 1, "Allows the debugger and profiler diagnostics to be disabled" , CLRConfig::REGUTIL_default) |
178 | CONFIG_DWORD_INFO_EX(INTERNAL_D__FCE, W("D::FCE" ), 0, "Allows an assert when crawling the managed stack for an exception handler" , CLRConfig::REGUTIL_default) |
179 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgBreakIfLocksUnavailable, W("DbgBreakIfLocksUnavailable" ), 0, "Allows an assert when the debugger can't take a lock " , CLRConfig::REGUTIL_default) |
180 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgBreakOnErr, W("DbgBreakOnErr" ), 0, "Allows an assert when we get a failing hresult" , CLRConfig::REGUTIL_default) |
181 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgBreakOnMapPatchToDJI, W("DbgBreakOnMapPatchToDJI" ), 0, "Allows an assert when mapping a patch to an address" , CLRConfig::REGUTIL_default) |
182 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgBreakOnRawInt3, W("DbgBreakOnRawInt3" ), 0, "Allows an assert for test coverage for debug break or other int3 breaks" , CLRConfig::REGUTIL_default) |
183 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgBreakOnSendBreakpoint, W("DbgBreakOnSendBreakpoint" ), 0, "Allows an assert when sending a breakpoint to the right side" , CLRConfig::REGUTIL_default) |
184 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgBreakOnSetIP, W("DbgBreakOnSetIP" ), 0, "Allows an assert when setting the IP" , CLRConfig::REGUTIL_default) |
185 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgCheckInt3, W("DbgCheckInt3" ), 0, "Asserts if the debugger explicitly writes int3 instead of calling SetUnmanagedBreakpoint" , CLRConfig::REGUTIL_default) |
186 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_DbgDACAssertOnMismatch, W("DbgDACAssertOnMismatch" ), "Allows an assert when the mscordacwks and mscorwks dll versions don't match" ) |
187 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgDACEnableAssert, W("DbgDACEnableAssert" ), 0, "Enables extra validity checking in DAC - assumes target isn't corrupt" , CLRConfig::REGUTIL_default) |
188 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_DbgDACSkipVerifyDlls, W("DbgDACSkipVerifyDlls" ), 0, "Allows disabling the check to ensure mscordacwks and mscorwks dll versions match" , CLRConfig::REGUTIL_default) |
189 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgDelayHelper, W("DbgDelayHelper" ), 0, "Varies the wait in the helper thread startup for testing race between threads" , CLRConfig::REGUTIL_default) |
190 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_DbgDisableDynamicSymsCompat, W("DbgDisableDynamicSymsCompat" ), 0, "" , CLRConfig::REGUTIL_default) |
191 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgDisableTargetConsistencyAsserts, W("DbgDisableTargetConsistencyAsserts" ), 0, "Allows explicitly testing with corrupt targets" , CLRConfig::REGUTIL_default) |
192 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_DbgEnableMixedModeDebugging, W("DbgEnableMixedModeDebuggingInternalOnly" ), 0, "" , CLRConfig::REGUTIL_default) |
193 | CONFIG_DWORD_INFO_EX(, W("DbgExtraThreads" ), 0, "Allows extra unmanaged threads to run and throw debug events for stress testing" , CLRConfig::REGUTIL_default) |
194 | CONFIG_DWORD_INFO_EX(, W("DbgExtraThreadsCantStop" ), 0, "Allows extra unmanaged threads in can't stop region to run and throw debug events for stress testing" , CLRConfig::REGUTIL_default) |
195 | CONFIG_DWORD_INFO_EX(, W("DbgExtraThreadsIB" ), 0, "Allows extra in-band unmanaged threads to run and throw debug events for stress testing" , CLRConfig::REGUTIL_default) |
196 | CONFIG_DWORD_INFO_EX(, W("DbgExtraThreadsOOB" ), 0, "Allows extra out of band unmanaged threads to run and throw debug events for stress testing" , CLRConfig::REGUTIL_default) |
197 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgFaultInHandleIPCEvent, W("DbgFaultInHandleIPCEvent" ), 0, "Allows testing the unhandled event filter" , CLRConfig::REGUTIL_default) |
198 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgInjectFEE, W("DbgInjectFEE" ), 0, "Allows injecting a fatal execution error for testing Watson" , CLRConfig::REGUTIL_default) |
199 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgLeakCheck, W("DbgLeakCheck" ), 0, "Allows checking for leaked Cordb objects" , CLRConfig::REGUTIL_default) |
200 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgNo2ndChance, W("DbgNo2ndChance" ), 0, "Allows breaking on (and catching bogus) 2nd chance exceptions" , CLRConfig::REGUTIL_default) |
201 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgNoDebugger, W("DbgNoDebugger" ), 0, "Allows breaking if we don't want to lazily initialize the debugger" , CLRConfig::REGUTIL_default) |
202 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_DbgNoForceContinue, W("DbgNoForceContinue" ), 1, "Used to force a continue on longhorn" , CLRConfig::REGUTIL_default) |
203 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgNoOpenMDByFile, W("DbgNoOpenMDByFile" ), 0, "Allows opening MD by memory for perf testing" , CLRConfig::REGUTIL_default) |
204 | CONFIG_DWORD_INFO(INTERNAL_DbgOOBinFEEE, W("DbgOOBinFEEE" ), 0, "Allows forcing oob breakpoints when a fatal error occurs" ) |
205 | RETAIL_CONFIG_STRING_INFO_DIRECT_ACCESS(EXTERNAL_DbgPackShimPath, W("DbgPackShimPath" ), "CoreCLR path to dbgshim.dll - we are trying to figure out if we can remove this" ) |
206 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgPingInterop, W("DbgPingInterop" ), 0, "Allows checking for deadlocks in interop debugging" , CLRConfig::REGUTIL_default) |
207 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgRace, W("DbgRace" ), 0, "Allows pausing for native debug events to get hijicked" , CLRConfig::REGUTIL_default) |
208 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_DbgRedirect, W("DbgRedirect" ), 0, "Allows for redirecting the event pipeline" , CLRConfig::REGUTIL_default) |
209 | RETAIL_CONFIG_STRING_INFO_DIRECT_ACCESS(EXTERNAL_DbgRedirectApplication, W("DbgRedirectApplication" ), "Specifies the auxiliary debugger application to launch." ) |
210 | RETAIL_CONFIG_STRING_INFO_DIRECT_ACCESS(EXTERNAL_DbgRedirectAttachCmd, W("DbgRedirectAttachCmd" ), "Specifies command parameters for attaching the auxiliary debugger." ) |
211 | RETAIL_CONFIG_STRING_INFO_DIRECT_ACCESS(EXTERNAL_DbgRedirectCommonCmd, W("DbgRedirectCommonCmd" ), "Specifies a command line format string for the auxiliary debugger." ) |
212 | RETAIL_CONFIG_STRING_INFO_DIRECT_ACCESS(EXTERNAL_DbgRedirectCreateCmd, W("DbgRedirectCreateCmd" ), "Specifies command parameters when creating the auxiliary debugger." ) |
213 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgShortcutCanary, W("DbgShortcutCanary" ), 0, "Allows a way to force canary to fail to be able to test failure paths" , CLRConfig::REGUTIL_default) |
214 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgSkipMEOnStep, W("DbgSkipMEOnStep" ), 0, "Turns off MethodEnter checks" , CLRConfig::REGUTIL_default) |
215 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgSkipVerCheck, W("DbgSkipVerCheck" ), 0, "Allows different RS and LS versions (for servicing work)" , CLRConfig::REGUTIL_default) |
216 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgTC, W("DbgTC" ), 0, "Allows checking boundary compression for offset mappings" , CLRConfig::REGUTIL_default) |
217 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgTransportFaultInject, W("DbgTransportFaultInject" ), 0, "Allows injecting a fault for testing the debug transport" , CLRConfig::REGUTIL_default) |
218 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_DbgTransportLog, W("DbgTransportLog" ), "Turns on logging for the debug transport" ) |
219 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_DbgTransportLogClass, W("DbgTransportLogClass" ), "Mask to control what is logged in DbgTransportLog" ) |
220 | RETAIL_CONFIG_STRING_INFO_EX(UNSUPPORTED_DbgTransportProxyAddress, W("DbgTransportProxyAddress" ), "Allows specifying the transport proxy address" , CLRConfig::REGUTIL_default) |
221 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgTrapOnSkip, W("DbgTrapOnSkip" ), 0, "Allows breaking when we skip a breakpoint" , CLRConfig::REGUTIL_default) |
222 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgWaitTimeout, W("DbgWaitTimeout" ), 1, "Specifies the timeout value for waits" , CLRConfig::REGUTIL_default) |
223 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_DbgWFDETimeout, W("DbgWFDETimeout" ), 25, "Specifies the timeout value for wait when waiting for a debug event" , CLRConfig::REGUTIL_default) |
224 | CONFIG_DWORD_INFO_EX(INTERNAL_RaiseExceptionOnAssert, W("RaiseExceptionOnAssert" ), 0, "Raise a first chance (if set to 1) or second chance (if set to 2) exception on asserts." , CLRConfig::REGUTIL_default) |
225 | CONFIG_DWORD_INFO_EX(INTERNAL_DebugBreakOnAssert, W("DebugBreakOnAssert" ), 0, "If DACCESS_COMPILE is defined, break on asserts." , CLRConfig::REGUTIL_default) |
226 | CONFIG_DWORD_INFO_EX(INTERNAL_DebugBreakOnVerificationFailure, W("DebugBreakOnVerificationFailure" ), 0, "Halts the jit on verification failure" , CLRConfig::REGUTIL_default) |
227 | CONFIG_STRING_INFO_EX(INTERNAL_DebuggerBreakPoint, W("DebuggerBreakPoint" ), "Allows counting various debug events" , CLRConfig::REGUTIL_default) |
228 | CONFIG_STRING_INFO_EX(INTERNAL_DebugVerify, W("DebugVerify" ), "Control for tracing in peverify" , CLRConfig::REGUTIL_default) |
229 | CONFIG_DWORD_INFO(INTERNAL_EncApplyChanges, W("EncApplyChanges" ), 0, "Allows breaking when ApplyEditAndContinue is called" ) |
230 | CONFIG_DWORD_INFO_EX(INTERNAL_EnCBreakOnRemapComplete, W("EnCBreakOnRemapComplete" ), 0, "Allows breaking after N RemapCompletes" , CLRConfig::REGUTIL_default) |
231 | CONFIG_DWORD_INFO_EX(INTERNAL_EnCBreakOnRemapOpportunity, W("EnCBreakOnRemapOpportunity" ), 0, "Allows breaking after N RemapOpportunities" , CLRConfig::REGUTIL_default) |
232 | CONFIG_DWORD_INFO(INTERNAL_EncDumpApplyChanges, W("EncDumpApplyChanges" ), 0, "Allows dumping edits in delta metadata and il files" ) |
233 | CONFIG_DWORD_INFO(INTERNAL_EncFixupFieldBreak, W("EncFixupFieldBreak" ), 0, "Unlikely that this is used anymore." ) |
234 | CONFIG_DWORD_INFO(INTERNAL_EncJitUpdatedFunction, W("EncJitUpdatedFunction" ), 0, "Allows breaking when an updated function is jitted" ) |
235 | CONFIG_DWORD_INFO(INTERNAL_EnCResolveField, W("EnCResolveField" ), 0, "Allows breaking when computing the address of an EnC-added field" ) |
236 | CONFIG_DWORD_INFO(INTERNAL_EncResumeInUpdatedFunction, W("EncResumeInUpdatedFunction" ), 0, "Allows breaking when execution resumes in a new EnC version of a function" ) |
237 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgAssertOnDebuggeeDebugBreak, W("DbgAssertOnDebuggeeDebugBreak" ), 0, "If non-zero causes the managed-only debugger to assert on unhandled breakpoints in the debuggee" , CLRConfig::REGUTIL_default) |
238 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_DbgDontResumeThreadsOnUnhandledException, W("UNSUPPORTED_DbgDontResumeThreadsOnUnhandledException" ), 0, "If non-zero, then don't try to unsuspend threads after continuing a 2nd-chance native exception" ) |
239 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_DbgSkipStackCheck, W("DbgSkipStackCheck" ), 0, "Skip the stack pointer check during stackwalking" , CLRConfig::REGUTIL_default) |
240 | #ifdef DACCESS_COMPILE |
241 | CONFIG_DWORD_INFO(INTERNAL_DumpGeneration_IntentionallyCorruptDataFromTarget, W("IntentionallyCorruptDataFromTarget" ), 0, "Intentionally fakes bad data retrieved from target to try and break dump generation." ) |
242 | #endif |
243 | // Note that Debugging_RequiredVersion is sometimes an 'INTERNAL' knob and sometimes an 'UNSUPPORTED' knob, but we don't change it's name. |
244 | CONFIG_DWORD_INFO(UNSUPPORTED_Debugging_RequiredVersion, W("UNSUPPORTED_Debugging_RequiredVersion" ), 0, "The lowest ICorDebug version we should attempt to emulate, or 0 for default policy. Use 2 for CLRv2, 4 for CLRv4, etc." ) |
245 | |
246 | #ifdef FEATURE_MINIMETADATA_IN_TRIAGEDUMPS |
247 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_MiniMdBufferCapacity, W("MiniMdBufferCapacity" ), 64 * 1024, "The max size of the buffer to store mini metadata information for triage- and mini-dumps." ) |
248 | #endif // FEATURE_MINIMETADATA_IN_TRIAGEDUMPS |
249 | |
250 | CONFIG_DWORD_INFO_EX(INTERNAL_DbgNativeCodeBpBindsAcrossVersions, W("DbgNativeCodeBpBindsAcrossVersions" ), 0, "If non-zero causes native breakpoints at offset 0 to bind in all tiered compilation versions of the given method" , CLRConfig::REGUTIL_default) |
251 | |
252 | /// |
253 | /// Diagnostics (internal general-purpose) |
254 | /// |
255 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_ConditionalContracts, W("ConditionalContracts" ), "If ENABLE_CONTRACTS_IMPL is defined, sets whether contracts are conditional. (?)" ) |
256 | CONFIG_DWORD_INFO(INTERNAL_ConsistencyCheck, W("ConsistencyCheck" ), 0, "" ) |
257 | CONFIG_DWORD_INFO_EX(INTERNAL_ContinueOnAssert, W("ContinueOnAssert" ), 0, "If set, doesn't break on asserts." , CLRConfig::REGUTIL_default) |
258 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_disableStackOverflowProbing, W("disableStackOverflowProbing" ), 0, "" , CLRConfig::FavorConfigFile) |
259 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_InjectFatalError, W("InjectFatalError" ), "" ) |
260 | CONFIG_DWORD_INFO_EX(INTERNAL_InjectFault, W("InjectFault" ), 0, "" , CLRConfig::REGUTIL_default) |
261 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_SuppressChecks, W("SuppressChecks" ), "" ) |
262 | #ifdef WIN64EXCEPTIONS |
263 | CONFIG_DWORD_INFO(INTERNAL_SuppressLockViolationsOnReentryFromOS, W("SuppressLockViolationsOnReentryFromOS" ), 0, "64 bit OOM tests re-enter the CLR via RtlVirtualUnwind. This indicates whether to suppress resulting locking violations." ) |
264 | #endif // WIN64EXCEPTIONS |
265 | CONFIG_STRING_INFO(INTERNAL_TestHooks, W("TestHooks" ), "Used by tests to get test an insight on various CLR workings" ) |
266 | |
267 | |
268 | /// |
269 | /// Exception Handling |
270 | /// |
271 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_AssertOnFailFast, W("AssertOnFailFast" ), "" ) |
272 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_legacyCorruptedStateExceptionsPolicy, W("legacyCorruptedStateExceptionsPolicy" ), 0, "Enabled Pre-V4 CSE behavior" , CLRConfig::FavorConfigFile) |
273 | CONFIG_DWORD_INFO_EX(INTERNAL_SuppressLostExceptionTypeAssert, W("SuppressLostExceptionTypeAssert" ), 0, "" , CLRConfig::REGUTIL_default) |
274 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_FailFastOnCorruptedStateException, W("FailFastOnCorruptedStateException" ), 0, "Failfast if a CSE is encountered" , CLRConfig::FavorConfigFile) |
275 | |
276 | /// |
277 | /// Garbage collector |
278 | /// |
279 | CONFIG_DWORD_INFO(INTERNAL_FastGCCheckStack, W("FastGCCheckStack" ), 0, "" ) |
280 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_FastGCStress, W("FastGCStress" ), "Reduce the number of GCs done by enabling GCStress" ) |
281 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_GCBreakOnOOM, W("GCBreakOnOOM" ), "Does a DebugBreak at the soonest time we detect an OOM" ) |
282 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_gcConcurrent, W("gcConcurrent" ), (DWORD)-1, "Enables/Disables concurrent GC" ) |
283 | |
284 | #ifdef FEATURE_CONSERVATIVE_GC |
285 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_gcConservative, W("gcConservative" ), 0, "Enables/Disables conservative GC" ) |
286 | #endif |
287 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_gcServer, W("gcServer" ), 0, "Enables server GC" ) |
288 | CONFIG_STRING_INFO(INTERNAL_GcCoverage, W("GcCoverage" ), "Specify a method or regular expression of method names to run with GCStress" ) |
289 | CONFIG_STRING_INFO(INTERNAL_SkipGCCoverage, W("SkipGcCoverage" ), "Specify a list of assembly names to skip with GC Coverage" ) |
290 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_gcForceCompact, W("gcForceCompact" ), "When set to true, always do compacting GC" ) |
291 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_GCgen0size, W("GCgen0size" ), "Specifies the smallest gen0 size" ) |
292 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_GCStressMix, W("GCStressMix" ), 0, "Specifies whether the GC mix mode is enabled or not" ) |
293 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_GCStressStep, W("GCStressStep" ), 1, "Specifies how often StressHeap will actually do a GC in GCStressMix mode" ) |
294 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_GCStressMaxFGCsPerBGC, W("GCStressMaxFGCsPerBGC" ), ~0U, "Specifies how many FGCs will occur during one BGC in GCStressMix mode" ) |
295 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_StatsUpdatePeriod, W("StatsUpdatePeriod" ), 60, "Specifies the interval, in seconds, at which to update the statistics" ) |
296 | RETAIL_CONFIG_STRING_INFO(UNSUPPORTED_SuspendTimeLog, W("SuspendTimeLog" ), "Specifies the name of the log file for suspension statistics" ) |
297 | RETAIL_CONFIG_STRING_INFO(UNSUPPORTED_GCMixLog, W("GCMixLog" ), "Specifies the name of the log file for GC mix statistics" ) |
298 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_GCLatencyMode, W("GCLatencyMode" ), "Specifies the GC latency mode - batch, interactive or low latency (note that the same thing can be specified via API which is the supported way)" ) |
299 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_GCLatencyLevel, W("GCLatencyLevel" ), 1, "Specifies the GC latency level that you want to optimize for" ) |
300 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_GCConfigLogEnabled, W("GCConfigLogEnabled" ), 0, "Specifies if you want to turn on config logging in GC" ) |
301 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_GCLogEnabled, W("GCLogEnabled" ), 0, "Specifies if you want to turn on logging in GC" ) |
302 | RETAIL_CONFIG_STRING_INFO(UNSUPPORTED_GCLogFile, W("GCLogFile" ), "Specifies the name of the GC log file" ) |
303 | RETAIL_CONFIG_STRING_INFO(UNSUPPORTED_GCConfigLogFile, W("GCConfigLogFile" ), "Specifies the name of the GC config log file" ) |
304 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_GCLogFileSize, W("GCLogFileSize" ), 0, "Specifies the GC log file size" ) |
305 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_GCCompactRatio, W("GCCompactRatio" ), 0, "Specifies the ratio compacting GCs vs sweeping " ) |
306 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_GCPollType, W("GCPollType" ), "" ) |
307 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_GCRetainVM, W("GCRetainVM" ), 0, "When set we put the segments that should be deleted on a standby list (instead of releasing them back to the OS) which will be considered to satisfy new segment requests (note that the same thing can be specified via API which is the supported way)" ) |
308 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_GCSegmentSize, W("GCSegmentSize" ), "Specifies the managed heap segment size" ) |
309 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_GCLOHThreshold, W("GCLOHThreshold" ), 0, "Specifies the size that will make objects go on LOH" ) |
310 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_GCLOHCompact, W("GCLOHCompact" ), "Specifies the LOH compaction mode" ) |
311 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_gcAllowVeryLargeObjects, W("gcAllowVeryLargeObjects" ), 1, "Allow allocation of 2GB+ objects on GC heap" ) |
312 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_GCStress, W("GCStress" ), 0, "Trigger GCs at regular intervals" , CLRConfig::REGUTIL_default) |
313 | CONFIG_DWORD_INFO_EX(INTERNAL_GcStressOnDirectCalls, W("GcStressOnDirectCalls" ), 0, "Whether to trigger a GC on direct calls" , CLRConfig::REGUTIL_default) |
314 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_GCStressStart, W("GCStressStart" ), 0, "Start GCStress after N stress GCs have been attempted" ) |
315 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_GCStressStartAtJit, W("GCStressStartAtJit" ), 0, "Start GCStress after N items are jitted" ) |
316 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_gcTrimCommitOnLowMemory, W("gcTrimCommitOnLowMemory" ), "When set we trim the committed space more aggressively for the ephemeral seg. This is used for running many instances of server processes where they want to keep as little memory committed as possible" ) |
317 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_BGCSpinCount, W("BGCSpinCount" ), 140, "Specifies the bgc spin count" ) |
318 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_BGCSpin, W("BGCSpin" ), 2, "Specifies the bgc spin time" ) |
319 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_HeapVerify, W("HeapVerify" ), "When set verifies the integrity of the managed heap on entry and exit of each GC" ) |
320 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_SetupGcCoverage, W("SetupGcCoverage" ), "This doesn't appear to be a config flag" , CLRConfig::REGUTIL_default) |
321 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_GCNumaAware, W("GCNumaAware" ), 1, "Specifies if to enable GC NUMA aware" ) |
322 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_GCCpuGroup, W("GCCpuGroup" ), 0, "Specifies if to enable GC to support CPU groups" ) |
323 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_GCHeapCount, W("GCHeapCount" ), 0, "" ) |
324 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_GCNoAffinitize, W("GCNoAffinitize" ), 0, "" ) |
325 | // this config is only in effect if the process is not running in multiple CPU groups. |
326 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_GCHeapAffinitizeMask, W("GCHeapAffinitizeMask" ), "Specifies processor mask for Server GC threads" ) |
327 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_GCProvModeStress, W("GCProvModeStress" ), 0, "Stress the provisional modes" ) |
328 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_GCHighMemPercent, W("GCHighMemPercent" ), 0, "Specifies the percent for GC to consider as high memory" ) |
329 | RETAIL_CONFIG_STRING_INFO(EXTERNAL_GCName, W("GCName" ), "" ) |
330 | |
331 | /// |
332 | /// IBC |
333 | /// |
334 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_ConvertIbcData, W("ConvertIbcData" ), 1, "Converts between v1 and v2 IBC data" , CLRConfig::REGUTIL_default) |
335 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_DisableHotCold, W("DisableHotCold" ), "Master hot/cold splitting switch in Jit64" ) |
336 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_DisableIBC, W("DisableIBC" ), 0, "Disables the use of IBC data" , CLRConfig::REGUTIL_default) |
337 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_UseIBCFile, W("UseIBCFile" ), 0, "" , CLRConfig::REGUTIL_default) |
338 | |
339 | |
340 | /// |
341 | /// JIT |
342 | /// |
343 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_JitAlignLoops, W("JitAlignLoops" ), "Aligns loop targets to 8 byte boundaries" ) |
344 | CONFIG_DWORD_INFO_EX(INTERNAL_JitBreakEmit, W("JitBreakEmit" ), (DWORD)-1, "" , CLRConfig::REGUTIL_default) |
345 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_JitDebuggable, W("JitDebuggable" ), "" ) |
346 | #if !defined(DEBUG) && !defined(_DEBUG) |
347 | #define INTERNAL_JitEnableNoWayAssert_Default 0 |
348 | #else |
349 | #define INTERNAL_JitEnableNoWayAssert_Default 1 |
350 | #endif |
351 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_JitEnableNoWayAssert, W("JitEnableNoWayAssert" ), INTERNAL_JitEnableNoWayAssert_Default, "" , CLRConfig::REGUTIL_default) |
352 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_JitFramed, W("JitFramed" ), "Forces EBP frames" ) |
353 | CONFIG_DWORD_INFO_EX(INTERNAL_JitGCStress, W("JitGCStress" ), 0, "GC stress mode for jit" , CLRConfig::REGUTIL_default) |
354 | CONFIG_DWORD_INFO(INTERNAL_JitHeartbeat, W("JitHeartbeat" ), 0, "" ) |
355 | CONFIG_DWORD_INFO(INTERNAL_JitHelperLogging, W("JitHelperLogging" ), 0, "" ) |
356 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_JITMinOpts, W("JITMinOpts" ), "Forces MinOpts" ) |
357 | RETAIL_CONFIG_STRING_INFO(EXTERNAL_JitName, W("JitName" ), "Primary Jit to use" ) |
358 | #if defined(ALLOW_SXS_JIT) |
359 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_AltJitName, W("AltJitName" ), "Alternative Jit to use, will fall back to primary jit." , CLRConfig::REGUTIL_default) |
360 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_AltJit, W("AltJit" ), "Enables AltJit and selectively limits it to the specified methods." , CLRConfig::REGUTIL_default) |
361 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_AltJitExcludeAssemblies, W("AltJitExcludeAssemblies" ), "Do not use AltJit on this semicolon-delimited list of assemblies." , CLRConfig::REGUTIL_default) |
362 | #endif // defined(ALLOW_SXS_JIT) |
363 | |
364 | #if defined(FEATURE_STACK_SAMPLING) |
365 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_StackSamplingEnabled, W("StackSamplingEnabled" ), 0, "Is stack sampling based tracking of evolving hot methods enabled." ) |
366 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_StackSamplingAfter, W("StackSamplingAfter" ), 0, "When to start sampling (for some sort of app steady state), i.e., initial delay for sampling start in milliseconds." ) |
367 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_StackSamplingEvery, W("StackSamplingEvery" ), 100, "How frequent should thread stacks be sampled in milliseconds." ) |
368 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_StackSamplingNumMethods, W("StackSamplingNumMethods" ), 32, "Number of evolving methods to track as hot and JIT them in the background at a given point of execution." ) |
369 | #endif // defined(FEATURE_JIT_SAMPLING) |
370 | |
371 | #if defined(ALLOW_SXS_JIT_NGEN) |
372 | RETAIL_CONFIG_STRING_INFO_EX(INTERNAL_AltJitNgen, W("AltJitNgen" ), "Enables AltJit for NGEN and selectively limits it to the specified methods." , CLRConfig::REGUTIL_default) |
373 | #endif // defined(ALLOW_SXS_JIT_NGEN) |
374 | |
375 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_JitOptimizeType, W("JitOptimizeType" ), "" ) |
376 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_JitPrintInlinedMethods, W("JitPrintInlinedMethods" ), 0, "" , CLRConfig::REGUTIL_default) |
377 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_JitTelemetry, W("JitTelemetry" ), 1, "If non-zero, gather JIT telemetry data" ) |
378 | RETAIL_CONFIG_STRING_INFO(INTERNAL_JitTimeLogFile, W("JitTimeLogFile" ), "If set, gather JIT throughput data and write to this file." ) |
379 | RETAIL_CONFIG_STRING_INFO(INTERNAL_JitTimeLogCsv, W("JitTimeLogCsv" ), "If set, gather JIT throughput data and write to a CSV file. This mode must be used in internal retail builds." ) |
380 | RETAIL_CONFIG_STRING_INFO(INTERNAL_JitFuncInfoLogFile, W("JitFuncInfoLogFile" ), "If set, gather JIT function info and write to this file." ) |
381 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_JitVerificationDisable, W("JitVerificationDisable" ), "" ) |
382 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_JitLockWrite, W("JitLockWrite" ), 0, "Force all volatile writes to be 'locked'" ) |
383 | CONFIG_STRING_INFO_EX(INTERNAL_TailCallMax, W("TailCallMax" ), "" , CLRConfig::REGUTIL_default) |
384 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_TailCallOpt, W("TailCallOpt" ), "" , CLRConfig::REGUTIL_default) |
385 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_TailCallLoopOpt, W("TailCallLoopOpt" ), 1, "Convert recursive tail calls to loops" ) |
386 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_Jit_NetFx40PInvokeStackResilience, W("NetFx40_PInvokeStackResilience" ), (DWORD)-1, "Makes P/Invoke resilient against mismatched signature and calling convention (significant perf penalty)." ) |
387 | |
388 | // AltJitAssertOnNYI should be 0 on targets where JIT is under development or bring up stage, so as to facilitate fallback to main JIT on hitting a NYI. |
389 | #if defined(_TARGET_X86_) |
390 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_AltJitAssertOnNYI, W("AltJitAssertOnNYI" ), 0, "Controls the AltJit behavior of NYI stuff" ) |
391 | #else |
392 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_AltJitAssertOnNYI, W("AltJitAssertOnNYI" ), 1, "Controls the AltJit behavior of NYI stuff" ) |
393 | #endif |
394 | CONFIG_DWORD_INFO_EX(INTERNAL_JitLargeBranches, W("JitLargeBranches" ), 0, "Force using the largest conditional branch format" , CLRConfig::REGUTIL_default) |
395 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_JitRegisterFP, W("JitRegisterFP" ), 3, "Control FP enregistration" , CLRConfig::REGUTIL_default) |
396 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_JitELTHookEnabled, W("JitELTHookEnabled" ), 0, "On ARM, setting this will emit Enter/Leave/TailCall callbacks" ) |
397 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_JitMemStats, W("JitMemStats" ), 0, "Display JIT memory usage statistics" , CLRConfig::REGUTIL_default) |
398 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_JitVNMapSelBudget, W("JitVNMapSelBudget" ), 100, "Max # of MapSelect's considered for a particular top-level invocation." ) |
399 | #if defined(_TARGET_AMD64_) || defined(_TARGET_X86_) || defined(_TARGET_ARM64_) |
400 | #define EXTERNAL_FeatureSIMD_Default 1 |
401 | #else // !(defined(_TARGET_AMD64_) || defined(_TARGET_X86_) || defined(_TARGET_ARM64_)) |
402 | #define EXTERNAL_FeatureSIMD_Default 0 |
403 | #endif // !(defined(_TARGET_AMD64_) || defined(_TARGET_X86_) || defined(_TARGET_ARM64_)) |
404 | #if defined(_TARGET_AMD64_) || defined(_TARGET_X86_) |
405 | #define EXTERNAL_JitEnableAVX_Default 1 |
406 | #else // !(defined(_TARGET_AMD64_) || defined(_TARGET_X86_) |
407 | #define EXTERNAL_JitEnableAVX_Default 0 |
408 | #endif // !(defined(_TARGET_AMD64_) || defined(_TARGET_X86_) |
409 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_FeatureSIMD, W("FeatureSIMD" ), EXTERNAL_FeatureSIMD_Default, "Enable SIMD intrinsics recognition in System.Numerics.dll and/or System.Numerics.Vectors.dll" , CLRConfig::REGUTIL_default) |
410 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_SIMD16ByteOnly, W("SIMD16ByteOnly" ), 0, "Limit maximum SIMD vector length to 16 bytes (used by x64_arm64_altjit)" ) |
411 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_EnableAVX, W("EnableAVX" ), EXTERNAL_JitEnableAVX_Default, "Enable AVX instruction set for wide operations as default" , CLRConfig::REGUTIL_default) |
412 | |
413 | #ifdef FEATURE_MULTICOREJIT |
414 | |
415 | RETAIL_CONFIG_STRING_INFO(INTERNAL_MultiCoreJitProfile, W("MultiCoreJitProfile" ), "If set, use the file to store/control multi-core JIT." ) |
416 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_MultiCoreJitProfileWriteDelay, W("MultiCoreJitProfileWriteDelay" ), 12, "Set the delay after which the multi-core JIT profile will be written to disk." ) |
417 | |
418 | #endif |
419 | |
420 | #ifdef FEATURE_INTERPRETER |
421 | /// |
422 | /// Interpreter |
423 | /// |
424 | RETAIL_CONFIG_STRING_INFO_EX(INTERNAL_Interpret, W("Interpret" ), "Selectively uses the interpreter to execute the specified methods" , CLRConfig::REGUTIL_default) |
425 | RETAIL_CONFIG_STRING_INFO_EX(INTERNAL_InterpretExclude, W("InterpretExclude" ), "Excludes the specified methods from the set selected by 'Interpret'" , CLRConfig::REGUTIL_default) |
426 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_InterpreterMethHashMin, W("InterpreterMethHashMin" ), 0, "Only interpret methods selected by 'Interpret' whose hash is at least this value. or after nth" ) |
427 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_InterpreterMethHashMax, W("InterpreterMethHashMax" ), UINT32_MAX, "If non-zero, only interpret methods selected by 'Interpret' whose hash is at most this value" ) |
428 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_InterpreterStubMin, W("InterpreterStubMin" ), 0, "Only interpret methods selected by 'Interpret' whose stub num is at least this value." ) |
429 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_InterpreterStubMax, W("InterpreterStubMax" ), UINT32_MAX, "If non-zero, only interpret methods selected by 'Interpret' whose stub number is at most this value." ) |
430 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_InterpreterJITThreshold, W("InterpreterJITThreshold" ), 10, "The number of times a method should be interpreted before being JITted" ) |
431 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_InterpreterDoLoopMethods, W("InterpreterDoLoopMethods" ), 0, "If set, don't check for loops, start by interpreting *all* methods" ) |
432 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_InterpreterUseCaching, W("InterpreterUseCaching" ), 1, "If non-zero, use the caching mechanism." , CLRConfig::REGUTIL_default) |
433 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_InterpreterLooseRules, W("InterpreterLooseRules" ), 1, "If non-zero, allow ECMA spec violations required by managed C++." , CLRConfig::REGUTIL_default) |
434 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_InterpreterPrintPostMortem, W("InterpreterPrintPostMortem" ), 0, "Prints summary information about the execution to the console" ) |
435 | RETAIL_CONFIG_STRING_INFO_EX(INTERNAL_InterpreterLogFile, W("InterpreterLogFile" ), "If non-null, append interpreter logging to this file, else use stdout" , CLRConfig::REGUTIL_default) |
436 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_DumpInterpreterStubs, W("DumpInterpreterStubs" ), 0, "Prints all interpreter stubs that are created to the console" ) |
437 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_TraceInterpreterEntries, W("TraceInterpreterEntries" ), 0, "Logs entries to interpreted methods to the console" ) |
438 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_TraceInterpreterIL, W("TraceInterpreterIL" ), 0, "Logs individual instructions of interpreted methods to the console" ) |
439 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_TraceInterpreterOstack, W("TraceInterpreterOstack" ), 0, "Logs operand stack after each IL instruction of interpreted methods to the console" ) |
440 | CONFIG_DWORD_INFO(INTERNAL_TraceInterpreterVerbose, W("TraceInterpreterVerbose" ), 0, "Logs interpreter progress with detailed messages to the console" ) |
441 | CONFIG_DWORD_INFO(INTERNAL_TraceInterpreterJITTransition, W("TraceInterpreterJITTransition" ), 0, "Logs when the interpreter determines a method should be JITted" ) |
442 | #endif |
443 | // The JIT queries this ConfigDWORD but it doesn't know if FEATURE_INTERPRETER is enabled |
444 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_InterpreterFallback, W("InterpreterFallback" ), 0, "Fallback to the interpreter when the JIT compiler fails" ) |
445 | |
446 | /// |
447 | /// Loader |
448 | /// |
449 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_APIThreadStress, W("APIThreadStress" ), "Used to test Loader for race conditions" ) |
450 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_ForceLog, W("ForceLog" ), "Fusion flag to enforce assembly binding log. Heavily used and documented in MSDN and BLOGS." ) |
451 | RETAIL_CONFIG_STRING_INFO(INTERNAL_CoreClrBinderLog, W("CoreClrBinderLog" ), "Debug flag that enabled detailed log for new binder (similar to stress logging)." ) |
452 | RETAIL_CONFIG_STRING_INFO(INTERNAL_WinMDPath, W("WinMDPath" ), "Path for Windows WinMD files" ) |
453 | |
454 | /// |
455 | /// Loader heap |
456 | /// |
457 | CONFIG_DWORD_INFO_EX(INTERNAL_LoaderHeapCallTracing, W("LoaderHeapCallTracing" ), 0, "Loader heap troubleshooting" , CLRConfig::REGUTIL_default) |
458 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_CodeHeapReserveForJumpStubs, W("CodeHeapReserveForJumpStubs" ), 1, "Percentage of code heap to reserve for jump stubs" ) |
459 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_NGenReserveForJumpStubs, W("NGenReserveForJumpStubs" ), 0, "Percentage of ngen image size to reserve for jump stubs" ) |
460 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_BreakOnOutOfMemoryWithinRange, W("BreakOnOutOfMemoryWithinRange" ), 0, "Break before out of memory within range exception is thrown" ) |
461 | |
462 | /// |
463 | /// Log |
464 | /// |
465 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogEnable, W("LogEnable" ), "Turns on the traditional CLR log." ) |
466 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogFacility, W("LogFacility" ), "Specifies a facility mask for CLR log. (See 'loglf.h'; VM interprets string value as hex number.) Also used by stresslog." ) |
467 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogFacility2, W("LogFacility2" ), "Specifies a facility mask for CLR log. (See 'loglf.h'; VM interprets string value as hex number.) Also used by stresslog." ) |
468 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_logFatalError, W("logFatalError" ), 1, "Specifies whether EventReporter logs fatal errors in the Windows event log." ) |
469 | CONFIG_STRING_INFO_EX(INTERNAL_LogFile, W("LogFile" ), "Specifies a file name for the CLR log." , CLRConfig::REGUTIL_default) |
470 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogFileAppend, W("LogFileAppend" ), "Specifies whether to append to or replace the CLR log file." ) |
471 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogFlushFile, W("LogFlushFile" ), "Specifies whether to flush the CLR log file on each write." ) |
472 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_LogLevel, W("LogLevel" ), "4=10 msgs, 9=1000000, 10=everything" ) |
473 | RETAIL_CONFIG_STRING_INFO_DIRECT_ACCESS(INTERNAL_LogPath, W("LogPath" ), "?Fusion debug log path." ) |
474 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogToConsole, W("LogToConsole" ), "Writes the CLR log to console." ) |
475 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogToDebugger, W("LogToDebugger" ), "Writes the CLR log to debugger (OutputDebugStringA)." ) |
476 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogToFile, W("LogToFile" ), "Writes the CLR log to a file." ) |
477 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogWithPid, W("LogWithPid" ), "Appends pid to filename for the CLR log." ) |
478 | |
479 | /// |
480 | /// MetaData |
481 | /// |
482 | CONFIG_DWORD_INFO_EX(INTERNAL_MD_ApplyDeltaBreak, W("MD_ApplyDeltaBreak" ), 0, "ASSERT when applying EnC" , CLRConfig::REGUTIL_default) |
483 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_AssertOnBadImageFormat, W("AssertOnBadImageFormat" ), "ASSERT when invalid MD read" ) |
484 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_MD_DeltaCheck, W("MD_DeltaCheck" ), 1, "Some checks of GUID when applying EnC (?)" , CLRConfig::REGUTIL_default) |
485 | CONFIG_DWORD_INFO_EX(INTERNAL_MD_EncDelta, W("MD_EncDelta" ), 0, "Forces EnC Delta format in MD (?)" , CLRConfig::REGUTIL_default) |
486 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_MD_ForceNoColDesSharing, W("MD_ForceNoColDesSharing" ), 0, "Don't know - the only usage I could find is #if 0 (?)" , CLRConfig::REGUTIL_default) |
487 | CONFIG_DWORD_INFO_EX(INTERNAL_MD_KeepKnownCA, W("MD_KeepKnownCA" ), 0, "Something with known CAs (?)" , CLRConfig::REGUTIL_default) |
488 | CONFIG_DWORD_INFO_EX(INTERNAL_MD_MiniMDBreak, W("MD_MiniMDBreak" ), 0, "ASSERT when creating CMiniMdRw class" , CLRConfig::REGUTIL_default) |
489 | CONFIG_DWORD_INFO_EX(INTERNAL_MD_PreSaveBreak, W("MD_PreSaveBreak" ), 0, "ASSERT when calling CMiniMdRw::PreSave" , CLRConfig::REGUTIL_default) |
490 | CONFIG_DWORD_INFO_EX(INTERNAL_MD_RegMetaBreak, W("MD_RegMetaBreak" ), 0, "ASSERT when creating RegMeta class" , CLRConfig::REGUTIL_default) |
491 | CONFIG_DWORD_INFO_EX(INTERNAL_MD_RegMetaDump, W("MD_RegMetaDump" ), 0, "Dump MD in 4 functions (?)" , CLRConfig::REGUTIL_default) |
492 | // MetaData - Desktop-only |
493 | CONFIG_DWORD_INFO_EX(INTERNAL_MD_WinMD_Disable, W("MD_WinMD_Disable" ), 0, "Never activate the WinMD import adapter" , CLRConfig::REGUTIL_default) |
494 | CONFIG_DWORD_INFO_EX(INTERNAL_MD_WinMD_AssertOnIllegalUsage, W("MD_WinMD_AssertOnIllegalUsage" ), 0, "ASSERT if a WinMD import adapter detects a tool incompatibility" , CLRConfig::REGUTIL_default) |
495 | |
496 | // Metadata - mscordbi only - this flag is only intended to mitigate potential issues in bug fix 458597. |
497 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_MD_PreserveDebuggerMetadataMemory, W("MD_PreserveDebuggerMetadataMemory" ), 0, "Save all versions of metadata memory in the debugger when debuggee metadata is updated" , CLRConfig::REGUTIL_default) |
498 | |
499 | /// |
500 | /// Spinning heuristics |
501 | /// |
502 | // Note that these only take effect once the runtime has been started; prior to that the values hardcoded in g_SpinConstants (vars.cpp) are used |
503 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_SpinInitialDuration, W("SpinInitialDuration" ), 0x32, "Hex value specifying the first spin duration" , EEConfig_default) |
504 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_SpinBackoffFactor, W("SpinBackoffFactor" ), 0x3, "Hex value specifying the growth of each successive spin duration" , EEConfig_default) |
505 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_SpinLimitProcCap, W("SpinLimitProcCap" ), 0xFFFFFFFF, "Hex value specifying the largest value of NumProcs to use when calculating the maximum spin duration" , EEConfig_default) |
506 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_SpinLimitProcFactor, W("SpinLimitProcFactor" ), 0x4E20, "Hex value specifying the multiplier on NumProcs to use when calculating the maximum spin duration" , EEConfig_default) |
507 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_SpinLimitConstant, W("SpinLimitConstant" ), 0x0, "Hex value specifying the constant to add when calculating the maximum spin duration" , EEConfig_default) |
508 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_SpinRetryCount, W("SpinRetryCount" ), 0xA, "Hex value specifying the number of times the entire spin process is repeated (when applicable)" , EEConfig_default) |
509 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_Monitor_SpinCount, W("Monitor_SpinCount" ), 0x1e, "Hex value specifying the maximum number of spin iterations Monitor may perform upon contention on acquiring the lock before waiting." , EEConfig_default) |
510 | |
511 | /// |
512 | /// Native Binder |
513 | /// |
514 | |
515 | CONFIG_DWORD_INFO(INTERNAL_NgenBind_ZapForbid, W("NgenBind_ZapForbid" ), 0, "Assert if an assembly succeeds in binding to a native image" ) |
516 | CONFIG_STRING_INFO(INTERNAL_NgenBind_ZapForbidExcludeList, W("NgenBind_ZapForbidExcludeList" ), "" ) |
517 | CONFIG_STRING_INFO(INTERNAL_NgenBind_ZapForbidList, W("NgenBind_ZapForbidList" ), "" ) |
518 | |
519 | CONFIG_DWORD_INFO_EX(INTERNAL_SymDiffDump, W("SymDiffDump" ), 0, "Used to create the map file while binding the assembly. Used by SemanticDiffer" , CLRConfig::REGUTIL_default) |
520 | |
521 | /// |
522 | /// NGEN |
523 | /// |
524 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_NGen_JitName, W("NGen_JitName" ), "" , CLRConfig::REGUTIL_default) |
525 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_NGenFramed, W("NGenFramed" ), -1, "Same as JitFramed, but for ngen" , CLRConfig::REGUTIL_default) |
526 | CONFIG_DWORD_INFO_EX(INTERNAL_NGenOnlyOneMethod, W("NGenOnlyOneMethod" ), 0, "" , CLRConfig::REGUTIL_default) |
527 | CONFIG_DWORD_INFO_EX(INTERNAL_NgenOrder, W("NgenOrder" ), 0, "" , CLRConfig::REGUTIL_default) |
528 | CONFIG_DWORD_INFO_EX(INTERNAL_partialNGenStress, W("partialNGenStress" ), 0, "" , CLRConfig::REGUTIL_default) |
529 | CONFIG_DWORD_INFO_EX(INTERNAL_ZapDoNothing, W("ZapDoNothing" ), 0, "" , CLRConfig::REGUTIL_default) |
530 | CONFIG_DWORD_INFO_EX(INTERNAL_NgenForceFailureMask, W("NgenForceFailureMask" ), -1, "Bitmask used to control which locations will check and raise the failure (defaults to bits: -1)" , CLRConfig::REGUTIL_default) |
531 | CONFIG_DWORD_INFO_EX(INTERNAL_NgenForceFailureCount, W("NgenForceFailureCount" ), 0, "If set to >0 and we have IBC data we will force a failure after we reference an IBC data item <value> times" , CLRConfig::REGUTIL_default) |
532 | CONFIG_DWORD_INFO_EX(INTERNAL_NgenForceFailureKind, W("NgenForceFailureKind" ), 1, "If set to 1, We will throw a TypeLoad exception; If set to 2, We will cause an A/V" , CLRConfig::REGUTIL_default) |
533 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_NGenEnableCreatePdb, W("NGenEnableCreatePdb" ), 0, "If set to >0 ngen.exe displays help on, recognizes createpdb in the command line" ) |
534 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_NGenSimulateDiskFull, W("NGenSimulateDiskFull" ), 0, "If set to 1, ngen will throw a Disk full exception in ZapWriter.cpp:Save()" ) |
535 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_PartialNGen, W("PartialNGen" ), -1, "Generate partial NGen images" ) |
536 | |
537 | CONFIG_DWORD_INFO(INTERNAL_NoASLRForNgen, W("NoASLRForNgen" ), 0, "Turn off IMAGE_DLLCHARACTERISTICS_DYNAMIC_BASE bit in generated ngen images. Makes nidump output repeatable from run to run." ) |
538 | |
539 | #ifdef CROSSGEN_COMPILE |
540 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_CrossGenAssumeInputSigned, W("CrossGenAssumeInputSigned" ), 1, "CrossGen should assume that its input assemblies will be signed before deployment" ) |
541 | #endif |
542 | |
543 | /// |
544 | /// Performance |
545 | /// |
546 | RETAIL_CONFIG_STRING_INFO(EXTERNAL_PerformanceScenario, W("performanceScenario" ), "Activates a set of workload-specific default values for performance settings" ) |
547 | |
548 | /// |
549 | /// Profiling API / ETW |
550 | /// |
551 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_COR_ENABLE_PROFILING, W("COR_ENABLE_PROFILING" ), 0, "Flag to indicate whether profiling should be enabled for the currently running process." , CLRConfig::DontPrependCOMPlus_ | CLRConfig::IgnoreConfigFiles) |
552 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_COR_PROFILER, W("COR_PROFILER" ), "Specifies GUID of profiler to load into currently running process" , CLRConfig::DontPrependCOMPlus_) |
553 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_COR_PROFILER_PATH, W("COR_PROFILER_PATH" ), "Specifies the path to the DLL of profiler to load into currently running process" , CLRConfig::DontPrependCOMPlus_) |
554 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_COR_PROFILER_PATH_32, W("COR_PROFILER_PATH_32" ), "Specifies the path to the DLL of profiler to load into currently running 32 bits process" , CLRConfig::DontPrependCOMPlus_) |
555 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_COR_PROFILER_PATH_64, W("COR_PROFILER_PATH_64" ), "Specifies the path to the DLL of profiler to load into currently running 64 bits process" , CLRConfig::DontPrependCOMPlus_) |
556 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_CORECLR_ENABLE_PROFILING, W("CORECLR_ENABLE_PROFILING" ), 0, "CoreCLR only: Flag to indicate whether profiling should be enabled for the currently running process." , CLRConfig::DontPrependCOMPlus_ | CLRConfig::IgnoreConfigFiles) |
557 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_CORECLR_PROFILER, W("CORECLR_PROFILER" ), "CoreCLR only: Specifies GUID of profiler to load into currently running process" , CLRConfig::DontPrependCOMPlus_) |
558 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_CORECLR_PROFILER_PATH, W("CORECLR_PROFILER_PATH" ), "CoreCLR only: Specifies the path to the DLL of profiler to load into currently running process" , CLRConfig::DontPrependCOMPlus_) |
559 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_CORECLR_PROFILER_PATH_32, W("CORECLR_PROFILER_PATH_32" ), "CoreCLR only: Specifies the path to the DLL of profiler to load into currently running 32 process" , CLRConfig::DontPrependCOMPlus_) |
560 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_CORECLR_PROFILER_PATH_64, W("CORECLR_PROFILER_PATH_64" ), "CoreCLR only: Specifies the path to the DLL of profiler to load into currently running 64 process" , CLRConfig::DontPrependCOMPlus_) |
561 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_ProfAPI_ProfilerCompatibilitySetting, W("ProfAPI_ProfilerCompatibilitySetting" ), "Specifies the profiler loading policy (the default is not to load a V2 profiler in V4)" , CLRConfig::REGUTIL_default | CLRConfig::TrimWhiteSpaceFromStringValue) |
562 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_AttachThreadAlwaysOn, W("AttachThreadAlwaysOn" ), "Forces profapi attach thread to be created on startup, instead of on-demand." ) |
563 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_MsBetweenAttachCheck, W("MsBetweenAttachCheck" ), 500, "" ) |
564 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_ProfAPIMaxWaitForTriggerMs, W("ProfAPIMaxWaitForTriggerMs" ), 5*60*1000, "Timeout in ms for profilee to wait for each blocking operation performed by trigger app." ) |
565 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_ProfAPI_DetachMinSleepMs, W("ProfAPI_DetachMinSleepMs" ), 0, "The minimum time, in milliseconds, the CLR will wait before checking whether a profiler that is in the process of detaching is ready to be unloaded." ) |
566 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_ProfAPI_DetachMaxSleepMs, W("ProfAPI_DetachMaxSleepMs" ), 0, "The maximum time, in milliseconds, the CLR will wait before checking whether a profiler that is in the process of detaching is ready to be unloaded." ) |
567 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_ProfAPI_RejitOnAttach, W("ProfApi_RejitOnAttach" ), 1, "Enables the ability for profilers to rejit methods on attach." ) |
568 | CONFIG_DWORD_INFO(INTERNAL_ProfAPI_EnableRejitDiagnostics, W("ProfAPI_EnableRejitDiagnostics" ), 0, "Enable extra dumping to stdout of rejit structures" ) |
569 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_ProfAPI_AttachProfilerMinTimeoutInMs, W("ProfAPI_AttachProfilerMinTimeoutInMs" ), 10*1000, "Timeout in ms for the minimum time out value of AttachProfiler" ) |
570 | CONFIG_DWORD_INFO(INTERNAL_ProfAPIFault, W("ProfAPIFault" ), 0, "Test-only bitmask to inject various types of faults in the profapi code" ) |
571 | CONFIG_DWORD_INFO(INTERNAL_TestOnlyAllowedEventMask, W("TestOnlyAllowedEventMask" ), 0, "Test-only bitmask to allow profiler tests to override CLR enforcement of COR_PRF_ALLOWABLE_AFTER_ATTACH and COR_PRF_MONITOR_IMMUTABLE" ) |
572 | CONFIG_DWORD_INFO(INTERNAL_TestOnlyEnableICorProfilerInfo, W("ProfAPI_TestOnlyEnableICorProfilerInfo" ), 0, "Test-only flag to allow attaching profiler tests to call ICorProfilerInfo interface, which would otherwise be disallowed for attaching profilers" ) |
573 | CONFIG_DWORD_INFO(INTERNAL_TestOnlyEnableObjectAllocatedHook, W("TestOnlyEnableObjectAllocatedHook" ), 0, "Test-only flag that forces CLR to initialize on startup as if ObjectAllocated callback were requested, to enable post-attach ObjectAllocated functionality." ) |
574 | CONFIG_DWORD_INFO(INTERNAL_TestOnlyEnableSlowELTHooks, W("TestOnlyEnableSlowELTHooks" ), 0, "Test-only flag that forces CLR to initialize on startup as if slow-ELT were requested, to enable post-attach ELT functionality." ) |
575 | |
576 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_PreVistaETWEnabled, W("ETWEnabled" ), 0, "This flag is used on OSes < Vista to enable/disable ETW. It is disabled by default" , CLRConfig::REGUTIL_default) |
577 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_VistaAndAboveETWEnabled, W("ETWEnabled" ), 1, "This flag is used on OSes >= Vista to enable/disable ETW. It is enabled by default" , CLRConfig::REGUTIL_default) |
578 | RETAIL_CONFIG_STRING_INFO_EX(UNSUPPORTED_ETW_ObjectAllocationEventsPerTypePerSec, W("ETW_ObjectAllocationEventsPerTypePerSec" ), "Desired number of GCSampledObjectAllocation ETW events to be logged per type per second. If 0, then the default built in to the implementation for the enabled event (e.g., High, Low), will be used." , CLRConfig::REGUTIL_default) |
579 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_ProfAPI_ValidateNGENInstrumentation, W("ProfAPI_ValidateNGENInstrumentation" ), 0, "This flag enables additional validations when using the IMetaDataEmit APIs for NGEN'ed images to ensure only supported edits are made." ) |
580 | |
581 | #ifdef FEATURE_PERFMAP |
582 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_PerfMapEnabled, W("PerfMapEnabled" ), 0, "This flag is used on Linux to enable writing /tmp/perf-$pid.map. It is disabled by default" , CLRConfig::REGUTIL_default) |
583 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_PerfMapIgnoreSignal, W("PerfMapIgnoreSignal" ), 0, "When perf map is enabled, this option will configure the specified signal to be accepted and ignored as a marker in the perf logs. It is disabled by default" , CLRConfig::REGUTIL_default) |
584 | #endif |
585 | |
586 | RETAIL_CONFIG_STRING_INFO(EXTERNAL_StartupDelayMS, W("StartupDelayMS" ), "" ) |
587 | |
588 | /// |
589 | /// Stress |
590 | /// |
591 | CONFIG_DWORD_INFO_EX(INTERNAL_StressCOMCall, W("StressCOMCall" ), 0, "" , CLRConfig::REGUTIL_default) |
592 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_StressLog, W("StressLog" ), "Turns on the stress log." ) |
593 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_ForceEnc, W("ForceEnc" ), "Forces Edit and Continue to be on for all eligible modules." ) |
594 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_StressLogSize, W("StressLogSize" ), "Stress log size in bytes per thread." ) |
595 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_StressOn, W("StressOn" ), "Enables the STRESS_ASSERT macro that stops runtime quickly (to prevent the clr state from changing significantly before breaking)" ) |
596 | CONFIG_DWORD_INFO_EX(INTERNAL_stressSynchronized, W("stressSynchronized" ), 0, "Unknown if or where this is used; unless a test is specifically depending on this, it can be removed." , CLRConfig::REGUTIL_default) |
597 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_StressThreadCount, W("StressThreadCount" ), "" ) |
598 | |
599 | /// |
600 | /// Thread Suspend |
601 | /// |
602 | CONFIG_DWORD_INFO(INTERNAL_DiagnosticSuspend, W("DiagnosticSuspend" ), 0, "" ) |
603 | CONFIG_DWORD_INFO(INTERNAL_SuspendDeadlockTimeout, W("SuspendDeadlockTimeout" ), 40000, "" ) |
604 | CONFIG_DWORD_INFO(INTERNAL_SuspendThreadDeadlockTimeoutMs, W("SuspendThreadDeadlockTimeoutMs" ), 2000, "" ) |
605 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_ThreadSuspendInjection, W("INTERNAL_ThreadSuspendInjection" ), 1, "Specifies whether to inject activations for thread suspension on Unix" ) |
606 | |
607 | /// |
608 | /// Thread (miscellaneous) |
609 | /// |
610 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_Thread_DeadThreadCountThresholdForGCTrigger, W("Thread_DeadThreadCountThresholdForGCTrigger" ), 75, "In the heuristics to clean up dead threads, this threshold must be reached before triggering a GC will be considered. Set to 0 to disable triggering a GC based on dead threads." ) |
611 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_Thread_DeadThreadGCTriggerPeriodMilliseconds, W("Thread_DeadThreadGCTriggerPeriodMilliseconds" ), 1000 * 60 * 30, "In the heuristics to clean up dead threads, this much time must have elapsed since the previous max-generation GC before triggering another GC will be considered" ) |
612 | |
613 | /// |
614 | /// Threadpool |
615 | /// |
616 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_ThreadPool_ForceMinWorkerThreads, W("ThreadPool_ForceMinWorkerThreads" ), 0, "Overrides the MinThreads setting for the ThreadPool worker pool" ) |
617 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_ThreadPool_ForceMaxWorkerThreads, W("ThreadPool_ForceMaxWorkerThreads" ), 0, "Overrides the MaxThreads setting for the ThreadPool worker pool" ) |
618 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_ThreadPool_DisableStarvationDetection, W("ThreadPool_DisableStarvationDetection" ), 0, "Disables the ThreadPool feature that forces new threads to be added when workitems run for too long" ) |
619 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_ThreadPool_DebugBreakOnWorkerStarvation, W("ThreadPool_DebugBreakOnWorkerStarvation" ), 0, "Breaks into the debugger if the ThreadPool detects work queue starvation" ) |
620 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_ThreadPool_EnableWorkerTracking, W("ThreadPool_EnableWorkerTracking" ), 0, "Enables extra expensive tracking of how many workers threads are working simultaneously" ) |
621 | #ifdef _TARGET_ARM64_ |
622 | // Spinning scheme is currently different on ARM64, see CLRLifoSemaphore::Wait(DWORD, UINT32, UINT32) |
623 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_ThreadPool_UnfairSemaphoreSpinLimit, W("ThreadPool_UnfairSemaphoreSpinLimit" ), 0x32, "Maximum number of spins per processor a thread pool worker thread performs before waiting for work" ) |
624 | #else // !_TARGET_ARM64_ |
625 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_ThreadPool_UnfairSemaphoreSpinLimit, W("ThreadPool_UnfairSemaphoreSpinLimit" ), 0x46, "Maximum number of spins a thread pool worker thread performs before waiting for work" ) |
626 | #endif // _TARGET_ARM64_ |
627 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_Thread_UseAllCpuGroups, W("Thread_UseAllCpuGroups" ), 0, "Specifies if to automatically distribute thread across CPU Groups" ) |
628 | |
629 | CONFIG_DWORD_INFO(INTERNAL_ThreadpoolTickCountAdjustment, W("ThreadpoolTickCountAdjustment" ), 0, "" ) |
630 | |
631 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_Disable, W("HillClimbing_Disable" ), 0, "Disables hill climbing for thread adjustments in the thread pool" ); |
632 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_WavePeriod, W("HillClimbing_WavePeriod" ), 4, "" ); |
633 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_TargetSignalToNoiseRatio, W("HillClimbing_TargetSignalToNoiseRatio" ), 300, "" ); |
634 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_ErrorSmoothingFactor, W("HillClimbing_ErrorSmoothingFactor" ), 1, "" ); |
635 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_WaveMagnitudeMultiplier, W("HillClimbing_WaveMagnitudeMultiplier" ), 100, "" ); |
636 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_MaxWaveMagnitude, W("HillClimbing_MaxWaveMagnitude" ), 20, "" ); |
637 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_WaveHistorySize, W("HillClimbing_WaveHistorySize" ), 8, "" ); |
638 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_Bias, W("HillClimbing_Bias" ), 15, "The 'cost' of a thread. 0 means drive for increased throughput regardless of thread count; higher values bias more against higher thread counts." ); |
639 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_MaxChangePerSecond, W("HillClimbing_MaxChangePerSecond" ), 4, "" ); |
640 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_MaxChangePerSample, W("HillClimbing_MaxChangePerSample" ), 20, "" ); |
641 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_MaxSampleErrorPercent, W("HillClimbing_MaxSampleErrorPercent" ), 15, "" ); |
642 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_SampleIntervalLow, W("HillClimbing_SampleIntervalLow" ), 10, "" ); |
643 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_SampleIntervalHigh, W("HillClimbing_SampleIntervalHigh" ), 200, "" ); |
644 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_HillClimbing_GainExponent, W("HillClimbing_GainExponent" ), 200, "The exponent to apply to the gain, times 100. 100 means to use linear gain, higher values will enhance large moves and damp small ones." ); |
645 | |
646 | |
647 | /// |
648 | /// Tiered Compilation |
649 | /// |
650 | #ifdef FEATURE_TIERED_COMPILATION |
651 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_TieredCompilation, W("TieredCompilation" ), 1, "Enables tiered compilation" ) |
652 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_TieredCompilation_Tier1CallCountThreshold, W("TieredCompilation_Tier1CallCountThreshold" ), 30, "Number of times a method must be called after which it is promoted to tier 1." ) |
653 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_TieredCompilation_Tier1CallCountingDelayMs, W("TieredCompilation_Tier1CallCountingDelayMs" ), 100, "A perpetual delay in milliseconds that is applied to tier 1 call counting and jitting, while there is tier 0 activity." ) |
654 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_TieredCompilation_Tier1DelaySingleProcMultiplier, W("TieredCompilation_Tier1DelaySingleProcMultiplier" ), 10, "Multiplier for TieredCompilation_Tier1CallCountingDelayMs that is applied on a single-processor machine or when the process is affinitized to a single processor." ) |
655 | |
656 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_TieredCompilation_Test_CallCounting, W("TieredCompilation_Test_CallCounting" ), 1, "Enabled by default (only activates when TieredCompilation is also enabled). If disabled immediately backpatches prestub, and likely prevents any tier1 promotion" ) |
657 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_TieredCompilation_Test_OptimizeTier0, W("TieredCompilation_Test_OptimizeTier0" ), 0, "Use optimized codegen (normally used by tier1) in tier0" ) |
658 | #endif |
659 | |
660 | |
661 | /// |
662 | /// TypeLoader |
663 | /// |
664 | CONFIG_DWORD_INFO(INTERNAL_TypeLoader_InjectInterfaceDuplicates, W("INTERNAL_TypeLoader_InjectInterfaceDuplicates" ), 0, "Injects duplicates in interface map for all types." ) |
665 | |
666 | /// |
667 | /// Virtual call stubs |
668 | /// |
669 | CONFIG_DWORD_INFO_EX(INTERNAL_VirtualCallStubCollideMonoPct, W("VirtualCallStubCollideMonoPct" ), 0, "Used only when STUB_LOGGING is defined, which by default is not." , CLRConfig::REGUTIL_default) |
670 | CONFIG_DWORD_INFO_EX(INTERNAL_VirtualCallStubCollideWritePct, W("VirtualCallStubCollideWritePct" ), 100, "Used only when STUB_LOGGING is defined, which by default is not." , CLRConfig::REGUTIL_default) |
671 | CONFIG_DWORD_INFO_EX(INTERNAL_VirtualCallStubDumpLogCounter, W("VirtualCallStubDumpLogCounter" ), 0, "Used only when STUB_LOGGING is defined, which by default is not." , CLRConfig::REGUTIL_default) |
672 | CONFIG_DWORD_INFO_EX(INTERNAL_VirtualCallStubDumpLogIncr, W("VirtualCallStubDumpLogIncr" ), 0, "Used only when STUB_LOGGING is defined, which by default is not." , CLRConfig::REGUTIL_default) |
673 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_VirtualCallStubLogging, W("VirtualCallStubLogging" ), 0, "Worth keeping, but should be moved into \"#ifdef STUB_LOGGING\" blocks. This goes for most (or all) of the stub logging infrastructure." , CLRConfig::REGUTIL_default) |
674 | CONFIG_DWORD_INFO_EX(INTERNAL_VirtualCallStubMissCount, W("VirtualCallStubMissCount" ), 100, "Used only when STUB_LOGGING is defined, which by default is not." , CLRConfig::REGUTIL_default) |
675 | CONFIG_DWORD_INFO_EX(INTERNAL_VirtualCallStubResetCacheCounter, W("VirtualCallStubResetCacheCounter" ), 0, "Used only when STUB_LOGGING is defined, which by default is not." , CLRConfig::REGUTIL_default) |
676 | CONFIG_DWORD_INFO_EX(INTERNAL_VirtualCallStubResetCacheIncr, W("VirtualCallStubResetCacheIncr" ), 0, "Used only when STUB_LOGGING is defined, which by default is not." , CLRConfig::REGUTIL_default) |
677 | |
678 | /// |
679 | /// Watson |
680 | /// |
681 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_DisableWatsonForManagedExceptions, W("DisableWatsonForManagedExceptions" ), 0, "Disable Watson and debugger launching for managed exceptions" ) |
682 | |
683 | /// |
684 | /// Zap |
685 | /// |
686 | RETAIL_CONFIG_STRING_INFO_EX(INTERNAL_ZapBBInstr, W("ZapBBInstr" ), "" , CLRConfig::REGUTIL_default) |
687 | RETAIL_CONFIG_STRING_INFO(EXTERNAL_ZapBBInstrDir, W("ZapBBInstrDir" ), "" ) |
688 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_ZapDisable, W("ZapDisable" ), 0, "" ) |
689 | CONFIG_STRING_INFO_EX(INTERNAL_ZapExclude, W("ZapExclude" ), "" , CLRConfig::REGUTIL_default) |
690 | CONFIG_STRING_INFO_EX(INTERNAL_ZapOnly, W("ZapOnly" ), "" , CLRConfig::REGUTIL_default) |
691 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_ZapRequire, W("ZapRequire" ), "" ) |
692 | RETAIL_CONFIG_STRING_INFO(EXTERNAL_ZapRequireExcludeList, W("ZapRequireExcludeList" ), "" ) |
693 | RETAIL_CONFIG_STRING_INFO(EXTERNAL_ZapRequireList, W("ZapRequireList" ), "" ) |
694 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_ZapSet, W("ZapSet" ), "" , CLRConfig::REGUTIL_default) |
695 | |
696 | #ifdef FEATURE_LAZY_COW_PAGES |
697 | |
698 | #ifdef FEATURE_WINDOWSPHONE |
699 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_ZapLazyCOWPagesEnabled, W("ZapLazyCOWPagesEnabled" ), 1, "" ); |
700 | #else //FEATURE_WINDOWSPHONE |
701 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_ZapLazyCOWPagesEnabled, W("ZapLazyCOWPagesEnabled" ), 0, "" ); |
702 | #endif //FEATURE_WINDOWSPHONE |
703 | |
704 | CONFIG_DWORD_INFO(INTERNAL_DebugAssertOnMissedCOWPage, W("DebugAssertOnMissedCOWPage" ), 1, "" ); |
705 | |
706 | #endif //FEATURE_LAZY_COW_PAGES |
707 | |
708 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_ReadyToRun, W("ReadyToRun" ), 1, "Enable/disable use of ReadyToRun native code" ) // On by default for CoreCLR |
709 | RETAIL_CONFIG_STRING_INFO(EXTERNAL_ReadyToRunExcludeList, W("ReadyToRunExcludeList" ), "List of assemblies that cannot use Ready to Run images" ) |
710 | RETAIL_CONFIG_STRING_INFO(EXTERNAL_ReadyToRunLogFile, W("ReadyToRunLogFile" ), "Name of file to log success/failure of using Ready to Run images" ) |
711 | |
712 | #if defined(FEATURE_EVENT_TRACE) || defined(FEATURE_EVENTSOURCE_XPLAT) |
713 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_EnableEventLog, W("EnableEventLog" ), 0, "Enable/disable use of EnableEventLogging mechanism " ) // Off by default |
714 | RETAIL_CONFIG_STRING_INFO(INTERNAL_EventSourceFilter, W("EventSourceFilter" ), "" ) |
715 | RETAIL_CONFIG_STRING_INFO(INTERNAL_EventNameFilter, W("EventNameFilter" ), "" ) |
716 | #endif //defined(FEATURE_EVENT_TRACE) || defined(FEATURE_EVENTSOURCE_XPLAT) |
717 | |
718 | /// |
719 | /// Interop |
720 | /// |
721 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_ExposeExceptionsInCOM, W("ExposeExceptionsInCOM" ), "" ) |
722 | RETAIL_CONFIG_STRING_INFO_EX(EXTERNAL_PInvokeInline, W("PInvokeInline" ), "" , CLRConfig::REGUTIL_default) |
723 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_InteropValidatePinnedObjects, W("InteropValidatePinnedObjects" ), 0, "After returning from a managed-to-unmanaged interop call, validate GC heap around objects pinned by IL stubs." ) |
724 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_InteropLogArguments, W("InteropLogArguments" ), 0, "Log all pinned arguments passed to an interop call" ) |
725 | RETAIL_CONFIG_STRING_INFO(UNSUPPORTED_LogCCWRefCountChange, W("LogCCWRefCountChange" ), "Outputs debug information and calls LogCCWRefCountChange_BREAKPOINT when AddRef or Release is called on a CCW." ) |
726 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_EnableRCWCleanupOnSTAShutdown, W("EnableRCWCleanupOnSTAShutdown" ), 0, "Performs RCW cleanup when STA shutdown is detected using IInitializeSpy in classic processes." ) |
727 | RETAIL_CONFIG_STRING_INFO(INTERNAL_LocalWinMDPath, W("LocalWinMDPath" ), "Additional path to probe for WinMD files in if a WinRT type is not resolved using the standard paths." ) |
728 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_AllowDComReflection, W("AllowDComReflection" ), 0, "Allows out of process DCOM clients to marshal blocked reflection types." ) |
729 | |
730 | // |
731 | // EventPipe |
732 | // |
733 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_EnableEventPipe, W("EnableEventPipe" ), 0, "Enable/disable event pipe. Non-zero values enable tracing." ) |
734 | RETAIL_CONFIG_STRING_INFO(INTERNAL_EventPipeOutputPath, W("EventPipeOutputPath" ), "The full path excluding file name for the trace file that will be written when COMPlus_EnableEventPipe=1" ) |
735 | RETAIL_CONFIG_STRING_INFO(INTERNAL_EventPipeConfig, W("EventPipeConfig" ), "Configuration for EventPipe." ) |
736 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_EventPipeRundown, W("EventPipeRundown" ), 1, "Enable/disable eventpipe rundown." ) |
737 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_EventPipeCircularMB, W("EventPipeCircularMB" ), 1024, "The EventPipe circular buffer size in megabytes." ) |
738 | |
739 | #ifdef FEATURE_GDBJIT |
740 | /// |
741 | /// GDBJIT |
742 | /// |
743 | CONFIG_STRING_INFO(INTERNAL_GDBJitElfDump, W("GDBJitElfDump" ), "Dump ELF for specified method" ) |
744 | #ifdef FEATURE_GDBJIT_FRAME |
745 | RETAIL_CONFIG_DWORD_INFO(INTERNAL_GDBJitEmitDebugFrame, W("GDBJitEmitDebugFrame" ), TRUE, "Enable .debug_frame generation" ) |
746 | #endif |
747 | #endif |
748 | |
749 | /// |
750 | /// Uncategorized |
751 | /// |
752 | // |
753 | // Unknown |
754 | // |
755 | //--------------------------------------------------------------------------------------- |
756 | // ** |
757 | // PLEASE MOVE ANY CONFIG SWITCH YOU OWN OUT OF THIS SECTION INTO A CATEGORY ABOVE |
758 | // |
759 | // DO NOT ADD ANY MORE CONFIG SWITCHES TO THIS SECTION! |
760 | // ** |
761 | CONFIG_DWORD_INFO_EX(INTERNAL_ActivatePatchSkip, W("ActivatePatchSkip" ), 0, "Allows an assert when ActivatePatchSkip is called" , CLRConfig::REGUTIL_default) |
762 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_AlwaysUseMetadataInterfaceMapLayout, W("AlwaysUseMetadataInterfaceMapLayout" ), "Used for debugging generic interface map layout." ) |
763 | CONFIG_DWORD_INFO(INTERNAL_AssertOnUnneededThis, W("AssertOnUnneededThis" ), 0, "While the ConfigDWORD is unnecessary, the contained ASSERT should be kept. This may result in some work tracking down violating MethodDescCallSites." ) |
764 | CONFIG_DWORD_INFO_EX(INTERNAL_AssertStacktrace, W("AssertStacktrace" ), 1, "" , CLRConfig::REGUTIL_default) |
765 | CONFIG_DWORD_INFO_EX(INTERNAL_clearNativeImageStress, W("clearNativeImageStress" ), 0, "" , CLRConfig::REGUTIL_default) |
766 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_CPUFamily, W("CPUFamily" ), "" ) |
767 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_CPUFeatures, W("CPUFeatures" ), "" ) |
768 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_DisableConfigCache, W("DisableConfigCache" ), 0, "Used to disable the \"probabilistic\" config cache, which walks through the appropriate config registry keys on init and probabilistically keeps track of which exist." , CLRConfig::REGUTIL_default) |
769 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_DisableStackwalkCache, W("DisableStackwalkCache" ), "" ) |
770 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_DoubleArrayToLargeObjectHeap, W("DoubleArrayToLargeObjectHeap" ), "Controls double[] placement" ) |
771 | CONFIG_DWORD_INFO(INTERNAL_DumpConfiguration, W("DumpConfiguration" ), 0, "Dumps runtime properties of xml configuration files to the log." ) |
772 | CONFIG_STRING_INFO(INTERNAL_DumpOnClassLoad, W("DumpOnClassLoad" ), "Dumps information about loaded class to log." ) |
773 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_ExpandAllOnLoad, W("ExpandAllOnLoad" ), "" ) |
774 | CONFIG_STRING_INFO_DIRECT_ACCESS(INTERNAL_ForcedRuntime, W("ForcedRuntime" ), "Verify version of CLR loaded" ) |
775 | CONFIG_DWORD_INFO_EX(INTERNAL_ForceRelocs, W("ForceRelocs" ), 0, "" , CLRConfig::REGUTIL_default) |
776 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_GenerateLongJumpDispatchStubRatio, W("GenerateLongJumpDispatchStubRatio" ), "Useful for testing VSD on AMD64" ) |
777 | CONFIG_DWORD_INFO_EX(INTERNAL_HashStack, W("HashStack" ), 0, "" , CLRConfig::REGUTIL_default) |
778 | CONFIG_DWORD_INFO(INTERNAL_HostManagerConfig, W("HostManagerConfig" ), (DWORD)-1, "" ) |
779 | CONFIG_DWORD_INFO(INTERNAL_HostTestThreadAbort, W("HostTestThreadAbort" ), 0, "" ) |
780 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_IgnoreDllMainReturn, W("IgnoreDllMainReturn" ), 0, "Don't check the return value of DllMain if this is set" , CLRConfig::ConfigFile_ApplicationFirst) |
781 | CONFIG_STRING_INFO(INTERNAL_InvokeHalt, W("InvokeHalt" ), "Throws an assert when the given method is invoked through reflection." ) |
782 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_legacyNullReferenceExceptionPolicy, W("legacyNullReferenceExceptionPolicy" ), "" ) |
783 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_legacyUnhandledExceptionPolicy, W("legacyUnhandledExceptionPolicy" ), "" ) |
784 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_MaxStackDepth, W("MaxStackDepth" ), "" ) |
785 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_MaxStubUnwindInfoSegmentSize, W("MaxStubUnwindInfoSegmentSize" ), "" ) |
786 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_MaxThreadRecord, W("MaxThreadRecord" ), "" ) |
787 | CONFIG_DWORD_INFO(INTERNAL_MessageDebugOut, W("MessageDebugOut" ), 0, "" ) |
788 | CONFIG_DWORD_INFO_EX(INTERNAL_MscorsnLogging, W("MscorsnLogging" ), 0, "Enables strong name logging" , CLRConfig::REGUTIL_default) |
789 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_NativeImageRequire, W("NativeImageRequire" ), 0, "" , CLRConfig::REGUTIL_default) |
790 | CONFIG_DWORD_INFO_EX(INTERNAL_NestedEhOom, W("NestedEhOom" ), 0, "" , CLRConfig::REGUTIL_default) |
791 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_NO_SO_NOT_MAINLINE, W("NO_SO_NOT_MAINLINE" ), 0, "" , CLRConfig::REGUTIL_default) |
792 | #define INTERNAL_NoGuiOnAssert_Default 1 |
793 | RETAIL_CONFIG_DWORD_INFO_EX(INTERNAL_NoGuiOnAssert, W("NoGuiOnAssert" ), INTERNAL_NoGuiOnAssert_Default, "" , CLRConfig::REGUTIL_default) |
794 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_NoProcedureSplitting, W("NoProcedureSplitting" ), 0, "" , CLRConfig::REGUTIL_default) |
795 | CONFIG_DWORD_INFO_EX(INTERNAL_NoStringInterning, W("NoStringInterning" ), 1, "Disallows string interning. I see no value in it anymore." , CLRConfig::REGUTIL_default) |
796 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_NotifyBadAppCfg, W("NotifyBadAppCfg" ), "Whether to show a message box for bad application config file." ) |
797 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_PauseOnLoad, W("PauseOnLoad" ), "Stops in SystemDomain::init. I think it can be removed." ) |
798 | CONFIG_DWORD_INFO(INTERNAL_PerfAllocsSizeThreshold, W("PerfAllocsSizeThreshold" ), 0x3FFFFFFF, "Log facility LF_GCALLOC logs object allocations. This flag controls which ones also log stacktraces. Predates ClrProfiler." ) |
799 | CONFIG_DWORD_INFO(INTERNAL_PerfNumAllocsThreshold, W("PerfNumAllocsThreshold" ), 0x3FFFFFFF, "Log facility LF_GCALLOC logs object allocations. This flag controls which ones also log stacktraces. Predates ClrProfiler." ) |
800 | CONFIG_STRING_INFO(INTERNAL_PerfTypesToLog, W("PerfTypesToLog" ), "Log facility LF_GCALLOC logs object allocations. This flag controls which ones also log stacktraces. Predates ClrProfiler." ) |
801 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_Prepopulate1, W("Prepopulate1" ), 1, "" ) |
802 | CONFIG_STRING_INFO(INTERNAL_PrestubGC, W("PrestubGC" ), "" ) |
803 | CONFIG_STRING_INFO(INTERNAL_PrestubHalt, W("PrestubHalt" ), "" ) |
804 | RETAIL_CONFIG_STRING_INFO(EXTERNAL_RestrictedGCStressExe, W("RestrictedGCStressExe" ), "" ) |
805 | CONFIG_DWORD_INFO_EX(INTERNAL_ReturnSourceTypeForTesting, W("ReturnSourceTypeForTesting" ), 0, "Allows returning the (internal only) source type of an IL to Native mapping for debugging purposes" , CLRConfig::REGUTIL_default) |
806 | RETAIL_CONFIG_DWORD_INFO_EX(, W("RSStressLog" ), 0, "Allows turning on logging for RS startup" , CLRConfig::REGUTIL_default) |
807 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_SaveThreadInfo, W("SaveThreadInfo" ), "" ) |
808 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_SaveThreadInfoMask, W("SaveThreadInfoMask" ), "" ) |
809 | CONFIG_DWORD_INFO(INTERNAL_SBDumpOnNewIndex, W("SBDumpOnNewIndex" ), 0, "Used for Syncblock debugging. It's been a while since any of those have been used." ) |
810 | CONFIG_DWORD_INFO(INTERNAL_SBDumpOnResize, W("SBDumpOnResize" ), 0, "Used for Syncblock debugging. It's been a while since any of those have been used." ) |
811 | CONFIG_DWORD_INFO(INTERNAL_SBDumpStyle, W("SBDumpStyle" ), 0, "Used for Syncblock debugging. It's been a while since any of those have been used." ) |
812 | RETAIL_CONFIG_STRING_INFO_DIRECT_ACCESS(UNSUPPORTED_ShimDatabaseVersion, W("ShimDatabaseVersion" ), "Force using shim database version in registry" ) |
813 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_SleepOnExit, W("SleepOnExit" ), 0, "Used for lrak detection. I'd say deprecated by umdh." ) |
814 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_StubLinkerUnwindInfoVerificationOn, W("StubLinkerUnwindInfoVerificationOn" ), "" ) |
815 | RETAIL_CONFIG_DWORD_INFO_EX(UNSUPPORTED_SuccessExit, W("SuccessExit" ), 0, "" , CLRConfig::REGUTIL_default) |
816 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_SymbolReadingPolicy, W("SymbolReadingPolicy" ), "Specifies when PDBs may be read" ) |
817 | RETAIL_CONFIG_DWORD_INFO(UNSUPPORTED_TestDataConsistency, W("TestDataConsistency" ), FALSE, "Allows ensuring the left side is not holding locks (and may thus be in an inconsistent state) when inspection occurs" ) |
818 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_ThreadGuardPages, W("ThreadGuardPages" ), 0, "" , CLRConfig::REGUTIL_default) |
819 | RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_Timeline, W("Timeline" ), 0, "" , CLRConfig::REGUTIL_default) |
820 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(UNSUPPORTED_TotalStressLogSize, W("TotalStressLogSize" ), "Total stress log size in bytes." ) |
821 | |
822 | #ifdef _DEBUG |
823 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_TraceIUnknown, W("TraceIUnknown" ), "" ) |
824 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_TraceWrap, W("TraceWrap" ), "" ) |
825 | #endif |
826 | |
827 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_TURNOFFDEBUGINFO, W("TURNOFFDEBUGINFO" ), "" ) |
828 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_UseMethodDataCache, W("UseMethodDataCache" ), FALSE, "Used during feature development; may now be removed." ) |
829 | RETAIL_CONFIG_DWORD_INFO(EXTERNAL_UseParentMethodData, W("UseParentMethodData" ), TRUE, "Used during feature development; may now be removed." ) |
830 | CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_VerifierOff, W("VerifierOff" ), "" ) |
831 | RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_VerifyAllOnLoad, W("VerifyAllOnLoad" ), "" ) |
832 | // ** |
833 | // PLEASE MOVE ANY CONFIG SWITCH YOU OWN OUT OF THIS SECTION INTO A CATEGORY ABOVE |
834 | // |
835 | // DO NOT ADD ANY MORE CONFIG SWITCHES TO THIS SECTION! |
836 | // ** |
837 | //--------------------------------------------------------------------------------------- |
838 | |