PdbGit lets users step through your code hosted on GitHub! Just install the PdbGit NuGet package to your project.

PdbGit makes dedicated source servers obsolete by reusing your git server as a source server.

The only requirement is to ensure the check the Enable source server support option in Visual Studio as shown below:

The simplest way to use PdbGit is to install its NuGet package into your project.

Install-Package PdbGit

Once installed, it automatically integrates with MSBuild to add source download instructions to your PDB. Indexing source URLs into your PDB files is very fast. A solution with over 85 projects will be handled in less than 30 seconds.

If you want to install the tool on your (build) computer, the package is available via Chocolatey. To install, use the following command:

choco install PdbGit

Using PdbGit via the command line is very simple:

PdbGit.exe <pdbfile>

The PDB file already has paths to your local files in it. The command line tool simply discovers the git repo behind those files, the remote git server, and creates the URLs for them and adds them to the PDB file. The tool emits warnings if the source files on disk do not match the versions used to compile the PDB.

When working with a content proxy or an alternative git VCS system that supports direct HTTP access to specific file revisions use the -u parameter with the custom raw content root URL

PdbGit.exe c:\source\catel -u https://raw.githubusercontent.com/catel/catel

The custom url will be used to fill in the following pattern {customUrl}/{revision}/{relativeFilePath} when generating the source mapping.

When working with a repository using uncommon URL you can use placeholders to specify where the filename and revision hash should be, use -u parameter with the custom URL

PdbGit.exe c:\source\catel -u "https://host/projects/catel/repos/catel/browse/{filename}?at={revision}&raw"

The custom url will be used to fill the placeholders with the relative file path and the revision hash.

When you need to log the information to a file, use the following command line:

PdbGit.exe c:\source\catel -u https://github.com/catel/catel -b develop -l PdbGitLog.log

There are many more parameters you can use. Display the usage doc with the following command line:

PdbGit.exe -h

The SrcSrv tool (Srcsrv.dll) enables a client to retrieve the exact version of the source files that were used to build an application. Because the source code for a module can change between versions and over the course of years, it is important to look at the source code as it existed when the version of the module in question was built.

For more information, see the official documentation of SrcSrv.

PdbGit creates a source index file and updates the PDB file so it will retrieve the files from the Git host file handler. To do this, PdbGit must be aware of the public URL from which the source files you compiled with can be retrieved. PdbGit.exe reads your compiler-generated PDB, which already contains full paths to your local source files. It then searches for a git repo that contains those source files and looks up the commit that HEAD points to. It also searches your remotes for a URL pattern that it recognizes (e.g. https://github.com/name/repo). It combines the URL and the commit ID to create a unique URL for each source file of this exact version, and adds this information to your PDB.

When you share your PDB alongside your DLL, your users who debug with Source Server support enabled will automatically be able to step into your source code.

PdbGit supports the following providers out of the box (will auto-detect based on the url):

• BitBucket
• GitHub

If your git host isn't listed here, PdbGit can still work for you given these requirements on your git host:

1. URLs to the raw content of each file for each commit exist.
2. The content is available for anonymous access to the public.

• Visual Studio 2012 needs to run elevated in order to download the source server files

• Specify a value for Visual Studio -> Options -> Debugging -> Symbols -> Cache Symbols in this directory

If your repository is private, you are likely seeing the logon HTML from your git host.

• Log onto your git host in Internet Explorer
• Purge your local symbol cache

Note that this approach is not guaranteed to work. Visual Studio needs to authenticate to retrieve the source files but does not ask the user for credentials to do so. There are ways to work around this, but no mechanism is currently provided out-of-the-box in PdbGit.

Possible workarounds

• Include a mechanism in the pdb to retrieve credentials (using PowerShell and Windows credentials store) (see #37)
• Use a proxy service that does not require authentication (see #66 and Source server with Git repository)