* [MacOS Instructions](documentation/building/osx-instructions.md)
* [FreeBSD Instructions](documentation/building/freebsd-instructions.md)
* [NetBSD Instructions](documentation/building/netbsd-instructions.md)
+ * [Testing on private runtime builds](documentation/privatebuildtesting.md)
-## Getting lldb
-
-Getting a version of lldb that works for your platform can be a problem sometimes. The version has to be at least 3.9 or greater because of a bug running SOS on a core dump that was fixed. Some Linux distros like Ubuntu it is easy as `sudo apt-get install lldb-3.9 python-lldb-3.9`. On other distros, you will need to build lldb. The directions below should give you some guidance.
-
-* [Linux Instructions](documentation/lldb/linux-instructions.md)
-* [MacOS Instructions](documentation/lldb/osx-instructions.md)
-* [FreeBSD Instructions](documentation/lldb/freebsd-instructions.md)
-* [NetBSD Instructions](documentation/lldb/netbsd-instructions.md)
-
-## Installing SOS
-
-* [Linux and MacOS Instructions](documentation/installing-sos-instructions.md)
-* [Windows Instructions](documentation/installing-sos-windows-instructions.md)
-
-## Using SOS
-
-* [SOS debugging for Linux/MacOS](documentation/sos-debugging-extension.md)
-* [SOS debugging for Windows](documentation/sos-debugging-extension-windows.md)
-* [Debugging a core dump](documentation/debugging-coredump.md)
-
-## Tools
+## SOS and Other Diagnostic Tools
+* [SOS](documentation/sos.md) - About the SOS debugger extension.
* [dotnet-dump](documentation/dotnet-dump-instructions.md) - Dump collection and analysis utility.
* [dotnet-trace](documentation/dotnet-trace-instructions.md) - Enable the collection of events for a running .NET Core Application to a local trace file.
* [dotnet-counters](documentation/dotnet-counters-instructions.md) - Monitor performance counters of a .NET Core application in real time.
-## New Features
-
-The `bpmd` command can now be used before the runtime is loaded. You can load SOS or the sos plugin on Linux and execute bpmd. Always add the module extension for the first parameter.
-
- bpmd SymbolTestApp.dll SymbolTestApp.Program.Main
-
-You can set a source file/line number breakpoint like this (the fully qualified source file path is usually not necessary):
-
- bpmd SymbolTestApp.cs:24
-
-Symbol server support - The `setsymbolserver` command enables downloading the symbol files (portable PDBs) for managed assemblies during commands like `clrstack`, etc. See `soshelp setsymbolserver` for more details.
-
- (lldb) setsymbolserver -ms
-
-Before executing the "bt" command to dump native frames to load the native symbols (for live debugging only):
-
- (lldb) loadsymbols
-
-To add a local directory to search for symbols:
-
- (lldb) setsymbolserver -directory /tmp/symbols
-
## Useful Links
* [FAQ](documentation/FAQ.md) - Frequently asked questions.
* [The LLDB Debugger](http://lldb.llvm.org/index.html) - More information about lldb.
* [SOS](https://msdn.microsoft.com/en-us/library/bb190764(v=vs.110).aspx) - More information about SOS.
-* [Debugging CoreCLR](https://github.com/dotnet/coreclr/blob/master/Documentation/building/debugging-instructions.md) - Instructions for debugging .NET Core and the CoreCLR runtime.
-* [dotnet/coreclr](https://github.com/dotnet/coreclr) - Source for the .NET Core runtime.
+* [Debugging CoreCLR](https://github.com/dotnet/runtime/blob/master/docs/workflow/debugging/coreclr/debugging.md) - Instructions for debugging .NET Core and the CoreCLR runtime.
+* [dotnet/runtime](https://github.com/dotnet/runtime) - Source for the .NET Core runtime.
* [Official Build Instructions](documentation/building/official-build-instructions.md) - Internal official build instructions.
[//]: # (Begin current test results)
--- /dev/null
+Private runtime build testing
+=============================
+
+Here are some instructions on how to run the diagnostics repo's tests against a locally build private .NET Core runtime. These directions will work on Windows, Linux and MacOS.
+
+1. Build the runtime repo (see [Workflow Guide](https://github.com/dotnet/runtime/blob/master/docs/workflow/README.md)).
+2. Build the diagnostics repo (see [Building the Repository](../README.md)).
+3. Run the diagnostics repo tests with the -privatebuildpath option.
+
+On Windows:
+```
+C:\diagnostics> test -privatebuildpath c:\runtime\artifacts\bin\coreclr\Windows_NT.x64.Debug
+```
+
+When you are all done with the private runtime testing, run this command to remove the Windows registry entries added in the above steps.
+
+```
+C:\diagnostics> test -cleanupprivatebuild
+```
+
+There will be some popups from regedit asking for administrator permission to edit the registry (press Yes), warning about adding registry keys from AddPrivateTesting.reg (press Yes) and that the edit was successful (press OK).
+
+On Linux/MacOS:
+```
+~/diagnostics$ ./test.sh --privatebuildpath /home/user/runtime/artifacts/bin/coreclr/Linux.x64.Debug
+```
+The private runtime will be copied to the diagnostics repo and the tests started. It can be just the coreclr binaries but this assumes that the private build is close to the latest published master build. If not, you can pass the runtime's testhost directory containing all the shared runtime bits i.e. `c:\runtime\artifacts\bin\testhost\netcoreapp5.0-Windows_NT-Debug-x64\shared\Microsoft.NETCore.App\5.0.0` or `/home/user/runtime/artifacts/bin/testhost/netcoreapp5.0-Linux-Release-x64/shared/Microsoft.NETCore.App/5.0.0`
+
+On Linux/MacOS it is recommended to test against Release runtime builds because of a benign assert in DAC (tracked by issue #[31897](https://github.com/dotnet/runtime/issues/31897)) that causes the tests to fail.
+
+On Windows the DAC is not properly signed for a private runtime build so there are a couple of registry keys that need to be added so Windows will load the DAC and the tests can create proper mini-dumps. An example of the registry key values added are:
+
+```
+[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\KnownManagedDebuggingDlls]
+"C:\diagnostics\.dotnet\shared\Microsoft.NETCore.App\5.0.0-alpha.1.20102.3\mscordaccore.dll"=dword:0
+
+[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\MiniDumpAuxiliaryDlls]
+"C:\diagnostics\.dotnet\shared\Microsoft.NETCore.App\5.0.0-alpha.1.20102.3\coreclr.dll"="C:\diagnostics\.dotnet\shared\Microsoft.NETCore.App\5.0.0-alpha.1.20102.3\mscordaccore.dll"
+```
\ No newline at end of file
--- /dev/null
+SOS
+===
+
+SOS is a debugger extension that allows a developer to inspect the managed state of a .NET Core and desktop runtime process. SOS can be loaded by WinDbg/cdb debuggers on Windows and lldb on Linux and MacOS.
+
+## Getting lldb
+
+Getting a version of lldb that works for your platform can be a problem sometimes. The version has to be at least 3.9 or greater because of a bug running SOS on a core dump that was fixed. Some Linux distros like Ubuntu it is easy as `sudo apt-get install lldb-3.9 python-lldb-3.9`. On other distros, you will need to build lldb. The directions below should give you some guidance.
+
+* [Linux Instructions](lldb/linux-instructions.md)
+* [MacOS Instructions](lldb/osx-instructions.md)
+* [FreeBSD Instructions](lldb/freebsd-instructions.md)
+* [NetBSD Instructions](lldb/netbsd-instructions.md)
+
+## Installing SOS
+
+* [Linux and MacOS Instructions](installing-sos-instructions.md)
+* [Windows Instructions](installing-sos-windows-instructions.md)
+
+## Using SOS
+
+* [SOS debugging for Linux/MacOS](sos-debugging-extension.md)
+* [SOS debugging for Windows](sos-debugging-extension-windows.md)
+* [Debugging a core dump](debugging-coredump.md)
+
+## New SOS Features
+
+The `bpmd` command can now be used before the runtime is loaded. You can load SOS or the sos plugin on Linux and execute bpmd. Always add the module extension for the first parameter.
+
+ bpmd SymbolTestApp.dll SymbolTestApp.Program.Main
+
+You can set a source file/line number breakpoint like this (the fully qualified source file path is usually not necessary):
+
+ bpmd SymbolTestApp.cs:24
+
+Symbol server support - The `setsymbolserver` command enables downloading the symbol files (portable PDBs) for managed assemblies during commands like `clrstack`, etc. See `soshelp setsymbolserver` for more details.
+
+ (lldb) setsymbolserver -ms
+
+Before executing the "bt" command to dump native frames to load the native symbols (for live debugging only):
+
+ (lldb) loadsymbols
+
+To add a local directory to search for symbols:
+
+ (lldb) setsymbolserver -directory /tmp/symbols
--- /dev/null
+<Project Sdk="Microsoft.NET.Sdk">
+ <PropertyGroup>
+ <TargetFramework>netcoreapp2.0</TargetFramework>
+ </PropertyGroup>
+
+ <Import Project="$(RepositoryEngineeringDir)\InstallRuntimes.proj" />
+</Project>
+
+<!-- All Rights Reserved. Licensed to the .NET Foundation under one or more agreements. The .NET Foundation licenses this file to you under the MIT license. See the LICENSE file in the project root for more information. -->
<Project>
<!--
$(BuildArch) - architecture to test (x64, x86, arm, arm64). Defaults to x64.
$(DailyTest) - if true, only install/test the latest (master branch) runtime
+ $(PrivateBuildPath) - if non-empty, path to private runtime build to copy/test
From Versions.props:
<DailyTest Condition="'$(DailyTest)' == ''">false</DailyTest>
<BuildArch Condition="'$(BuildArch)' == ''">$(Platform)</BuildArch>
<BuildArch Condition="'$(BuildArch)' == ''">x64</BuildArch>
+ </PropertyGroup>
+
+ <PropertyGroup Condition="'$(BuildArch)' != 'x86'">
+ <DotNetInstallRoot>$(DotNetRoot)</DotNetInstallRoot>
+ <RegistryRoot>HKEY_LOCAL_MACHINE\SOFTWARE</RegistryRoot>
+ </PropertyGroup>
+
+ <PropertyGroup Condition="'$(BuildArch)' == 'x86'">
+ <DotNetInstallRoot>$(DotNetRoot)x86\</DotNetInstallRoot>
+ <RegistryRoot>HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node</RegistryRoot>
+ </PropertyGroup>
+
+ <PropertyGroup>
<CommonInstallArgs>-architecture $(BuildArch)</CommonInstallArgs>
- <TestConfigFileName Condition="'$(BuildArch)' != 'x86'">$(DotNetRoot)Debugger.Tests.Versions.txt</TestConfigFileName>
- <TestConfigFileName Condition="'$(BuildArch)' == 'x86'">$(DotNetRoot)x86\Debugger.Tests.Versions.txt</TestConfigFileName>
+ <DotNetInstallDir>$(DotNetInstallRoot.Replace("\", "\\"))shared\\Microsoft.NETCore.App\\$(MicrosoftNETCoreAppVersion)\\</DotNetInstallDir>
+ <TestConfigFileName>$(DotNetInstallRoot)Debugger.Tests.Versions.txt</TestConfigFileName>
+ <AddRegeditFileName>$(DotNetInstallRoot)AddPrivateTesting.reg</AddRegeditFileName>
+ <RemoveRegeditFileName>$(DotNetInstallRoot)RemovePrivateTesting.reg</RemoveRegeditFileName>
+ <RegeditCommand>regedit.exe</RegeditCommand>
</PropertyGroup>
<Choose>
<TestVersions Include="Latest" RuntimeVersion="$(MicrosoftNETCoreAppVersion)" AspNetVersion="$(MicrosoftAspNetCoreAppRefVersion)" Install="true" />
<TestVersions Include="31" RuntimeVersion="$(MicrosoftNETCoreApp31Version)" AspNetVersion="$(MicrosoftAspNetCoreApp31Version)" Install="!$(DailyTest)" />
<TestVersions Include="30" RuntimeVersion="$(MicrosoftNETCoreApp30Version)" AspNetVersion="$(MicrosoftAspNetCoreApp30Version)" Install="!$(DailyTest)" />
- <TestVersions Include="21" RuntimeVersion="$(MicrosoftNETCoreApp21Version)" AspNetVersion="$(MicrosoftAspNetCoreApp21Version)" Install="!$(DailyTest)" />
+ <TestVersions Include="21" RuntimeVersion="$(MicrosoftNETCoreApp21Version)" AspNetVersion="$(MicrosoftAspNetCoreApp21Version)" Install="true" />
</ItemGroup>
+<!--
+ Installs the runtimes for the SOS tests, handles private runtime build support or cleans up the private build registry keys
+-->
+
<Target Name="InstallTestRuntimes"
BeforeTargets="RunTests"
- DependsOnTargets="InstallRuntimesWindows;InstallRuntimesUnix;WriteTestVersionManifest" />
+ DependsOnTargets="InstallRuntimesWindows;InstallRuntimesUnix;WriteTestVersionManifest;TestPrivateBuild" />
+
+<!--
+ Installs the test runtimes on Windows
+-->
<Target Name="InstallRuntimesWindows"
Condition="$([MSBuild]::IsOsPlatform(Windows))"
Condition="%(TestVersions.Install)" />
</Target>
+<!--
+ Installs the test runtimes on Linux/MacOS
+-->
+
<Target Name="InstallRuntimesUnix"
Condition="!$([MSBuild]::IsOsPlatform(Windows))"
Inputs="$(VersionsPropsPath)" Outputs="$(TestConfigFileName)">
Condition="%(TestVersions.Install)" />
</Target>
- <Target Name="WriteTestVersionManifest" Inputs="$(VersionsPropsPath)" Outputs="$(TestConfigFileName)">
+<!--
+ Writes the Debugger.Tests.Versions.txt file used by the SOS test harness
+-->
+
+ <Target Name="WriteTestVersionManifest"
+ Inputs="$(VersionsPropsPath)"
+ Outputs="$(TestConfigFileName)">
+
<PropertyGroup>
<TestConfigFileLines>
<![CDATA[
<AspNetCoreVersionLatest>$(MicrosoftAspNetCoreAppRefVersion)</AspNetCoreVersionLatest>
</Configuration>
]]>
- </TestConfigFileLines>
+ </TestConfigFileLines>
</PropertyGroup>
<WriteLinesToFile File="$(TestConfigFileName)" Lines="$(TestConfigFileLines)" Overwrite="true" WriteOnlyWhenDifferent="true" />
+
<Message Importance="High" Text="Created config file $(TestConfigFileName)" />
<ItemGroup>
<FileWrites Include="$(TestConfigFileName)" />
</ItemGroup>
</Target>
+
+<!--
+ Copies the private runtime build binaries and on Windows adds registry keys
+-->
+
+ <Target Name="TestPrivateBuild"
+ Condition="'$(PrivateBuildPath)' != ''"
+ DependsOnTargets="ModifyRegistry">
+
+ <ItemGroup>
+ <PrivateBuildFiles Include="$(PrivateBuildPath)\*" />
+ </ItemGroup>
+
+ <Message Importance="High" Text="Copying private build binaries from $(PrivateBuildPath) to $(DotNetInstallDir.Replace('\\', '\'))" />
+
+ <Copy SourceFiles="@(PrivateBuildFiles)" DestinationFolder="$(DotNetInstallDir.Replace('\\', '\'))" />
+ </Target>
+
+<!--
+ Removes the private build registry keys
+-->
+
+ <Target Name="CleanupPrivateBuild"
+ Condition="Exists($(RemoveRegeditFileName))">
+
+ <Exec Command="$(RegeditCommand) $(RemoveRegeditFileName)" />
+ <!--
+ Delete only the AddRegeditFileName so the target ModifyRegistry will run on next
+ build. Leaving the remove reg key file so this target can be run multiple times.
+ -->
+ <Delete Files="$(AddRegeditFileName)" />
+ </Target>
+
+<!--
+ On Windows adds the registry keys to allow the unsigned private build DAC to generate dumps
+-->
+
+ <Target Name="ModifyRegistry"
+ Condition="$([MSBuild]::IsOsPlatform(Windows))"
+ DependsOnTargets="CreateRemoveRegFile"
+ Inputs="$(VersionsPropsPath)"
+ Outputs="$(AddRegeditFileName)">
+
+ <PropertyGroup>
+ <AddRegeditFileLines>
+<![CDATA[
+Windows Registry Editor Version 5.00
+
+[$(RegistryRoot)\Microsoft\Windows NT\CurrentVersion\KnownManagedDebuggingDlls]
+"$(DotNetInstallDir)mscordaccore.dll"=dword:0
+
+[$(RegistryRoot)\Microsoft\Windows NT\CurrentVersion\MiniDumpAuxiliaryDlls]
+"$(DotNetInstallDir)coreclr.dll"="$(DotNetInstallDir)mscordaccore.dll"
+]]>
+ </AddRegeditFileLines>
+ </PropertyGroup>
+
+ <WriteLinesToFile File="$(AddRegeditFileName)" Lines="$(AddRegeditFileLines)" Overwrite="true" WriteOnlyWhenDifferent="true" />
+
+ <ItemGroup>
+ <FileWrites Include="$(AddRegeditFileName)" />
+ </ItemGroup>
+
+ <Exec Command="$(RegeditCommand) $(AddRegeditFileName)" />
+ </Target>
+
+<!--
+ Creates the reg file to remove the registry keys added in ModifyRegistry
+-->
+
+ <Target Name="CreateRemoveRegFile">
+ <PropertyGroup>
+ <RemoveRegeditFileLines>
+<![CDATA[
+Windows Registry Editor Version 5.00
+
+[$(RegistryRoot)\Microsoft\Windows NT\CurrentVersion\KnownManagedDebuggingDlls]
+"$(DotNetInstallDir)mscordaccore.dll"=-
+
+[$(RegistryRoot)\Microsoft\Windows NT\CurrentVersion\MiniDumpAuxiliaryDlls]
+"$(DotNetInstallDir)coreclr.dll"=-
+]]>
+ </RemoveRegeditFileLines>
+ </PropertyGroup>
+
+ <WriteLinesToFile File="$(RemoveRegeditFileName)" Lines="$(RemoveRegeditFileLines)" Overwrite="true" WriteOnlyWhenDifferent="true" />
+
+ <ItemGroup>
+ <FileWrites Include="$(RemoveRegeditFileName)" />
+ </ItemGroup>
+ </Target>
+
</Project>
[switch] $skipmanaged,
[switch] $skipnative,
[switch] $dailytest,
+ [string] $privatebuildpath = "",
+ [switch] $cleanupprivatebuild,
[Parameter(ValueFromRemainingArguments=$true)][String[]] $remainingargs
)
$artifactsdir = Join-Path $reporoot "artifacts"
$logdir = Join-Path $artifactsdir "log"
$logdir = Join-Path $logdir Windows_NT.$architecture.$configuration
+$dailytestproperty = "false"
if ($ci) {
$remainingargs = "-ci " + $remainingargs
}
+if ($dailytest -or $privatebuildpath -ne "") {
+ $dailytestproperty = "true"
+}
+
+# Remove the private build registry keys
+if ($cleanupprivatebuild) {
+ Invoke-Expression "& `"$engroot\common\msbuild.ps1`" $engroot\CleanupPrivateBuild.csproj /v:$verbosity /t:CleanupPrivateBuild /p:BuildArch=$architecture /p:TestArchitectures=$architecture"
+ exit $lastExitCode
+}
+
# Install sdk for building, restore and build managed components.
if (-not $skipmanaged) {
Invoke-Expression "& `"$engroot\common\build.ps1`" -build -binaryLog -configuration $configuration -verbosity $verbosity /p:BuildArch=$architecture /p:TestArchitectures=$architecture $remainingargs"
# Run the xunit tests
if ($test -or $dailytest) {
if (-not $crossbuild) {
- & "$engroot\common\build.ps1" -test -configuration $configuration -verbosity $verbosity -ci:$ci /bl:$logdir\Test.binlog /p:BuildArch=$architecture /p:TestArchitectures=$architecture /p:DailyTest=$dailyTest
+ & "$engroot\common\build.ps1" -test -configuration $configuration -verbosity $verbosity -ci:$ci /bl:$logdir\Test.binlog /p:BuildArch=$architecture /p:TestArchitectures=$architecture /p:DailyTest=$dailytestproperty /p:PrivateBuildPath=$privatebuildpath
if ($lastExitCode -ne 0) {
exit $lastExitCode
}
__CrossBuild=false
__Test=false
__DailyTest=false
+__PrivateBuildPath=""
__CI=false
__Verbosity=minimal
__ManagedBuildArgs=
echo "--skipnative - Skip building native components"
echo "--test - run xunit tests"
echo "--dailytest - test components for daily build job"
+ echo "--privatebuildpath - path to local private runtime build to test"
echo "--architecture <x64|x86|arm|armel|arm64>"
echo "--configuration <debug|release>"
echo "--rootfs <ROOTFS_DIR>"
__DailyTest=true
;;
+ -privatebuildpath)
+ __PrivateBuildPath=$2
+ __DailyTest=true
+ shift
+ ;;
+
-ci)
__CI=true
__ManagedBuildArgs="$__ManagedBuildArgs $1"
echo "lldb: '$LLDB_PATH' gdb: '$GDB_PATH'"
- "$__ProjectRoot/eng/common/build.sh" --test --configuration "$__BuildType" --verbosity "$__Verbosity" /bl:$__LogDir/Test.binlog /p:BuildArch=$__BuildArch /p:DailyTest=$__DailyTest $__TestArgs
+ "$__ProjectRoot/eng/common/build.sh" --test --configuration "$__BuildType" --verbosity "$__Verbosity" /bl:$__LogDir/Test.binlog /p:BuildArch=$__BuildArch /p:DailyTest=$__DailyTest /p:PrivateBuildPath=$__PrivateBuildPath $__TestArgs
if [ $? != 0 ]; then
exit 1
fi
<DumpDir>$(RootBinDir)\tmp\$(TargetConfiguration)\dumps</DumpDir>
<CDBPath>$(RootBinDir)\bin\SOS.UnitTests\$(TargetConfiguration)\netcoreapp2.0\publish\runtimes\win-$(TargetArchitecture)\native\cdb.exe</CDBPath>
<CDBHelperExtension>$(InstallDir)\runcommand.dll</CDBHelperExtension>
+
+ <DesktopFrameworkPath Condition="$(TargetArchitecture) == x64">$(WinDir)\Microsoft.Net\Framework64\v4.0.30319\</DesktopFrameworkPath>
+ <DesktopFrameworkPath Condition="$(TargetArchitecture) != x64">$(WinDir)\Microsoft.Net\Framework\v4.0.30319\</DesktopFrameworkPath>
<DesktopFramework>net462</DesktopFramework>
<DebuggeeSourceRoot>$(RepoRootDir)\src\SOS\SOS.UnitTests\Debuggees</DebuggeeSourceRoot>
<BuildProjectFramework>$(DesktopFramework)</BuildProjectFramework>
<BuildProjectRuntime>win-$(TargetArchitecture)</BuildProjectRuntime>
<DebugType>full</DebugType>
- <FrameworkDirPath Condition="$(TargetArchitecture) == x64">$(WinDir)\Microsoft.Net\Framework64\v4.0.30319\</FrameworkDirPath>
- <FrameworkDirPath Condition="$(TargetArchitecture) != x64">$(WinDir)\Microsoft.Net\Framework\v4.0.30319\</FrameworkDirPath>
- <RuntimeSymbolsPath>$(FrameworkDirPath)</RuntimeSymbolsPath>
+ <RuntimeSymbolsPath>$(DesktopFrameworkPath)</RuntimeSymbolsPath>
<SOSHostRuntime>$(DotNetRoot)\shared\Microsoft.NETCore.App\$(RuntimeVersion21)</SOSHostRuntime>
</Option>
</Options>
initialCommands.Add(".sympath %DEBUG_ROOT%");
initialCommands.Add(".extpath " + Path.GetDirectoryName(config.SOSPath()));
- // Add the path to runtime so cdb/sos can find mscordbi.
- string runtimeSymbolsPath = config.RuntimeSymbolsPath;
- if (runtimeSymbolsPath != null)
+ // Add the path to runtime so cdb/SOS can find DAC/DBI for triage dumps
+ if (information.DumpType == DumpType.Triage)
{
- initialCommands.Add(".sympath+ " + runtimeSymbolsPath);
+ string runtimeSymbolsPath = config.RuntimeSymbolsPath;
+ if (runtimeSymbolsPath != null)
+ {
+ initialCommands.Add(".sympath+ " + runtimeSymbolsPath);
+ }
}
// Turn off warnings that can happen in the middle of a command's output
initialCommands.Add(".outmask- 0x244");
}
initialCommands.Add("setsymbolserver -directory %DEBUG_ROOT%");
+ // Add the path to runtime so dotnet-dump/SOS can find DAC/DBI for triage dumps
+ if (information.DumpType == DumpType.Triage)
+ {
+ string runtimeSymbolsPath = config.RuntimeSymbolsPath;
+ if (runtimeSymbolsPath != null)
+ {
+ initialCommands.Add("setclrpath " + runtimeSymbolsPath);
+ }
+ }
arguments.Append(debuggerPath);
arguments.Append(@" analyze %DUMP_NAME%");
debuggerPath = config.DotNetDumpHost();
}
vars.Add("%DEBUG_ROOT%", debuggeeConfig.BinaryDirPath);
vars.Add("%SOS_PATH%", information.TestConfiguration.SOSPath());
+ vars.Add("%DESKTOP_RUNTIME_PATH%", information.TestConfiguration.DesktopRuntimePath());
// Can be used in an RegEx expression
vars.Add("<DEBUGGEE_EXE>", debuggeeExe.Replace(@"\", @"\\"));
return TestConfiguration.MakeCanonicalPath(config.GetValue("SOSHostRuntime"));
}
+ public static string DesktopRuntimePath(this TestConfiguration config)
+ {
+ return TestConfiguration.MakeCanonicalPath(config.GetValue("DesktopRuntimePath"));
+ }
+
public static bool GenerateDumpWithLLDB(this TestConfiguration config)
{
return config.GetValue("GenerateDumpWithLLDB")?.ToLowerInvariant() == "true";
SOSCOMMAND:SOSStatus
VERIFY:.*\.NET Core runtime at.*\s+
+IFDEF:TRIAGE_DUMP
+SOSCOMMAND:setclrpath %DESKTOP_RUNTIME_PATH%
+ENDIF:TRIAGE_DUMP
+
SOSCOMMAND:SOSStatus -desktop
VERIFY:\s*Switched to desktop CLR runtime successfully\s+
VERIFY:\s+<HEXVAL>\s+<HEXVAL>\s+SymbolTestDll\.TestClass\.Foo5\(.*\)\s+\[(?i:.*[\\|/]TestClass\.cs) @ 16\]\s*
VERIFY:\s+<HEXVAL>\s+<HEXVAL>\s+SymbolTestDll\.TestClass\.ThrowException\(.*\)\s+\[(?i:.*[\\|/]TestClass\.cs) @ 10\]\s*
-IFDEF:DOTNETDUMP
SOSCOMMAND:clrthreads
-ENDIF:DOTNETDUMP
-!IFDEF:DOTNETDUMP
-SOSCOMMAND:Threads
-ENDIF:DOTNETDUMP
VERIFY:\s*ThreadCount:\s+<DECVAL>\s+
VERIFY:\s+UnstartedThread:\s+<DECVAL>\s+
VERIFY:\s+BackgroundThread:\s+<DECVAL>\s+
LPCSTR Runtime::s_dacFilePath = nullptr;
LPCSTR Runtime::s_dbiFilePath = nullptr;
+// The runtime module path set by the "setclrpath" command
+LPCSTR g_runtimeModulePath = nullptr;
+
// Current runtime instance
IRuntime* g_pRuntime = nullptr;
{
if (m_runtimeDirectory == nullptr)
{
- std::string runtimeDirectory;
- if (SUCCEEDED(GetRuntimeDirectory(runtimeDirectory)))
+ if (g_runtimeModulePath != nullptr)
+ {
+ m_runtimeDirectory = _strdup(g_runtimeModulePath);
+ }
+ else
{
- m_runtimeDirectory = _strdup(runtimeDirectory.c_str());
+ std::string runtimeDirectory;
+ if (SUCCEEDED(GetRuntimeDirectory(runtimeDirectory)))
+ {
+ m_runtimeDirectory = _strdup(runtimeDirectory.c_str());
+ }
}
}
return m_runtimeDirectory;
virtual void DisplayStatus() = 0;
};
+extern LPCSTR g_runtimeModulePath;
extern IRuntime* g_pRuntime;
/**********************************************************************\
sethostruntime=SetHostRuntime
SetSymbolServer
setsymbolserver=SetSymbolServer
+ SetClrPath
+ setclrpath=SetClrPath
SOSFlush
sosflush=SOSFlush
StopOnException
----------------------------- -----------------------------
HistInit SetHostRuntime (sethostruntime)
HistRoot SetSymbolServer (setsymbolserver)
-HistObj FAQ
+HistObj SetClrPath (setclrpath)
HistObjFind SOSFlush
HistClear SOSStatus (sosstatus)
+ FAQ
Help (soshelp)
\\
Display internal SOS status, reset the internal cached state, or change between desktop or
netcore runtimes when both are loaded in the process or dump.
-0:000> !sosstatus
-Target platform: 8664 Context size 04d0
-.NET Core runtime at 00007FFEE7230000 (005c2000)
-DAC file path: C:\Users\mikem\AppData\Local\Temp\SymbolCache\mscordaccore.dll/5d0707425c2000/mscordaccore.dll
-DBI file path: C:\Users\mikem\AppData\Local\Temp\SymbolCache\mscordbi.dll/5d0707425c2000/mscordbi.dll
-Cache: C:\Users\mikem\AppData\Local\Temp\SymbolCache
-Server: http://msdl.microsoft.com/download/symbols/
\ No newline at end of file
+ 0:000> !sosstatus
+ Target platform: 8664 Context size 04d0
+ .NET Core runtime at 00007FFEE7230000 (005c2000)
+ DAC file path: C:\Users\mikem\AppData\Local\Temp\SymbolCache\mscordaccore.dll/5d0707425c2000/mscordaccore.dll
+ DBI file path: C:\Users\mikem\AppData\Local\Temp\SymbolCache\mscordbi.dll/5d0707425c2000/mscordbi.dll
+ Cache: C:\Users\mikem\AppData\Local\Temp\SymbolCache
+ Server: http://msdl.microsoft.com/download/symbols/
+//
+
+COMMAND: setclrpath.
+!setclrpath <path-to-runtime>
+
+Sets the path to load the runtime DAC/DBI files. This command may be necessary for dumps that were created
+on another machine or for triage dumps because there are no module paths included in the dump to infer the
+runtime directory.
+
+ 0:000> !setclrpath "C:\Program Files\dotnet\shared\Microsoft.NETCore.App\3.1.0"
+//
\ No newline at end of file
----------------------------- -----------------------------
HistInit (histinit) SetHostRuntime (sethostruntime)
HistRoot (histroot) SetSymbolServer (setsymbolserver, loadsymbols)
-HistObj (histobj) FAQ
+HistObj (histobj) SetClrPath (setclrpath)
HistObjFind (histobjfind) SOSFlush (sosflush)
HistClear (histclear) SOSStatus (sosstatus)
+ FAQ
Help (soshelp)
\\
COMMAND: faq.
->> Where can I get the right version of SOS for my build?
-
-If you are running a xplat version of coreclr, the sos module (exact name
-is platform dependent) is installed in the same directory as the main coreclr
-module. There is also an lldb sos plugin command that allows the path where
-the sos, dac and dbi modules are loaded:
-
- "setclrpath /home/user/coreclr/bin/Product/Linux.x64.Debug""
-
-If you are using a dump file created on another machine, it is a little bit
-more complex. You need to make sure the dac module that came with that install
-is in the directory set with the above command.
-
>> I have a chicken and egg problem. I want to use SOS commands, but the CLR
isn't loaded yet. What can I do?
-reset - reset all the cached internal SOS state.
Display internal SOS status or reset the internal cached state.
+\\
+
+COMMAND: setclrpath.
+!setclrpath <path-to-runtime>
+
+Sets the path to load the runtime DAC/DBI files. This command may be necessary for dumps that were created
+on another machine or for triage dumps.
+
+ (lldb) setclrpath /home/user/coreclr/bin/Product/Linux.x64.Debug
+\\
\ No newline at end of file
if (g_targetMachine != nullptr) {
ExtOut("Target platform: %04x Context size %04x\n", g_targetMachine->GetPlatform(), g_targetMachine->GetContextSize());
}
+ if (g_runtimeModulePath != nullptr) {
+ ExtOut("Runtime module path: %s\n", g_runtimeModulePath);
+ }
if (g_pRuntime != nullptr) {
g_pRuntime->DisplayStatus();
}
return Status;
}
+//
+// Sets the runtime module path
+//
+DECLARE_API(SetClrPath)
+{
+ INIT_API_EXT();
+
+ StringHolder runtimeModulePath;
+ CMDValue arg[] =
+ {
+ {&runtimeModulePath.data, COSTRING},
+ };
+ size_t narg;
+ if (!GetCMDOption(args, nullptr, 0, arg, _countof(arg), &narg))
+ {
+ return E_FAIL;
+ }
+ if (narg > 0)
+ {
+ if (g_runtimeModulePath != nullptr)
+ {
+ free((void*)g_runtimeModulePath);
+ }
+ g_runtimeModulePath = _strdup(runtimeModulePath.data);
+ }
+ if (g_runtimeModulePath != nullptr)
+ {
+ ExtOut("Runtime module path: %s\n", g_runtimeModulePath);
+ }
+ return S_OK;
+}
+
void PrintHelp (__in_z LPCSTR pszCmdName)
{
static LPSTR pText = NULL;
setclrpathCommandInitialize(lldb::SBDebugger debugger)
{
lldb::SBCommandInterpreter interpreter = debugger.GetCommandInterpreter();
- lldb::SBCommand command = interpreter.AddCommand("setclrpath", new setclrpathCommand(), "Set the path to load
coreclr dac/dbi files. setclrpath <path>");
+ lldb::SBCommand command = interpreter.AddCommand("setclrpath", new setclrpathCommand(), "Set the path to load
the runtime DAC/DBI files. setclrpath <path>");
return true;
}
[Command(Name = "histobjfind", AliasExpansion = "HistObjFind", Help = "Displays all the log entries that reference an object at the specified address.")]
[Command(Name = "histroot", AliasExpansion = "HistRoot", Help = "Displays information related to both promotions and relocations of the specified root.")]
[Command(Name = "setsymbolserver", AliasExpansion = "SetSymbolServer", Help = "Enables the symbol server support ")]
+ [Command(Name = "setclrpath", AliasExpansion = "setclrpath", Platform = CommandPlatform.Windows, Help = "Set the path to load the runtime DAC/DBI files.")]
[Command(Name = "dumprcw", AliasExpansion = "DumpRCW", Platform = CommandPlatform.Windows, Help = "Displays information about a Runtime Callable Wrapper.")]
[Command(Name = "dumpccw", AliasExpansion = "DumpCCW", Platform = CommandPlatform.Windows, Help = "Displays information about a COM Callable Wrapper.")]
[Command(Name = "dumppermissionset",AliasExpansion = "DumpPermissionSet", Platform = CommandPlatform.Windows, Help = "Displays a PermissionSet object (debug build only).")]
projects / platform / core / dotnet / diagnostics.git / commitdiff