<GCCpuGroup> Element

Article
05/25/2022

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>