Skip to content

Commit 223f234

Browse files
Update dotnet-gcdump.md (#46547)
1 parent bed1d8e commit 223f234

File tree

1 file changed

+7
-3
lines changed

1 file changed

+7
-3
lines changed

docs/core/diagnostics/dotnet-gcdump.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: dotnet-gcdump diagnostic tool - .NET CLI
33
description: Learn how to install and use dotnet-gcdump CLI tool to collect GC (Garbage Collector) dumps of live .NET processes using the .NET EventPipe.
4-
ms.date: 11/17/2020
4+
ms.date: 06/03/2025
55
ms.topic: reference
66
---
77
# Heap analysis tool (dotnet-gcdump)
88

9-
**This article applies to:** ✔️ `dotnet-gcdump` version 3.1.57502 and later versions
9+
**This article applies to:** ✔️ `dotnet-gcdump` version 10.0 and later versions
1010

1111
## Install
1212

@@ -80,7 +80,7 @@ Collects a GC dump from a currently running process.
8080
### Synopsis
8181

8282
```console
83-
dotnet-gcdump collect [-h|--help] [-p|--process-id <pid>] [-o|--output <gcdump-file-path>] [-v|--verbose] [-t|--timeout <timeout>] [-n|--name <name>]
83+
dotnet-gcdump collect [-h|--help] [-p|--process-id <pid>] [-o|--output <gcdump-file-path>] [-v|--verbose] [-t|--timeout <timeout>] [-n|--name <name>] [--dsrouter <ios|ios-sim|android|android-emu>]
8484
```
8585

8686
### Options
@@ -127,6 +127,10 @@ dotnet-gcdump collect [-h|--help] [-p|--process-id <pid>] [-o|--output <gcdump-f
127127

128128
By default, dotnet-gcdump listens at the specified address. You can request dotnet-gcdump to connect instead by appending `,connect` after the address. For example, `--diagnostic-port /foo/tool1.socket,connect` will connect to a .NET runtime process that's listening to the `/foo/tool1.socket` Unix domain socket.
129129

130+
- **`--dsrouter {ios|ios-sim|android|android-emu}**
131+
132+
Starts [dotnet-dsrouter](dotnet-dsrouter.md) and connects to it. Requires [dotnet-dsrouter](dotnet-dsrouter.md) to be installed. Run `dotnet-dsrouter -h` for more information.
133+
130134
> [!NOTE]
131135
> To collect a GC dump using `dotnet-gcdump`, it needs to be run as the same user as the user running target process or as root. Otherwise, the tool will fail to establish a connection with the target process.
132136

0 commit comments

Comments
 (0)