Skip to content

Commit

Permalink
add disablestackoverflowprobing element (dotnet#29131)
Browse files Browse the repository at this point in the history
  • Loading branch information
gewarren authored Apr 21, 2022
1 parent 7956cac commit 39c3063
Show file tree
Hide file tree
Showing 4 changed files with 61 additions and 8 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
description: "Learn more about: <disableStackOverflowProbing> Element"
title: "<disableStackOverflowProbing> Element"
ms.date: 04/20/2022
---
# \<disableStackOverflowProbing> Element

Specifies whether stack-overflow probing is disabled.

[**\<configuration>**](../configuration-element.md)\
&nbsp;&nbsp;[**\<runtime>**](runtime-element.md)\
&nbsp;&nbsp;&nbsp;&nbsp;**\<disableStackOverflowProbing>**

## Syntax

```xml
<disableStackOverflowProbing enabled="true"|"false" />
```

## Attribute

| Attribute | Description |
|-----------|--------------------------------------------------------------------------------------|
| `enabled` | Required attribute.<br /><br />Specifies whether stack-overflow probing is disabled. |

### enabled Attribute

| Value | Description |
|-------|-------------------------------------|
| true | Stack-overflow probing is enabled. |
| false | Stack-overflow probing is disabled. |

### 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 runtime initialization options.|

## Remarks

The `<disableStackOverflowProbing>` specifies whether stack-overflow probing is disabled. If you specify a very small stack size when constructing a <xref:System.Threading.Thread> by calling <xref:System.Threading.Thread.%23ctor(System.Threading.ParameterizedThreadStart,System.Int32)>, you might need to disable stack-overflow probing. When the stack is severely constrained, the probing can itself cause a stack overflow.

## See also

- [\<runtime> Element](runtime-element.md)
- [\<configuration> Element](../configuration-element.md)
10 changes: 6 additions & 4 deletions docs/framework/configure-apps/file-schema/runtime/index.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
---
description: "Learn more about: Run-time settings schema"
description: "Learn more about: Runtime settings schema"
title: "Runtime Settings Schema"
ms.date: "03/30/2017"
ms.date: 04/20/2022
helpviewer_keywords:
- "schema runtime settings"
- "configuration schema [.NET Framework], runtime settings"
- "runtime settings schema"
ms.assetid: f04816ab-110d-4e28-9283-845d6d9a4a68
---
# Run-time settings schema
# Runtime settings schema

Run-time settings are used by the common language runtime to configure applications that target the .NET Framework.
Runtime settings are used by the common language runtime to configure applications that target .NET Framework.

## The \<runtime> section and its parent and child elements

Expand All @@ -36,6 +36,7 @@ Run-time settings are used by the common language runtime to configure applicati
&nbsp;&nbsp;&nbsp;&nbsp;[\<disableCachingBindingFailures>](disablecachingbindingfailures-element.md)\
&nbsp;&nbsp;&nbsp;&nbsp;[\<disableCommitThreadStack>](disablecommitthreadstack-element.md)\
&nbsp;&nbsp;&nbsp;&nbsp;[\<disableFusionUpdatesFromADManager>](disablefusionupdatesfromadmanager-element.md)\
&nbsp;&nbsp;&nbsp;&nbsp;[\<disableStackOverflowProbing>](disableStackOverflowProbing-element.md)\
&nbsp;&nbsp;&nbsp;&nbsp;[\<EnableAmPmParseAdjustment>](enableampmparseadjustment-element.md)\
&nbsp;&nbsp;&nbsp;&nbsp;[\<enforceFIPSPolicy>](enforcefipspolicy-element.md)\
&nbsp;&nbsp;&nbsp;&nbsp;[\<etwEnable>](etwenable-element.md)\
Expand Down Expand Up @@ -93,6 +94,7 @@ Run-time settings are used by the common language runtime to configure applicati
|[\<disableCachingBindingFailures>](disablecachingbindingfailures-element.md)|Specifies whether the caching of binding failures, which is the default behavior in the .NET Framework 2.0, is disabled.|
|[\<disableCommitThreadStack>](disablecommitthreadstack-element.md)|Specifies whether the full thread stack is committed when a thread starts.|
|[\<disableFusionUpdatesFromADManager>](disablefusionupdatesfromadmanager-element.md)|Specifies whether the default behavior, which is to allow the runtime host to override configuration settings for an application domain, is disabled.|
|[\<disableStackOverflowProbing>](disableStackOverflowProbing-element.md)|Specifies whether stack-overflow probing is disabled.|
|[\<EnableAmPmParseAdjustment>](enableampmparseadjustment-element.md)|Determines whether date and time parsing methods use an adjusted set of rules to parse date strings that contain only a day, month, hour, and AM/PM designator.|
|[\<enforceFIPSPolicy>](enforcefipspolicy-element.md)|Specifies whether to enforce a computer configuration requirement that cryptographic algorithms must comply with the Federal Information Processing Standards (FIPS).|
|[\<etwEnable>](etwenable-element.md)|Specifies whether to enable event tracing for Windows (ETW) for common language runtime events.|
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,7 @@ None.
|[\<disableCachingBindingFailures>](disablecachingbindingfailures-element.md)|Specifies whether the caching of binding failures, which is the default behavior in the .NET Framework version 2.0, is disabled.|
|[\<disableCommitThreadStack>](disablecommitthreadstack-element.md)|Specifies whether the full thread stack is committed when a thread is started.|
|[\<disableFusionUpdatesFromADManager>](disablefusionupdatesfromadmanager-element.md)|Specifies whether the default behavior, which is to allow the runtime host to override configuration settings for an application domain, is disabled.|
|[\<disableStackOverflowProbing>](disableStackOverflowProbing-element.md)|Specifies whether stack-overflow probing is disabled.|
|[\<EnableAmPmParseAdjustment>](enableampmparseadjustment-element.md)|Determines whether date and time parsing methods use an adjusted set of rules to parse date strings that contain only a day, month, hour, and AM/PM designator.|
|[\<enforceFIPSPolicy>](enforcefipspolicy-element.md)|Specifies whether to enforce a computer configuration requirement that cryptographic algorithms must comply with the Federal Information Processing Standards (FIPS).|
|[\<etwEnable>](etwenable-element.md)|Specifies whether to enable event tracing for Windows (ETW) for common language runtime events.|
Expand Down Expand Up @@ -91,7 +92,7 @@ None.

The child elements in the [\<runtime>](runtime-element.md) section of a configuration file are used by the common language runtime to configure how an application executes. For example, the [\<gcServer>](gcserver-element.md) element determines whether the garbage collector uses workstation garbage collection or server garbage collection, the [\<UseRandomizedStringHashAlgorithm>](userandomizedstringhashalgorithm-element.md) element determines whether the common language runtime calculates hash codes for string on a per-application or a per-application domain basis, and the `AppContextSwitchOverrides` element allows library users to opt in or opt out of changed functionality provided by a library.

The elements in the [\<runtime>](runtime-element.md) section are read automatically by the common language runtime at application startup. You can also define the configuration file for a non-default application domain by supplying its name to the <xref:System.AppDomainSetup.ConfigurationFile%2A?displayProperty=nameWithType> property; its settings are read automatically when the application domain is loaded. You should rarely, if ever, have a need to directly read the settings in the [\<runtime>](runtime-element.md) section in your application's configuration file.
The elements in the [\<runtime>](runtime-element.md) section are read automatically by the common language runtime at application startup. You can also define the configuration file for a non-default application domain by supplying its name to the <xref:System.AppDomainSetup.ConfigurationFile%2A?displayProperty=nameWithType> property; its settings are read automatically when the application domain is loaded. You should rarely, if ever, have a need to directly read the settings in the [\<runtime>](runtime-element.md) section of your application's configuration file.

## See also

Expand Down
9 changes: 6 additions & 3 deletions docs/framework/configure-apps/file-schema/runtime/toc.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
- name: Run-time settings schema
items:
- name: Runtime settings schema
href: index.md
- name: Run-time configuration
- name: Runtime configuration
items:
- name: <runtime> element
href: runtime-element.md
Expand Down Expand Up @@ -48,6 +49,8 @@
href: disablecommitthreadstack-element.md
- name: <disableFusionUpdatesFromADManager> element
href: disablefusionupdatesfromadmanager-element.md
- name: <disableStackOverflowProbing> element
href: disableStackOverflowProbing-element.md
- name: <EnableAmPmParseAdjustment> element
href: enableampmparseadjustment-element.md
- name: <enforceFIPSPolicy> element
Expand Down Expand Up @@ -106,7 +109,7 @@
href: userandomizedstringhashalgorithm-element.md
- name: <UseSmallInternalThreadStacks> element
href: usesmallinternalthreadstacks-element.md
- name: Run-time caching
- name: Runtime caching
items:
- name: <system.runtime.caching> element
href: system-runtime-caching-element-cache-settings.md
Expand Down

0 comments on commit 39c3063

Please sign in to comment.