From Krita Documentation
Jump to: navigation, search

Dr. Mingw debugger

i The information on this page applies only to the Windows release of Krita 3.1 Beta 3 (3.0.92) and later.

Getting a Backtrace

There are some additions to Krita which makes getting a backtrace much easier on Windows.

  1. An example of the crash dialog
    When there is a crash, Krita might appear to be unresponsive for a short time, ranging from a few seconds to a few minutes, before the crash dialog appears.
    • If Krita keeps on being unresponsive for more than a few minutes, it might actually be locked up, which may not give a backtrace. In that situation, you have to close Krita manually. Continue to follow the following instructions to check whether it was a crash or not.
  2. Open Windows Explorer and type `%LocalAppData%` (without quotes) on the address bar and press Enter.
    Mingw-explorer-path.png
  3. Find the file `kritacrash.log` (it might appear as simply `kritacrash` depending on your settings.)
  4. Start of backtrace
    Open the file with Notepad and scroll to the bottom, then scroll up to the first occurance of “Error occured on
i Starting from Krita 3.1 Beta 3 (3.0.92), the external DrMingw JIT debugger is not needed for getting the backtrace.

Using the Debug Package

Starting from 3.1 Beta 3, the debug package contains only the debug symbols separated from the executables, so you have to download the portable package separately too (though usually you already have it in the first place.)

  • Links to the debug packages should be available on the release announcement news item on https://krita.org/, along with the release packages. You can find debug packages for any release either in https://download.kde.org/stable/krita for stable releases or in https://download.kde.org/unstable/krita for unstable releases. Portable zip and debug zip are found next to each other.
  • Make sure you’ve downloaded the same version of debug package for the portable package you intend to debug / get a better (sort of) backtrace.
  • Extract the files inside the Krita install directory, where the sub-directories `bin`, `lib` and `share` is located, like in the figures below:
    Mingw-dbg7zip.png Mingw-dbg7zip-dir.png
  • After extracting the files, check the `bin` dir and make sure you see the `.debug` dir inside. If you don't see it, you probably extracted to the wrong place.