diff --git a/docs/core/diagnostics/collect-dumps-crash.md b/docs/core/diagnostics/collect-dumps-crash.md index 49dcca8067b26..01745d3c90c9d 100644 --- a/docs/core/diagnostics/collect-dumps-crash.md +++ b/docs/core/diagnostics/collect-dumps-crash.md @@ -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 | diff --git a/docs/core/diagnostics/dumps.md b/docs/core/diagnostics/dumps.md index f2cac8c0d625a..bc1f9f4b3a6b2 100644 --- a/docs/core/diagnostics/dumps.md +++ b/docs/core/diagnostics/dumps.md @@ -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. diff --git a/docs/core/diagnostics/faq-dumps.yml b/docs/core/diagnostics/faq-dumps.yml index cf43a4a1b45ed..2865dcc51c3a3 100644 --- a/docs/core/diagnostics/faq-dumps.yml +++ b/docs/core/diagnostics/faq-dumps.yml @@ -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: |