Skip to content

leculver/WinDbgCs

 
 

Repository files navigation

WinDbgCs

WinDbg extension for executing C# scripts. It allows you to automate data querying/processing of both native and managed applications. It can be also used without WinDbg to open dumps.

Latest status

Build status Code coverage Nuget version GitHub release

If you want newer build that what is available in Releases page or on the Nuget.org, you can click on Latest build, select Configuration and click on Artifacts. You can also use private nuget feed https://ci.appveyor.com/nuget/windbgcs-raewbx34ffcq.

Easy start for using engine

  • Create a new .NET project (you can use Console Application)
  • Add NuGet package CsDebugScript.Engine
  • Start using it:
using CsDebugScript;

var debugClient = DbgEngManaged.DebugClient.OpenDumpFile("path_to_dump_file", "symbol_path;srv*");
CsDebugScript.Engine.Context.Initialize(debugClient);
// After this line, you can execute any code that can be executed in the script. For example:
foreach (Module module in Process.Current.Modules)
    Console.WriteLine(module.Name);

Wiki

Take a look a Wiki page to get hooked up :)
Or jump to WinDbg interactive mode screenshots...

Code reference

Now that you are hooked up, cou can take a look at code reference.

Prerequisites for building the project

  1. Visual Studio 2015
  2. Windows SDK 10: https://dev.windows.com/en-US/downloads/windows-10-sdk
  3. Sandcastle (for documentation reference generation): https://github.com/EWSoftware/SHFB/releases

About

WinDbg extension for executing C# scripts

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 98.6%
  • C++ 1.2%
  • Other 0.2%