Skip to content

Commit 4936a8c

Browse files
authored
Preview5 doc update. (#225) (#226)
Add Release notes for dotnet-dump. Remove --add-source in installation instructions.
1 parent e0f78e4 commit 4936a8c

4 files changed

+13
-5
lines changed

documentation/dotnet-dump-instructions.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ The dotnet-dump CLI global tool is way to collect and analyze Windows and Linux
77

88
The first step is to install the dotnet-dump CLI global tool. This requires the 2.1 .NET Core SDK to be installed. If you see the error message `Tool 'dotnet-dump' is already installed`, you will need to uninstall the global tool (see below).
99

10-
$ dotnet tool install -g dotnet-dump --version 1.0.3-preview5.19228.1 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
10+
$ dotnet tool install -g dotnet-dump --version 1.0.3-preview5.19228.1
1111
You can invoke the tool using the following command: dotnet-dump
1212
Tool 'dotnet-dump' (version '1.0.3-preview5.19228.1') was successfully installed.
1313

@@ -109,3 +109,11 @@ To display the help:
109109

110110
$ dotnet tool uninstall -g dotnet-dump
111111
Tool 'dotnet-dump' (version '1.0.3-preview5.19228.1') was successfully uninstalled.
112+
113+
## Release Notes
114+
115+
Preview5
116+
117+
* dotnet-dump does not work on alpine and other MUSL based distros. Issue [#195](https://github.com/dotnet/diagnostics/issues/195).
118+
* dotnet-dump collect requires SYS\_PTRACE docker capabilities (--cap-add=SYS\_PTRACE or --privileged).
119+
* dotnet-dump analyze in Microsoft SDK docker images throws `Unhandled exception: System.DllNotFoundException: Unable to load shared library 'libdl.so' or one of its dependencies` exception. Issue [#201](https://github.com/dotnet/diagnostics/issues/201).

documentation/dotnet-trace-instructions.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ The dotnet-trace tool is a cross-platform CLI global tool that enables the colle
77
The first step is to install the dotnet-trace CLI global tool. This requires at least version 2.1 of the SDK to be installed.
88

99
```cmd
10-
$ dotnet tool install --global dotnet-trace --version 1.0.3-preview5.19228.1 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
10+
$ dotnet tool install --global dotnet-trace --version 1.0.3-preview5.19228.1
1111
You can invoke the tool using the following command: dotnet-trace
1212
Tool 'dotnet-trace' (version '1.0.3-preview5.19228.1') was successfully installed.
1313
```

documentation/installing-sos-instructions.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Installing SOS on Linux and MacOS
33

44
The first step is to install the dotnet-sos CLI global tool. This requires the 2.1 .NET Core SDK to be installed. If you see the error message `Tool 'dotnet-sos' is already installed`, you will need to uninstall the global tool (see below).
55

6-
$ dotnet tool install -g dotnet-sos --version 1.0.3-preview5.19228.1 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
6+
$ dotnet tool install -g dotnet-sos --version 1.0.3-preview5.19228.1
77
You can invoke the tool using the following command: dotnet-sos
88
Tool 'dotnet-sos' (version '1.0.3-preview5.19228.1') was successfully installed.
99

documentation/installing-sos-windows-instructions.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ SOS will automatically be loaded from the internal Microsoft extension gallery.
4747

4848
It is recommended that you update to the newer versions of the Windows debugger, but you can still use the latest SOS with older Windows debuggers by using the dotnet-sos CLI global tool to install. It is not as convenient. You may have to ".unload" the SOS that is loaded from the "runtime" directory.
4949

50-
C:\Users\mikem>dotnet tool install -g dotnet-sos --version 1.0.3-preview5.19228.1 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
50+
C:\Users\mikem>dotnet tool install -g dotnet-sos --version 1.0.3-preview5.19228.1
5151
You can invoke the tool using the following command: dotnet-sos
5252
Tool 'dotnet-sos' (version '1.0.3-preview5.19228.1') was successfully installed.
5353

@@ -90,4 +90,4 @@ SOS will need to be loaded manually with the above ".load" command:
9090
[path: C:\Program Files\Debugging Tools for Windows (x64)\dbghelp.dll]
9191
...
9292
ntsdexts: image 10.0.18317.1001, API 1.0.0,
93-
[path: C:\Program Files\Debugging Tools for Windows (x64)\WINXP\ntsdexts.dll]
93+
[path: C:\Program Files\Debugging Tools for Windows (x64)\WINXP\ntsdexts.dll]

0 commit comments

Comments
 (0)