Edit

<Thread_UseAllCpuGroups> Element

  • Article

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

<configuration>
  <runtime>
    <Thread_UseAllCpuGroups>

Syntax

<Thread_UseAllCpuGroups
   enabled="true|false"/>

Attributes and Elements

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

Attributes

Attribute Description
enabled Required attribute.

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

enabled Attribute

Value Description
false The runtime does not distribute managed threads across multiple CPU groups. This is the default.
true The 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

Element Description
configuration The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Contains information about assembly binding and garbage collection.

Remarks

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.

Example

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>

See also