<Thread_UseAllCpuGroups> Element

.NET Framework (current version)
 

Specifies whether the runtime distributes managed threads across all CPU groups.

<configuration>
<runtime>
<Thread_UseAllCpuGroups>

<Thread_UseAllCpuGroups    
   enabled="true|false"/>  

The following sections describe attributes, child elements, and parent elements.

Attributes

AttributeDescription
enabledRequired attribute.

Specifies whether the runtime distributes managed threads across all CPU groups.
ValueDescription
falseThe runtime does not distribute managed threads across multiple CPU groups. This is the default.
trueThe runtime distributes managed threads across multiple CPU groups, if the computer has multiple CPU groups and the <GCCpuGroup> element is enabled.

Child Elements

None.

Parent Elements

ElementDescription
configurationThe root element in every configuration file used by the common language runtime and .NET Framework applications.
runtimeContains information about assembly binding and garbage collection.

When a computer has multiple CPU groups, enabling this element causes the runtime to distribute managed threads across all CPU groups. To use this feature, you must also enable the <GCCpuGroup> element, which extends garbage collection to all CPU groups and takes all cores into account when creating and balancing heaps. Enabling the <GCCpuGroup> element requires enabling the <gcServer> element. If these elements are not enabled, enabling the <Thread_UseAllCpuGroups> element has no effect.

The following example shows how to enable support for multiple CPU groups.

<configuration>  
   <runtime>  
      <Thread_UseAllCpuGroups enabled="true"/>  
      <GCCpuGroup enabled="true"/>  
      <gcServer enabled="true"/>  
   </runtime>  
</configuration>  

Runtime Settings Schema
Configuration File Schema
<GCCpuGroup> Element

Show: