summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMike McLaughlin <mikem@microsoft.com>2018-03-21 15:43:15 -0700
committerGitHub <noreply@github.com>2018-03-21 15:43:15 -0700
commit08224572d6d2dd20d599bcf7725b4516eea2d5b9 (patch)
treeba67921e48ae8d6e8a6076e2185ceef824c65310
parent06be68e39634b0fa6490a2d500912e83dc78ed1e (diff)
downloadcoreclr-08224572d6d2dd20d599bcf7725b4516eea2d5b9.tar.gz
coreclr-08224572d6d2dd20d599bcf7725b4516eea2d5b9.tar.bz2
coreclr-08224572d6d2dd20d599bcf7725b4516eea2d5b9.zip
Update debugging doc on lldb versions and disabling managed debugging (#17107)
-rw-r--r--Documentation/building/debugging-instructions.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/Documentation/building/debugging-instructions.md b/Documentation/building/debugging-instructions.md
index 84059dfb24..0b98b8fcea 100644
--- a/Documentation/building/debugging-instructions.md
+++ b/Documentation/building/debugging-instructions.md
@@ -52,6 +52,8 @@ You can combine steps 4-8 and pass everything on the lldb command line:
`lldb-3.9 -o "plugin load libsosplugin.so" -o "process launch -s" -o "process handle -s false SIGUSR1 SIGUSR2" -o "breakpoint set -n LoadLibraryExW" corerun HelloWorld.exe linux`
+For .NET Core version 1.x and 2.0.x, libsosplugin.so is built for and will only work with version 3.6 of lldb. For .NET Core 2.1, the plugin is built for 3.9 lldb and will work with 3.8 and 3.9 lldb.
+
### SOS commands ###
This is the full list of commands currently supported by SOS. lldb is case-sensitive unlike windbg.
@@ -164,6 +166,13 @@ lldb should start debugging successfully at this point. You should see stacktrac
```
lldb-3.9 -O "settings set target.exec-search-paths /home/parallels/Downloads/System.Drawing.Common.Tests/home/helixbot/dotnetbuild/work/2a74cf82-3018-4e08-9e9a-744bb492869e/Payload/shared/Microsoft.NETCore.App/9.9.9/" -o "plugin load /home/parallels/Downloads/System.Drawing.Common.Tests/home/helixbot/dotnetbuild/work/2a74cf82-3018-4e08-9e9a-744bb492869e/Payload/shared/Microsoft.NETCore.App/9.9.9/libsosplugin.so" --core /home/parallels/Downloads/System.Drawing.Common.Tests/home/helixbot/dotnetbuild/work/2a74cf82-3018-4e08-9e9a-744bb492869e/Work/f6414a62-9b41-4144-baed-756321e3e075/Unzip/core /home/parallels/Downloads/System.Drawing.Common.Tests/home/helixbot/dotnetbuild/work/2a74cf82-3018-4e08-9e9a-744bb492869e/Payload/shared/Microsoft.NETCore.App/9.9.9/dotnet
```
+Disabling Managed Attach/Debugging
+==================================
+
+The "COMPlus_EnableDiagnostics" environment variable can be used to disable managed debugging. This prevents the various OS artifacts used for debugging like the named pipes and semaphores on Linux/MacOS and shared memory on Windows from being created.
+
+ export COMPlus_EnableDiagnostics=0
+
Using Visual Studio Code
========================