<GCCpuGroup> Element

Specifies whether garbage collection supports multiple CPU groups.

<configuration>
  <runtime>
    <GCCpuGroup>

Syntax

<GCCpuGroup
   enabled="true|false"/>

Attributes and Elements

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

Attributes

Attribute Description
enabled Required attribute.

Specifies whether garbage collection supports multiple CPU groups.

enabled Attribute

Value Description
false Garbage collection does not support multiple CPU groups. This is the default.
true Garbage collection supports multiple CPU groups, if server garbage collection 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 and server garbage collection is enabled (see the <gcServer> element), enabling this element extends garbage collection across all CPU groups and takes all cores into account when creating and balancing heaps.

Note

This element applies only to garbage collection threads. To enable the runtime to distribute user threads across all CPU groups, you must also enable the <Thread_UseAllCpuGroups> element.

Example

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

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

See also