Microsoft.Diagnostics.Runtime 0.8.31-beta

Prefix Reserved
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.
<PackageVersion Include="Microsoft.Diagnostics.Runtime" Version="0.8.31-beta" />
                    
Directory.Packages.props
<PackageReference Include="Microsoft.Diagnostics.Runtime" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version 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.
#addin nuget:?package=Microsoft.Diagnostics.Runtime&version=0.8.31-beta&prerelease
                    
Install Microsoft.Diagnostics.Runtime as a Cake Addin
#tool nuget:?package=Microsoft.Diagnostics.Runtime&version=0.8.31-beta&prerelease
                    
Install Microsoft.Diagnostics.Runtime as a Cake Tool

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 (42)

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 (40)

Showing the top 20 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
chocolatey/choco
Chocolatey - the package manager for Windows
xoofx/markdig
A fast, powerful, CommonMark compliant, extensible Markdown processor for .NET
microsoft/perfview
PerfView is a CPU and memory performance-analysis tool
mongodb/mongo-csharp-driver
The Official C# .NET Driver for MongoDB
dotnet/interactive
.NET Interactive combines the power of .NET with many other languages to create notebooks, REPLs, and embedded coding experiences. Share code, explore data, write, and learn across your apps in ways you couldn't before.
LavaGang/MelonLoader
The World's First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono
ashmind/SharpLab
.NET language playground
ArduPilot/MissionPlanner
Mission Planner Ground Control Station for ArduPilot (c# .net)
ppy/osu-framework
A game framework written with osu! in mind.
badamczewski/PowerUp
⚡ Decompilation Tools and High Productivity Utilities ⚡
disruptor-net/Disruptor-net
Port of LMAX Disruptor to .NET
microsoft/clrmd
Microsoft.Diagnostics.Runtime is a set of APIs for introspecting processes and dumps.
wwh1004/ExtremeDumper
.NET Assembly Dumper
fremag/MemoScope.Net
Dump and analyze .Net applications memory ( a gui for WinDbg and ClrMd )
dotnet/arcade
Tools that provide common build infrastructure for multiple .NET Foundation projects.
chummer5a/chummer5a
Character generator for Shadowrun 5th edition
SparkDevNetwork/Rock
An open source CMS, Relationship Management System (RMS) and Church Management System (ChMS) all rolled into one.
Version Downloads Last updated
4.0.0-beta.24360.3 11,367 10 months ago
4.0.0-beta.24360.2 137 10 months ago
4.0.0-beta.24320.3 575 6/20/2024
4.0.0-beta.24314.3 1,335 6/14/2024
3.1.512801 571,488 2/29/2024
3.1.506101 57,447 2/1/2024
3.1.456101 106,291 11/13/2023
3.1.456003 45,047 11/11/2023
3.1.455904 12,460 11/10/2023
3.0.442202 81,456 8/22/2023
3.0.0-beta.23214.4 1,644 4/17/2023
3.0.0-beta.23177.1 314 3/28/2023
3.0.0-beta.23165.1 305 3/16/2023
3.0.0-beta.23159.4 243 3/9/2023
3.0.0-beta.23158.2 253 3/9/2023
3.0.0-beta.23156.1 225 3/6/2023
2.4.416101 1,817,611 3/12/2023
2.3.405304 164,372 1/5/2023
2.2.343001 125,139 10/31/2022
2.2.332302 18,787,208 6/23/2022
2.2.332001 4,484 6/20/2022
2.1.327703 15,092 5/27/2022
2.0.226801 3,378,843 5/19/2021
2.0.226401 1,129 5/14/2021
2.0.222201 66,985 4/22/2021
2.0.221201 14,848 4/14/2021
2.0.217201 54,988 3/22/2021
2.0.161401 1,192,150 12/14/2020
2.0.156101 35,453 11/18/2020
2.0.151903 30,983 10/19/2020
2.0.145301 102,507 9/4/2020
2.0.142701 6,527 8/28/2020
2.0.142501 1,757 8/25/2020
2.0.142103 1,811 8/21/2020
2.0.141902 5,862 8/19/2020
2.0.137201 26,118 7/22/2020
2.0.130507 95,600 6/6/2020
2.0.0-rc.20303.6 515 6/4/2020
2.0.0-rc.20278.6 617 5/28/2020
2.0.0-beta.20276.4 444 5/27/2020
2.0.0-beta.20273.1 505 5/23/2020
2.0.0-beta.20272.2 515 5/22/2020
2.0.0-beta.20272.1 443 5/22/2020
2.0.0-beta.20268.2 520 5/18/2020
2.0.0-beta.20230.2 583 4/30/2020
2.0.0-beta.20230.1 440 4/30/2020
2.0.0-beta.20229.3 440 4/30/2020
2.0.0-beta.20223.2 448 4/23/2020
2.0.0-beta.20222.8 414 4/23/2020
2.0.0-beta.20222.7 407 4/23/2020
2.0.0-beta.20222.5 413 4/22/2020
2.0.0-beta.20220.3 423 4/20/2020
2.0.0-beta.20213.1 555 4/13/2020
2.0.0-beta.20174.2 555 3/24/2020
2.0.0-beta.20072.5 832 1/23/2020
2.0.0-beta.19618.7 590 12/19/2019
2.0.0-beta.19612.8 495 12/12/2019
1.1.142101 282,292 8/21/2020
1.1.132302 13,473 6/23/2020
1.1.127808 99,331 5/29/2020
1.1.126102 8,499,039 5/17/2020
1.1.122004 59,419 4/20/2020
1.1.116301 47,529 3/13/2020
1.1.61812 88,653 12/19/2019
1.1.57604 5,054,844 11/26/2019
1.1.57004 5,636 11/20/2019
1.1.46104 122,607 9/11/2019
1.1.37504 115,048 7/25/2019
1.1.35902 8,800 7/9/2019
1.1.35504 2,052 7/5/2019
1.0.5 2,495,705 3/19/2019
1.0.3 255,988 2/13/2019
1.0.2 25,816 12/17/2018
1.0.0 17,070 11/22/2018
0.9.180305.1 271,116 3/6/2018
0.9.170809.3 272,262 8/9/2017
0.9.170626.1 22,989 6/26/2017
0.8.31-beta 741,448 10/15/2015
0.8.30-beta 6,857 9/16/2015
0.8.27-beta 41,241 9/30/2014
0.8.26-beta 2,173 8/14/2014
0.8.25-beta 3,552 3/12/2014
0.8.24-aamain00309 1,621 12/2/2014
0.7.1-beta 3,706 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).