Skip to content

Latest commit

 

History

History
36 lines (20 loc) · 2.09 KB

HOWTO_Debug.wiki

File metadata and controls

36 lines (20 loc) · 2.09 KB

  1. summary Howto Debug TortoiseGit
  2. labels Featured

Table of Contents

Introduction

This guide will show you how to Debug !TortoiseGit. In general there are three stages of debugging with increasing need of work: 

  # [HOWTO_Debug#Capture_Debug_Strings Capturing debug strings]
  # [HOWTO_Debug#How_to_use_a_debugger Using a debugger (to generate a stack trace)]
  # [HOWTO_Debug#Compile_your_own_debug_version Compile your own debug version]

Capture Debug Strings

!TortoiseGit has some debug statements build in which are not generated and visible by default.

You can enable the generation of those debug strings by setting _!DebugOutputString_ to _true_ in !TortoiseGit advanced settings.

After restarting your computer (or TGitCache.exe, explorer.exe and/or !TortoiseGitProc.exe) you can capture the debug strings using a tools like DebugView from the !SysInternals suite or WinDbg.

If you use !DebugView and wish to report the values in Time column, you need to save the log file or log to file. Time column is not copied to clipboard.

How to use a debugger

In order to generate a stack trace you can use a debugger like WinDbg or a Visual Studio IDE and attach it to a !TortoiseGit process.

To get a nice stack trace and resolve symbols, you can use our symbol server

http://www.crash-server.com:8080/public/TortoiseGit/7fbde3fc-94e9-408b-b5c8-62bd4e203570/symsrv/

or download the .pdb files which are only available for our stable releases.

In !WinDbg the symbol server can be used by issuing _.sympath+ srv`*`c:\tmp`*`http://www.crash-server.com:8080/public/TortoiseGit/7fbde3fc-94e9-408b-b5c8-62bd4e203570/symsrv/ _; the URL for the Microsoft symbol server is _srv*c:\tmp*http://msdl.microsoft.com/download/symbols _.

Compile your own debug version

See TortoiseGit_Overall_Architecture and http://code.google.com/p/tortoisegit/source/browse/build.txt.