From 2cbcccb02ff162b6bc81d827a231a9465e8d26e7 Mon Sep 17 00:00:00 2001 From: Cam Soper Date: Thu, 6 Feb 2025 00:06:52 +0000 Subject: [PATCH 1/2] fixes #43828 --- docs/core/compatibility/10.0.md | 8 ++-- .../cryptography/10.0/version-override.md | 38 +++++++++++++++++++ docs/core/compatibility/toc.yml | 4 ++ 3 files changed, 47 insertions(+), 3 deletions(-) create mode 100644 docs/core/compatibility/cryptography/10.0/version-override.md diff --git a/docs/core/compatibility/10.0.md b/docs/core/compatibility/10.0.md index 3cfb3b62328eb..7c46e38b051a9 100644 --- a/docs/core/compatibility/10.0.md +++ b/docs/core/compatibility/10.0.md @@ -27,6 +27,7 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af | [LDAP DirectoryControl parsing is now more stringent](core-libraries/10.0/ldap-directorycontrol-parsing.md) | Behavioral change | Preview 1 | | [MacCatalyst version normalization](core-libraries/10.0/maccatalyst-version-normalization.md) | Behavioral change | Preview 1 | + ## Globalization | Title | Type of change | Introduced version | @@ -35,9 +36,10 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af ## Cryptography -| Title | Type of change | Introduced version | -|--------------------------------------------------------------------------------------------------------|-------------------|--------------------| -| [X500DistinguishedName validation is stricter](cryptography/10.0/x500distinguishedname-validation.md) | Behavioral change | Preview 1 | +| Title | Type of change | Introduced version | +|------------------------------------------------------------------------------------------------------------|-------------------|--------------------| +| [X500DistinguishedName validation is stricter](cryptography/10.0/x500distinguishedname-validation.md) | Behavioral change | Preview 1 | +| [Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE](cryptography/10.0/version-override.md) | Behavioral change | Preview 1 | ## Windows Forms diff --git a/docs/core/compatibility/cryptography/10.0/version-override.md b/docs/core/compatibility/cryptography/10.0/version-override.md new file mode 100644 index 0000000000000..7fcb4574d7630 --- /dev/null +++ b/docs/core/compatibility/cryptography/10.0/version-override.md @@ -0,0 +1,38 @@ +--- +title: "Breaking change: Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE" +description: Learn about the .NET 10 breaking change in .NET cryptography where the environment variable CLR_OPENSSL_VERSION_OVERRIDE was renamed to DOTNET_OPENSSL_VERSION_OVERRIDE. +ms.date: 02/05/2025 +ai-usage: ai-assisted +--- + +# Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE + +.NET previously supported a configuration-switch environment variable called `CLR_OPENSSL_VERSION_OVERRIDE`, which allowed users to specify the preferred OpenSSL library version for apps running on Linux. In .NET 10, this environment variable has been renamed to `DOTNET_OPENSSL_VERSION_OVERRIDE` to align with the naming convention of other configuration switch environment variables in .NET. + +## Previous behavior + +The `CLR_OPENSSL_VERSION_OVERRIDE` environment variable was used to specify the preferred OpenSSL version to be loaded in the application. + +## New behavior + +The `DOTNET_OPENSSL_VERSION_OVERRIDE` environment variable is used to specify the preferred OpenSSL version to be loaded in the application. + +## Version introduced + +.NET 10 Preview 1 + +## Type of breaking change + +This change is a [behavioral change](../../categories.md#behavioral-change). + +## Reason for change + +This change ensures the environment variable is consistent with the naming convention used for all [.NET environment variables](../../../tools/dotnet-environment-variables.md). + +## Recommended action + +If you have a .NET 10 app that previously used the `CLR_OPENSSL_VERSION_OVERRIDE` environment variable, use `DOTNET_OPENSSL_VERSION_OVERRIDE` instead. + +## Affected APIs + +N/A diff --git a/docs/core/compatibility/toc.yml b/docs/core/compatibility/toc.yml index d512dd2bc91aa..f708acc61586a 100644 --- a/docs/core/compatibility/toc.yml +++ b/docs/core/compatibility/toc.yml @@ -26,6 +26,8 @@ items: items: - name: X500DistinguishedName validation is stricter href: cryptography/10.0/x500distinguishedname-validation.md + - name: Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE + href: cryptography/10.0/version-override.md - name: Globalization items: - name: Environment variable renamed to DOTNET_ICU_VERSION_OVERRIDE @@ -1584,6 +1586,8 @@ items: items: - name: X500DistinguishedName validation is stricter href: cryptography/10.0/x500distinguishedname-validation.md + - name: Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE + href: cryptography/10.0/version-override.md - name: .NET 9 items: - name: SafeEvpPKeyHandle.DuplicateHandle up-refs the handle From 54c8e6a7b6b187792d0298f0eeaffd7bcef44674 Mon Sep 17 00:00:00 2001 From: Cam Soper Date: Fri, 7 Feb 2025 00:10:05 +0000 Subject: [PATCH 2/2] whoops extra line --- docs/core/compatibility/10.0.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/core/compatibility/10.0.md b/docs/core/compatibility/10.0.md index 7c46e38b051a9..fc7e8837b7bf6 100644 --- a/docs/core/compatibility/10.0.md +++ b/docs/core/compatibility/10.0.md @@ -27,7 +27,6 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af | [LDAP DirectoryControl parsing is now more stringent](core-libraries/10.0/ldap-directorycontrol-parsing.md) | Behavioral change | Preview 1 | | [MacCatalyst version normalization](core-libraries/10.0/maccatalyst-version-normalization.md) | Behavioral change | Preview 1 | - ## Globalization | Title | Type of change | Introduced version |