From 1fda88c67b4c5634956604bf2fb4d80b59a0a797 Mon Sep 17 00:00:00 2001 From: Steve Pfister Date: Wed, 14 Jan 2026 10:57:01 -0500 Subject: [PATCH 1/2] Add DOTNET_DbgCreateDumpToolPath env variable and description Documents new environment variable added in https://github.com/dotnet/runtime/pull/122989 where you can point to an alternate directory where the createdump tool lives. Works only with NativeAOT .NET 11 and above. --- docs/core/diagnostics/collect-dumps-crash.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/core/diagnostics/collect-dumps-crash.md b/docs/core/diagnostics/collect-dumps-crash.md index 272572942dc3f..e2f0588168338 100644 --- a/docs/core/diagnostics/collect-dumps-crash.md +++ b/docs/core/diagnostics/collect-dumps-crash.md @@ -16,6 +16,7 @@ The following table shows the environment variables you can configure for collec |`DOTNET_DbgMiniDumpType`|Type of dump to be collected. For more information, see [Types of mini dumps](#types-of-mini-dumps).|2 (`Heap`)| |`DOTNET_DbgMiniDumpName`|Path to a file to write the dump to. Ensure that the user under which the dotnet process is running has write permissions to the specified directory.|`/tmp/coredump.`| |`DOTNET_CreateDumpDiagnostics`|If set to 1, enables diagnostic logging of dump process.|0| +|`DOTNET_DbgCreateDumpToolPath`|(.NET 11+ NativeAOT only)
If set, specifies the directory path where the createdump tool is located. The runtime will look for the createdump binary in this directory. This is useful in scenarios where createdump is not shipped with the runtime and you need to "bring your own" dump generation tool. This environment variable is only supported in NativeAOT applications and ignored otherwise.| | |`DOTNET_EnableCrashReport`|(not supported on Windows.)
If set to 1, the runtime generates a JSON-formatted crash report that includes information about the threads and stack frames of the crashing application. The crash report name is the dump path or name with *.crashreport.json* appended.| | |`DOTNET_CreateDumpVerboseDiagnostics`|If set to 1, enables verbose diagnostic logging of the dump process.|0| |`DOTNET_CreateDumpLogToFile`|The path of the file to which the diagnostic messages should be written. | If unset, the diagnostic messages are written to the console of the crashing application. | From 2386cf0cfb577cf538e2defa6b365d0fd74961b8 Mon Sep 17 00:00:00 2001 From: Steve Pfister Date: Wed, 14 Jan 2026 11:44:32 -0500 Subject: [PATCH 2/2] Update docs/core/diagnostics/collect-dumps-crash.md Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --- docs/core/diagnostics/collect-dumps-crash.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/diagnostics/collect-dumps-crash.md b/docs/core/diagnostics/collect-dumps-crash.md index e2f0588168338..49dcca8067b26 100644 --- a/docs/core/diagnostics/collect-dumps-crash.md +++ b/docs/core/diagnostics/collect-dumps-crash.md @@ -16,7 +16,7 @@ The following table shows the environment variables you can configure for collec |`DOTNET_DbgMiniDumpType`|Type of dump to be collected. For more information, see [Types of mini dumps](#types-of-mini-dumps).|2 (`Heap`)| |`DOTNET_DbgMiniDumpName`|Path to a file to write the dump to. Ensure that the user under which the dotnet process is running has write permissions to the specified directory.|`/tmp/coredump.`| |`DOTNET_CreateDumpDiagnostics`|If set to 1, enables diagnostic logging of dump process.|0| -|`DOTNET_DbgCreateDumpToolPath`|(.NET 11+ NativeAOT only)
If set, specifies the directory path where the createdump tool is located. The runtime will look for the createdump binary in this directory. This is useful in scenarios where createdump is not shipped with the runtime and you need to "bring your own" dump generation tool. This environment variable is only supported in NativeAOT applications and ignored otherwise.| | +|`DOTNET_DbgCreateDumpToolPath`|(.NET 11+ NativeAOT only)
Path to the directory where the createdump tool is located. The runtime will look for the createdump binary in this directory. This variable is useful in scenarios where createdump isn't shipped with the runtime and you need to "bring your own" dump generation tool. This environment variable is only supported in NativeAOT applications and ignored otherwise.| | |`DOTNET_EnableCrashReport`|(not supported on Windows.)
If set to 1, the runtime generates a JSON-formatted crash report that includes information about the threads and stack frames of the crashing application. The crash report name is the dump path or name with *.crashreport.json* appended.| | |`DOTNET_CreateDumpVerboseDiagnostics`|If set to 1, enables verbose diagnostic logging of the dump process.|0| |`DOTNET_CreateDumpLogToFile`|The path of the file to which the diagnostic messages should be written. | If unset, the diagnostic messages are written to the console of the crashing application. |