Microsoft.Diagnostics.Runtime 0.8.31-beta

Prefix Reserved
.NET Framework 4.0 This package targets .NET Framework 4.0. The package is compatible with this framework or higher.
This is a prerelease version of Microsoft.Diagnostics.Runtime.
There is a newer version of this package available.
See the version list below for details.

Requires NuGet 2.5 or higher.

dotnet add package Microsoft.Diagnostics.Runtime --version 0.8.31-beta                

                    
                

            
NuGet\Install-Package Microsoft.Diagnostics.Runtime -Version 0.8.31-beta
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Microsoft.Diagnostics.Runtime" Version="0.8.31-beta" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Microsoft.Diagnostics.Runtime --version 0.8.31-beta                

                    
                

            
#r "nuget: Microsoft.Diagnostics.Runtime, 0.8.31-beta"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install Microsoft.Diagnostics.Runtime as a Cake Addin
#addin nuget:?package=Microsoft.Diagnostics.Runtime&version=0.8.31-beta&prerelease

// Install Microsoft.Diagnostics.Runtime as a Cake Tool
#tool nuget:?package=Microsoft.Diagnostics.Runtime&version=0.8.31-beta&prerelease

ClrMD is a set of advanced APIs for programmatically inspecting a crash dump of a .NET program much in the same way that the SOS Debugging Extensions (SOS) do. This allows you to write automated crash analysis for your applications as well as automate many common debugger tasks. In addition to reading crash dumps ClrMD also allows supports attaching to live processes.

Product Compatible and additional computed target framework versions.
.NET Framework net40 is compatible.  net403 was computed.  net45 was computed.  net451 was computed.  net452 was computed.  net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages (37)

Showing the top 5 NuGet packages that depend on Microsoft.Diagnostics.Runtime:

Package Downloads
BenchmarkDotNet

Powerful .NET library for benchmarking
ppy.osu.Framework

A 2D application/game framework written with rhythm games in mind.
Backtrace

Backtrace's integration with C# applications allows customers to capture and report handled and unhandled C# exceptions to their Backtrace instance, instantly offering the ability to prioritize and debug software errors.
Phoesion.Glow.SDK.Firefly.SrvHost.DotNet.Dependencies

Phoesion Glow SDK Firefly SrvHost Runner (DotNet) Dependencies
DynaMD

Helper objects to browse complex structures returned by ClrMD

GitHub repositories (39)

Showing the top 5 popular GitHub repositories that depend on Microsoft.Diagnostics.Runtime:

Repository Stars
dnSpy/dnSpy
.NET debugger and assembly editor
winsw/winsw
A wrapper executable that can run any executable as a Windows service, in a permissive license.
dotnet/BenchmarkDotNet
Powerful .NET library for benchmarking
xoofx/markdig
A fast, powerful, CommonMark compliant, extensible Markdown processor for .NET
microsoft/perfview
PerfView is a CPU and memory performance-analysis tool
Version Downloads Last updated
4.0.0-beta.24360.3 1,820 7/11/2024
4.0.0-beta.24360.2 95 7/10/2024
4.0.0-beta.24320.3 317 6/20/2024
4.0.0-beta.24314.3 915 6/14/2024
3.1.512801 190,964 2/29/2024
3.1.506101 40,728 2/1/2024
3.1.456101 85,208 11/13/2023
3.1.456003 23,528 11/11/2023
3.1.455904 6,986 11/10/2023
3.0.442202 75,689 8/22/2023
3.0.0-beta.23214.4 1,383 4/17/2023
3.0.0-beta.23177.1 280 3/28/2023
3.0.0-beta.23165.1 267 3/16/2023
3.0.0-beta.23159.4 209 3/9/2023
3.0.0-beta.23158.2 207 3/9/2023
3.0.0-beta.23156.1 190 3/6/2023
2.4.416101 1,350,182 3/12/2023
2.3.405304 114,169 1/5/2023
2.2.343001 97,187 10/31/2022
2.2.332302 13,561,384 6/23/2022
2.2.332001 4,331 6/20/2022
2.1.327703 14,534 5/27/2022
2.0.226801 3,081,067 5/19/2021
2.0.226401 1,066 5/14/2021
2.0.222201 58,290 4/22/2021
2.0.221201 11,098 4/14/2021
2.0.217201 53,852 3/22/2021
2.0.161401 1,091,127 12/14/2020
2.0.156101 34,732 11/18/2020
2.0.151903 28,479 10/19/2020
2.0.145301 97,677 9/4/2020
2.0.142701 6,444 8/28/2020
2.0.142501 1,676 8/25/2020
2.0.142103 1,727 8/21/2020
2.0.141902 5,780 8/19/2020
2.0.137201 25,908 7/22/2020
2.0.130507 59,325 6/6/2020
2.0.0-rc.20303.6 467 6/4/2020
2.0.0-rc.20278.6 550 5/28/2020
2.0.0-beta.20276.4 390 5/27/2020
2.0.0-beta.20273.1 456 5/23/2020
2.0.0-beta.20272.2 465 5/22/2020
2.0.0-beta.20272.1 391 5/22/2020
2.0.0-beta.20268.2 470 5/18/2020
2.0.0-beta.20230.2 531 4/30/2020
2.0.0-beta.20230.1 390 4/30/2020
2.0.0-beta.20229.3 389 4/30/2020
2.0.0-beta.20223.2 396 4/23/2020
2.0.0-beta.20222.8 357 4/23/2020
2.0.0-beta.20222.7 350 4/23/2020
2.0.0-beta.20222.5 360 4/22/2020
2.0.0-beta.20220.3 364 4/20/2020
2.0.0-beta.20213.1 498 4/13/2020
2.0.0-beta.20174.2 492 3/24/2020
2.0.0-beta.20072.5 769 1/23/2020
2.0.0-beta.19618.7 530 12/19/2019
2.0.0-beta.19612.8 435 12/12/2019
1.1.142101 259,801 8/21/2020
1.1.132302 13,214 6/23/2020
1.1.127808 93,700 5/29/2020
1.1.126102 8,007,509 5/17/2020
1.1.122004 57,719 4/20/2020
1.1.116301 47,314 3/13/2020
1.1.61812 87,800 12/19/2019
1.1.57604 4,925,819 11/26/2019
1.1.57004 5,492 11/20/2019
1.1.46104 121,044 9/11/2019
1.1.37504 92,083 7/25/2019
1.1.35902 8,032 7/9/2019
1.1.35504 1,949 7/5/2019
1.0.5 1,963,869 3/19/2019
1.0.3 222,149 2/13/2019
1.0.2 24,780 12/17/2018
1.0.0 16,190 11/22/2018
0.9.180305.1 269,404 3/6/2018
0.9.170809.3 236,098 8/9/2017
0.9.170626.1 22,695 6/26/2017
0.8.31-beta 722,726 10/15/2015
0.8.30-beta 6,598 9/16/2015
0.8.27-beta 40,932 9/30/2014
0.8.26-beta 1,969 8/14/2014
0.8.25-beta 3,404 3/12/2014
0.8.24-aamain00309 1,460 12/2/2014
0.7.1-beta 3,540 5/3/2013

Since the last release, I have made two major changes to the API.

First, I have reworked the SymbolLocator class.  I had to rush out the last version so that we could ship sources, and that class was in an incomplete state.  It has been subsequently reworked into a new design.

Second, as part of the effort to (finally) release 1.0 of the library and get it out of beta (which hasn't happened yet), I have marked some commonly used APIs with the [Obsolete] attribute.  Virtually no functionality has been removed, only that APIs have been renamed or moved within the runtime.  The one exception is that ClrMD is moving away from doing symbol resolution (File and Line number).  This means GetSourceLocationForOffset and related functions no longer work.  Instead, I have implemented a sample you can find here:  https://github.com/Microsoft/clrmd/blob/master/src/FileAndLineNumbers/Program.cs

Note that all methods marked [Obsolete] will be removed in the next NuGet release (but I do not plan to do another release for a little while).  I appologize in advance for any incovenience this causes.  After years of active development, some API dead-ends have inevitably crept into the library, and need to be removed before 1.0 is released.

Aside from various bugfixes, here are some noteworthy changes in this release:

1.  I've added Async APIs for symbol resolution/download, and the SymbolLocator class is now thread safe.  You can now download symbols asynchronosly and in parallel.
2.  Added basic support for converting CLR internal structures (MethodDescs, MethodTables, EEClass, etc) to and from ClrMD types and methods.
3.  Add a way to get information about the Shared and System domains.
4.  Completely remove the dependency on msdia120.dll and DiaLib.dll.  Added a managed PDB reader to do this work instead.  ClrMD currently has no dependencies on any other library (that doesn't come with windows anyway).