https://github.com/shenxiaolong-code/sourceindexlight_forgit

debug tools : windbg source index solution for git projects (source faster, debug slower)
https://github.com/shenxiaolong-code/sourceindexlight_forgit

debug dumpanalysis git sourceindex windbg

Last synced: 7 months ago
JSON representation

debug tools : windbg source index solution for git projects (source faster, debug slower)

• Host: GitHub
• URL: https://github.com/shenxiaolong-code/sourceindexlight_forgit
• Owner: shenxiaolong-code
• Created: 2020-12-03T07:02:11.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-01-06T10:10:00.000Z (over 4 years ago)
• Last Synced: 2025-05-19T02:12:44.345Z (about 1 year ago)
• Topics: debug, dumpanalysis, git, sourceindex, windbg
• Language: Batchfile
• Homepage:
• Size: 16.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

          


# SourceIndexLight_forGit  

windbg source index for git repo -- it is faster than the sourceIndex_forGit.  

The current windbg source index suite doesn't support git repo. here one solution is given by DOS script.

# source index Usage  

- Syntax:  

  gitIndex.cmd \ \

- example

  gitIndex.cmd "d:\myProject\newFeature" "d:\myProject\newFeature\output\bin\myApp.pdb"  

  gitIndex.cmd will make source index for this pdb file "d:\myProject\newFeature\output\bin\myApp.pdb" and update this pdb file.  

you can refer to the example in path : test/TC_gitIndex.bat  

### Prompt

-  for one solution with many projects/binary modules, one time is enough to call gitIndex.cmd.  

   In general, you can call gitIndex.cmd for your PDB file of the .exe module.

- you can configure the Post-Build Event in your visual studio project to simplify this procedure.  

  teps in solution explorer : .exe project > right click > properties > Configuration Properties > ild Events > Post-Build Event :  

  Command Line : gitIndex.cmd "$(SolutionDir)" \

# you need to do:

1. config windbg tool path  

if your windbg tool "pdbstr.exe" is added to %path%, you needn't do anything, else you need to update the file "userLocalPathConfig.bat"  

below is my windbg x86 path setting:  

where pdbstr.exe 2>nul || @set "path=C:\Program Files (x86)\Windows Kits\10\Debuggers\x86\srcsrv;%path%"  

where windbg.exe 2>nul || @set "path=C:\Program Files (x86)\Windows Kits\10\Debuggers\x86;%path%"  

2. prepare one local git repo  

it is used to update the git repo to a specified commit id.   

    example:   

    assume your git repo path is "D:\sourceCode\myProjectGitRepo"   

    your git url is https://..../myRepo.git   

    you need to set environment varialbe :  

    set "gitRepo_myRepo=D:\sourceCode\myProjectGitRepo"  

    see *:getRepoFromEvnVar* in **gitFetchRepo.cmd** for detail.  

    *this variable is used in "gitFetchRepo.cmd" , certain you can edit "gitFetchRepo.cmd" directly without puting it into system environments*.  

# use symbol with source index 

1. debugg application  

   after you config your symbol path, the debugger will download the symbol file(.pdb) automatically.  

   and source server (srcsrv) will fetch the correct version source file according to the source index information in the .pdb file.  

   after the source file is downloaded , debuger will open it automaticaly and locate the current source code line.  

2. **optional** download source file manual   

  after your debugger has downloaded the pdbfile myApp.pdb file -- assume its path is "c:\symbols\cache\myApp.pdb"  

   - if you defined environment variable gitRepo_myRepo, you can run :  

     gitFetchRepo.cmd "" "c:\symbols\cache\myApp.pdb"  

     the gitFetchRepo.cmd will update the local repo folder indicated by environment variable    gitRepo_myRepo.

   - if you doesn't define environment variable gitRepo_myRepo  

     if your local git repo is "D:\sourceCode\myProjectGitRepo", you can run :  

     gitFetchRepo.cmd "D:\sourceCode\myProjectGitRepo" "c:\symbols\cache\myApp.pdb"  

     the gitFetchRepo.cmd will update the local repo folder "D:\sourceCode\myProjectGitRepo".

# additional:  

- index slower , debug faster -- use : https://github.com/ShenXiaolong1976/sourceIndex_forGit  

- index faster , debug slower -- use : https://github.com/ShenXiaolong1976/sourceIndexLight_forGit