Note

The information in this topic is preliminary. Updated information will be provided in a later release of the documentation.

Small logo on windbg preview Debugging Using WinDbg Preview

WinDbg Preview is a brand-new version of WinDbg with more modern visuals, faster windows, a full-fledged scripting experience, built with the extensible debugger data model front and center. WinDbg Preview is using the same underlying engine as WinDbg today, so all the commands, extensions, and workflows you're used to will still work as they did before.

For information on what's new in the most recent release, see WinDbg Preview - What's New.

For the latest news, tips, and tricks from the debugger dev team, refer to the debugger tools team blog. https://blogs.msdn.microsoft.com/windbg/

Review these topics to install and configure WinDbg Preview.

These topics describe how to get connected to the environment that you want to debug.

These topics describe some common tasks, organized by the menu tabs.

Providing feedback

Your feedback will help guide WinDbg's development going forward.

  • If you have feedback such as a feature that you really want to see or a bug that makes something difficult, use the Feedback Hub.

Screen shot of feedback hub showing feedback options including the add new feedback button

Major Features of WinDbg Preview

Here's some of the most notable things that have changed or are new.

Main screen in debugger

General features

  • Easier Connection Setup and Recall - The WinDbg Preview includes the ability to recall previous session configuration information.

Screen shot of main screen in debugger

  • Easy feedback channel - Your feedback will guide the development effort going forward. For more information, see Providing Feedback
  • Dump file processor detection -Auto-detects processor architecture for easier managed debugging.
  • Performance Improvements Windows now load asynchronously and can be canceled - When you run another command, WinDbg Preview will stop the loading of your locals, watch, or other windows.

Windowing improvements

  • Disassembly Window Improvements - The disassembly window is also improved, the highlight of the current instruction remains where it is when you scroll.
  • Memory window improvements - The memory window has highlighting and improved scrolling.
  • Locals and watch data model visualization - The locals and watch windows are both based off of the data model that is used by the dx command. This means the locals and watch windows will benefit from any NatVis or JavaScript extensions you have loaded, and can even support full LINQ queries, just like the dx command.
  • Logs - This is a under the covers log of the WinDbg Preview internals. It can be viewed for troubleshooting or to monitor long running processes.

For more information, see WinDbg Preview - View menu.

View menu in debugger

  • Command window - Use the command window provides easy access to toggle DML and clear the debugger command window. All current debugger commands are compatible with and continue to work in WinDbg Preview.
  • Source window - Use the source windows to work with source code files, the new source windows should look more similar to the source windows you're used to seeing in every other modern editor.

Enhanced breakpoint tracking

  • Enable/Disable breakpoints - The breakpoints window shows all your current breakpoints and provides easy access to enabling and disabling them.
  • Hit count - The breakpoint window keeps a running total of each time the breakpoint is hit.

For more information, see Breakpoints.

Enhanced data model support

  • Built in data model support - WinDbg Preview is written with built in data model support and the data model is available through out the debugger.
  • Model window - The model window gives you an expandable and browsable version of ‘dx’ and ‘dx -g’, letting you create powerful tables on-top of your NatVis, JavaScript, and LINQ queries.

For more information, see WinDbg Preview - Data model.

Screen shot of data model menu in debugger

New Scripting development UI

  • Script development UI - There is now a purpose built scripting window to make developing JavaScript and NatVis scripts easier, with error highlighting and IntelliSense.

For more information, see WinDbg Preview - Scripting.

Screen shot of scripting menu in debugger

Backwards compatibility

Because the underling debugger engine is the same, all of the previous debugger commands and debugger extensions continue to work.