Document new threading settings #47575
Open
+11
−0
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
jkotas
reviewed
Jul 25, 2025
| @@ -31,6 +31,17 @@ This article details the settings you can use to configure threading in .NET. | |||
| | **runtimeconfig.json** | N/A | N/A | | |||
| | **Environment variable** | `COMPlus_Thread_AssignCpuGroups` or `DOTNET_Thread_AssignCpuGroups` | `0` - disabled<br/>`1` - enabled | | |||
|
|
|||
| ## Set the size of stack for VM-created threads | |||
There was a problem hiding this comment.
Suggested change
| ## Set the size of stack for VM-created threads | |
| ## Set the stack size for threads created by the .NET runtime |
I do not think we use "VM" in the official docs when referring to the runtime
|
|
||
| - The default size of stack is dictated by VM and OS policies. | ||
| - This setting allows overriding the default. | ||
| - The specified size should be between 64 kB and 2 GB and a multiple of the natural allocation granularity of the OS. |
There was a problem hiding this comment.
a multiple of the natural allocation granularity of the OS
Can we align the size up in the implementation so that this does not need to be documented? I think it is only a problem on Windows. This should behave just like the stackSize argument for System.Threading.Thread constructor where we do the same.
| @@ -31,6 +31,17 @@ This article details the settings you can use to configure threading in .NET. | |||
| | **runtimeconfig.json** | N/A | N/A | | |||
| | **Environment variable** | `COMPlus_Thread_AssignCpuGroups` or `DOTNET_Thread_AssignCpuGroups` | `0` - disabled<br/>`1` - enabled | | |||
|
|
|||
| ## Set the size of stack for VM-created threads | |||
|
|
|||
| - The default size of stack is dictated by VM and OS policies. | |||
There was a problem hiding this comment.
Suggested change
| - The default size of stack is dictated by VM and OS policies. | |
| - The default stack size is dictated by .NET and OS policies. The default stack size for .NET apps is 1.5MB on Windows and macOS, and 8MB on Linux. The default stack size when .NET runtime is hosted (e.g. COM components) is dictated by the hosting process. |
We can document the defaults while we are on it.
| ## Set the size of stack for VM-created threads | ||
|
|
||
| - The default size of stack is dictated by VM and OS policies. | ||
| - This setting allows overriding the default. |
There was a problem hiding this comment.
Suggested change
| - This setting allows overriding the default. | |
| - This setting allows overriding the default for threads created by .NET runtime. For example, threads created by [`System.Threading.Thread`](https://learn.microsoft.com/en-us/dotnet/api/system.threading.thread.-ctor) API. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Added in dotnet/runtime#110455.
Internal previews