From: Mike McLaughlin Date: Wed, 17 Apr 2019 16:39:54 +0000 (-0700) Subject: Update global tool versions in docs. X-Git-Tag: submit/tizen/20190813.035844~33^2 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=64747c683f30018cc1d2caa628631535f56052f0;p=platform%2Fcore%2Fdotnet%2Fdiagnostics.git Update global tool versions in docs. --- diff --git a/documentation/dotnet-dump-instructions.md b/documentation/dotnet-dump-instructions.md index b3ecca491..a936851a1 100644 --- a/documentation/dotnet-dump-instructions.md +++ b/documentation/dotnet-dump-instructions.md @@ -5,11 +5,11 @@ The dotnet-dump CLI global tool is way to collect and analyze Windows and Linux ## Installing dotnet-dump -The first step is to install the dotnet-dump CLI global tool. This requires the 2.1 .NET Core SDK to be installed. +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). - $ dotnet tool install -g dotnet-dump --version 1.0.2-preview3.19170.2 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json + $ dotnet tool install -g dotnet-dump --version 1.0.3-preview5.19217.3 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json You can invoke the tool using the following command: dotnet-dump - Tool 'dotnet-dump' (version '1.0.2-preview3.19170.2') was successfully installed. + Tool 'dotnet-dump' (version '1.0.3-preview5.19217.3') was successfully installed. ## Using dotnet-dump @@ -104,3 +104,8 @@ To display the help: histroot Displays information related to both promotions and relocations of the specified root. setsymbolserver Enables the symbol server support soshelp Displays all available commands when no parameter is specified, or displays detailed help information about the specified command. soshelp + +## Uninstalling dotnet-dump + + $ dotnet tool uninstall -g dotnet-dump + Tool 'dotnet-dump' (version '1.0.3-preview5.19217.3') was successfully uninstalled. \ No newline at end of file diff --git a/documentation/installing-sos-instructions.md b/documentation/installing-sos-instructions.md index 9e9f8ef97..c6474860b 100644 --- a/documentation/installing-sos-instructions.md +++ b/documentation/installing-sos-instructions.md @@ -1,16 +1,18 @@ Installing SOS on Linux and MacOS ================================= -The first step is to install the dotnet-sos CLI global tool. This requires the 2.1 .NET Core SDK to be installed. +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). - $ dotnet tool install -g dotnet-sos --version 1.0.2-preview3.19170.2 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json + $ dotnet tool install -g dotnet-sos --version 1.0.3-preview5.19217.3 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json You can invoke the tool using the following command: dotnet-sos - Tool 'dotnet-sos' (version '1.0.2-preview3.19170.2') was successfully installed. + Tool 'dotnet-sos' (version '1.0.3-preview5.19217.3') was successfully installed. + + The next step is use this global tool to install SOS. $ dotnet sos install - Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/1.0.2-preview3.19170.2/dotnet-sos/1.0.2-preview3.19170.2/tools/netcoreapp2.1/any/linux-x64 + Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/1.0.3-preview5.19217.3/dotnet-sos/1.0.3-preview5.19217.3/tools/netcoreapp2.1/any/linux-x64 Creating installation directory... Copying files... Updating existing /home/mikem/.lldbinit file - LLDB will load SOS automatically at startup @@ -72,7 +74,7 @@ Now any time you run lldb, SOS will automatically be loaded and the symbol downl The installer needs to be run again: $ dotnet sos install - Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/1.0.2-preview3.19170.2/dotnet-sos/1.0.2-preview3.19170.2/tools/netcoreapp2.1/any/linux-x64 + Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/1.0.3-preview5.19217.3/dotnet-sos/1.0.3-preview5.19217.3/tools/netcoreapp2.1/any/linux-x64 Installing over existing installation... Creating installation directory... Copying files... @@ -89,7 +91,7 @@ To uninstall and remove the lldb configuration run this command: Reverting /home/mikem/.lldbinit file - LLDB will no longer load SOS at startup SOS uninstall succeeded -To remove the SOS installer global tool (optional): +To remove the SOS installer global tool: $ dotnet tool uninstall -g dotnet-sos - Tool 'dotnet-sos' (version '1.0.2-preview3.19170.2') was successfully uninstalled. + Tool 'dotnet-sos' (version '1.0.3-preview5.19217.3') was successfully uninstalled. diff --git a/documentation/installing-sos-windows-instructions.md b/documentation/installing-sos-windows-instructions.md index 67866433e..2576768d0 100644 --- a/documentation/installing-sos-windows-instructions.md +++ b/documentation/installing-sos-windows-instructions.md @@ -47,14 +47,14 @@ SOS will automatically be loaded from the internal Microsoft extension gallery. 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. - C:\Users\mikem>dotnet tool install -g dotnet-sos --version 1.0.2-preview3.19170.2 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json + C:\Users\mikem>dotnet tool install -g dotnet-sos --version 1.0.3-preview5.19217.3 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json You can invoke the tool using the following command: dotnet-sos - Tool 'dotnet-sos' (version '1.0.2-preview3.19170.2') was successfully installed. + Tool 'dotnet-sos' (version '1.0.3-preview5.19217.3') was successfully installed. Run the installer: C:\Users\mikem>dotnet sos install - Installing SOS to C:\Users\mikem\.dotnet\sos from C:\Users\mikem\.dotnet\tools\.store\dotnet-sos\1.0.2-preview3.19170.2\dotnet-sos\1.0.2-preview3.19170.2\tools\netcoreapp2.1\any\win-x64 + Installing SOS to C:\Users\mikem\.dotnet\sos from C:\Users\mikem\.dotnet\tools\.store\dotnet-sos\1.0.3-preview5.19217.3\dotnet-sos\1.0.3-preview5.19217.3\tools\netcoreapp2.1\any\win-x64 Creating installation directory... Copying files... Execute '.load C:\Users\mikem\.dotnet\sos\sos.dll' to load SOS in your Windows debugger.