Skip to content

Commit 481bc26

Browse files
authored
Add an FAQ entry for non-Microsoft vendors (#5531)
`dotnet dump` can analyze dumps from any .NET runtime, but it needs a matching DAC and unmanaged symbols. For .NET runtimes built by others, these are not available from the usual symbol servers. Users can try going back to the original environment so `dotnet dump` can find the matching dac.
1 parent 24de8bf commit 481bc26

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

documentation/FAQ.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,3 +96,17 @@ Frequently Asked Questions
9696
```
9797
9898
You may need a different bitness of the Windows (windbg/cdb) debugger or dotnet-dump. If you are running an x64 (64 bit), try an x86 (32 bit) version. The easiest way to get an x86 version of dotnet-dump is installing the "single-file" version [here](https://aka.ms/dotnet-dump/win-x86). For more information on single-file tools see [here](https://github.com/dotnet/diagnostics/blob/main/documentation/single-file-tools.md#single-file-diagnostic-tools).
99+
100+
* If you are using `dotnet-dump analyze` and see an error like:
101+
102+
```
103+
ERROR: No CLR runtime found
104+
```
105+
106+
This can happen if you are analyzing a dump on a different machine or OS than where the dump was created, specially when the dump comes from a .NET runtime provided by a non-Microsoft entity (such as a Linux distribution).
107+
108+
A workaround is to run `dotnet-dump analyze` in the same environment (machine, container, or OS) where the dump was originally generated. That lets `dotnet-dump` use the DAC module included in the runtime and get going.
109+
110+
For more details, see the vendor-specific documentation:
111+
112+
- Red Hat: https://access.redhat.com/solutions/6989907

0 commit comments

Comments
 (0)