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

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 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
chocolatey/choco
Chocolatey - the package manager for Windows
xoofx/markdig
A fast, powerful, CommonMark compliant, extensible Markdown processor for .NET
Version Downloads Last updated
4.0.0-beta.24360.3 9,367 7/11/2024
4.0.0-beta.24360.2 130 7/10/2024
4.0.0-beta.24320.3 569 6/20/2024
4.0.0-beta.24314.3 1,276 6/14/2024
3.1.512801 503,800 2/29/2024
3.1.506101 54,159 2/1/2024
3.1.456101 103,182 11/13/2023
3.1.456003 41,479 11/11/2023
3.1.455904 11,643 11/10/2023
3.0.442202 80,976 8/22/2023
3.0.0-beta.23214.4 1,546 4/17/2023
3.0.0-beta.23177.1 306 3/28/2023
3.0.0-beta.23165.1 297 3/16/2023
3.0.0-beta.23159.4 235 3/9/2023
3.0.0-beta.23158.2 246 3/9/2023
3.0.0-beta.23156.1 215 3/6/2023
2.4.416101 1,727,105 3/12/2023
2.3.405304 151,338 1/5/2023
2.2.343001 121,063 10/31/2022
2.2.332302 17,696,963 6/23/2022
2.2.332001 4,442 6/20/2022
2.1.327703 14,922 5/27/2022
2.0.226801 3,330,064 5/19/2021
2.0.226401 1,114 5/14/2021
2.0.222201 65,134 4/22/2021
2.0.221201 14,167 4/14/2021
2.0.217201 54,803 3/22/2021
2.0.161401 1,175,898 12/14/2020
2.0.156101 35,374 11/18/2020
2.0.151903 30,734 10/19/2020
2.0.145301 101,671 9/4/2020
2.0.142701 6,506 8/28/2020
2.0.142501 1,735 8/25/2020
2.0.142103 1,787 8/21/2020
2.0.141902 5,843 8/19/2020
2.0.137201 26,073 7/22/2020
2.0.130507 87,150 6/6/2020
2.0.0-rc.20303.6 502 6/4/2020
2.0.0-rc.20278.6 592 5/28/2020
2.0.0-beta.20276.4 429 5/27/2020
2.0.0-beta.20273.1 493 5/23/2020
2.0.0-beta.20272.2 502 5/22/2020
2.0.0-beta.20272.1 429 5/22/2020
2.0.0-beta.20268.2 506 5/18/2020
2.0.0-beta.20230.2 570 4/30/2020
2.0.0-beta.20230.1 427 4/30/2020
2.0.0-beta.20229.3 427 4/30/2020
2.0.0-beta.20223.2 435 4/23/2020
2.0.0-beta.20222.8 401 4/23/2020
2.0.0-beta.20222.7 394 4/23/2020
2.0.0-beta.20222.5 400 4/22/2020
2.0.0-beta.20220.3 408 4/20/2020
2.0.0-beta.20213.1 541 4/13/2020
2.0.0-beta.20174.2 543 3/24/2020
2.0.0-beta.20072.5 819 1/23/2020
2.0.0-beta.19618.7 577 12/19/2019
2.0.0-beta.19612.8 483 12/12/2019
1.1.142101 277,348 8/21/2020
1.1.132302 13,408 6/23/2020
1.1.127808 98,578 5/29/2020
1.1.126102 8,407,027 5/17/2020
1.1.122004 59,110 4/20/2020
1.1.116301 47,487 3/13/2020
1.1.61812 88,477 12/19/2019
1.1.57604 5,030,973 11/26/2019
1.1.57004 5,605 11/20/2019
1.1.46104 122,357 9/11/2019
1.1.37504 110,486 7/25/2019
1.1.35902 8,661 7/9/2019
1.1.35504 2,032 7/5/2019
1.0.5 2,380,030 3/19/2019
1.0.3 251,456 2/13/2019
1.0.2 25,692 12/17/2018
1.0.0 16,868 11/22/2018
0.9.180305.1 270,774 3/6/2018
0.9.170809.3 268,070 8/9/2017
0.9.170626.1 22,900 6/26/2017
0.8.31-beta 738,217 10/15/2015
0.8.30-beta 6,809 9/16/2015
0.8.27-beta 41,191 9/30/2014
0.8.26-beta 2,133 8/14/2014
0.8.25-beta 3,524 3/12/2014
0.8.24-aamain00309 1,592 12/2/2014
0.7.1-beta 3,676 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).