Skip to content

Document that dump collection isn't supported on mobile platforms #51765

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
meaghanlewis merged 1 commit into from
Feb 19, 2026
Merged

Document that dump collection isn't supported on mobile platforms #51765

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/core/diagnostics/collect-dumps-crash.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,9 @@ ms.date: 12/13/2022

Configuring your application to collect a dump on crash is done by setting specific environment variables. This is helpful when you want to get an understanding of why a crash happened. For example, capturing a dump when an exception is thrown helps you identify an issue by examining the state of the app when it crashed.

> [!NOTE]
> Dump collection isn't supported on mobile platforms (Android and iOS).

The following table shows the environment variables you can configure for collecting dumps on a crash.

| Environment variable | Description | Default value |
Expand Down
3 changes: 3 additions & 0 deletions docs/core/diagnostics/dumps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,9 @@ A dump is a file that contains a snapshot of the process at the time the dump wa

Dumps can be collected in a variety of ways depending on which platform your app is running on.

> [!NOTE]
> Dump collection isn't supported on mobile platforms (Android and iOS). The Mono runtime used on these platforms doesn't support memory dump generation.

> [!NOTE]
> Dumps might contain sensitive information because they can contain the full memory of the running process. Handle them with any security restrictions and guidance in mind.

Expand Down
5 changes: 5 additions & 0 deletions docs/core/diagnostics/faq-dumps.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,11 @@ sections:
answer: |
On macOS the use of `ptrace` requires the host of the target process to be properly entitled. For information about the minimum required entitlements, see [Default entitlements](../install/macos-notarization-issues.md#default-entitlements).

- question: |
Why can't I collect dumps on Android or iOS?
answer: |
Dump collection isn't supported on mobile platforms (Android and iOS). These platforms use the Mono runtime, which doesn't support memory dump generation.

- question: |
Where can I learn more about how I can leverage dumps to help diagnose problems in my .NET application?
answer: |
Expand Down
Loading