Skip to content

heruix/WinDbgCs

 
 

Repository files navigation

CsDebugScript: C# debugging automation tool

Set of .NET libraries that provide access to different debugging tools. CsDebugScript.Engine provides framework for writting .NET code against different debuggers/dump processing. Extension libraries provide access to dbgeng.dll for processing Windows dumps, ability to read Linux core dumps, WinDbg/VisualStudio extension with interactive scripting support. Debugging both native and managed code is supported (currently, managed code is supported only for dbgeng.dll and WinDbg extension).

Latest status

Build status Code coverage Nuget version GitHub release

If you want newer build than what is available in Releases page or as nuget package, 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
  • Start using it:
using CsDebugScript;

DebuggerInitialization.OpenDump("path_to_dump_file", "symbol_path;srv*");
// 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, you can take a look at code reference.

Prerequisites for building the project

  1. .NET core 2.0
  2. Visual Studio Community 2017 (for building WinDbg extension, VisualStudio extension)

About

C# debugging automation tool

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 99.5%
  • Other 0.5%