129

In Visual Studio for a C# project, if you go to Project Properties > Build > Advanced > Debug Info you have three options: none, full, or pdb-only.

Which setting is the most appropriate for a release build?


So, what are the differences between full and pdb-only?

If I use full will there be performance ramifications? If I use pdb-only will it be harder to debug production issues?

4
  • The pdb-only or none, always for release builds.
    – leppie
    Commented Oct 10, 2011 at 13:35
  • 15
    @leppie Thanks but I'm looking for some justification of that position. Commented Oct 10, 2011 at 13:47
  • Related question: stackoverflow.com/questions/1270986/…
    – janv8000
    Commented Mar 10, 2015 at 7:17
  • That's great if there's no performance impact. What about memory impact? If I create an instance of StackTrace and request file information, it has to come from the pdb symbol data. Are all symbols loaded into memory on application start? What is the approximate memory use of this? (e.g. percentage overhead relative to code size.)
    – yoyo
    Commented Apr 16, 2015 at 17:40

4 Answers 4

98

I would build with pdb-only. You will not be able to attach a debugger to the released product, but if you get a crash dump, you can use Visual Studio or WinDBG to examine the stack traces and memory dumps at the time of the crash.

If you go with full rather than pdb-only, you'll get the same benefits, except that the executable can be attached directly to a debugger. You'll need to determine if this is reasonable given your product & customers.

Be sure to save the PDB files somewhere so that you can reference them when a crash report comes in. If you can set up a symbol server to store those debugging symbols, so much the better.

If you opt to build with none, you will have no recourse when there's a crash in the field. You won't be able to do any sort of after-the-fact examination of the crash, which could severely hamper your ability to track down the problem.

A note about performance:

Both John Robbins and Eric Lippert have written blog posts about the /debug flag, and they both indicate that this setting has zero performance impact. There is a separate /optimize flag which dictates whether the compiler should perform optimizations.

14
  • 8
    @Matt, the MSDN article on the /debug switch explicitly warns about a performance impact of using the 'full' setting: If you use /debug:full, be aware that there is some impact on the speed and size of JIT optimized code and a small impact on code quality with /debug:full. We recommend /debug:pdbonly or no PDB for generating release code. Commented Feb 16, 2012 at 9:18
  • 3
    @Matt: If 'full' has no disadvantages compared to 'pdb-only', but only has advantages, why does 'pdb-only' even exist? Is there any reason to use it over 'full'? Also, you should add the correction to the MSDN article in the 'Community Content' section. Commented Feb 16, 2012 at 19:45
  • 10
    @AllonGuralnek quote from the linked John Robbins article: The real reason: history. Back in .NET 1.0 there were differences, but in .NET 2.0 there isn't. It looks like .NET 4.0 will follow the same pattern. After double-checking with the CLR Debugging Team, there is no difference at all. Commented May 10, 2013 at 8:34
  • 5
    This isn't true. You can build with pdb-only and still attach a debugger. I just did it just to be sure.
    – Mark
    Commented Aug 28, 2015 at 18:49
  • 2
    "I would build with pdb-only. You will not be able to attach a debugger to the released product" What's your source of information here? As both @Mark and I have noted, this does not seem to be correct.
    – MEMark
    Commented Nov 3, 2015 at 15:16
75

WARNING MSDN documentation for /debug switch (In Visual Studio it is Debug Info) seems to be out-of-date! This is what it has which is incorrect

If you use /debug:full, be aware that there is some impact on the speed and size of JIT optimized code and a small impact on code quality with /debug:full. We recommend /debug:pdbonly or no PDB for generating release code.

One difference between /debug:pdbonly and /debug:full is that with /debug:full the compiler emits a DebuggableAttribute, which is used to tell the JIT compiler that debug information is available.

Then, what is true now?

  1. Pdb-only – Prior to .NET 2.0, it helped to investigate the crash dumps from released product (customer machines). But it didn't let attaching the debugger. This is not the case from .NET 2.0. It is exactly same as Full.
  2. Full – This helps us to investigate crash dumps, and also allows us to attach debugger to release build. But unlike MSDN mentions, it doesn't impact the performance (since .NET 2.0). It does exactly same as Pdb-only.

If they are exactly same, why do we have these options? John Robbins (windows debugging god) found out these are there for historical reasons.

Back in .NET 1.0 there were differences, but in .NET 2.0 there isn’t. It looks like .NET 4.0 will follow the same pattern. After double-checking with the CLR Debugging Team, there is no difference at all.

What controls whether the JITter does a debug build is the /optimize switch. <…>

The bottom line is that you want to build your release builds with /optimize+ and any of the /debug switches so you can debug with source code.

then he goes on to prove it.

Now the optimization is part of a separate switch /optimize (in visual studio it is called Optimize code).

In short, irrespective of DebugInfo setting pdb-only or full, we will have same results. The recommendation is to avoid None since it would deprive you of being able to analyze the crash dumps from released product or attaching debugger.

3
  • 3
    Fantastic answer! My own investigations (comparing generated files) show the same results.
    – MEMark
    Commented Nov 3, 2015 at 15:27
  • @rpattabi Can you specify the reference that pdbonly and full are the same? It's 2019 and the documentation still indicates that they are different and full will have performance degradation. And VS2019 creates project with Release configuration's debugtype by default set to pdbonly.
    – joe
    Commented Sep 16, 2019 at 11:57
  • @joe There is a discussion at the bottom of the MSDN documentation msdn.microsoft.com/en-us/library/8cw0bt21.aspx . Take a look at it. One contributor pointed to github.com/dotnet/roslyn/blob/master/docs/compilers/CSharp/… for up-to-date information where pdbonly and full are mentioned as same. (FYI. I don't use windows or VS anymore. So I have not been following what is happening there. But as I reviewed, the information in my answer is still relevant and MSDN doc is still incorrect.)
    – rpattabi
    Commented Sep 24, 2019 at 5:02
17

You'll want PDB only, but you won't want to give the PDB files to users. Having them for yourself though, alongside your binaries, gives you the ability to load crash dumps into a debugger like WinDbg and see where your program actually failed. This can be rather useful when your code is crashing on a machine you don't have access to.

Full debug adds the [Debuggable] attribute to your code. This has a huge impact on speed. For example, some loop optimizations may be disabled to make single stepping easier. In addition, it has a small effect on the JIT process, as it turns on tracking.

6
  • Makes sense. I don't really distribute DLLs to the users anyways - it is an ASP.NET app. But can you enhance your answer and justify why you should go with "pdb-only" vs. "full"? Is it a performance issue? Commented Oct 10, 2011 at 13:46
  • @jkohlhepp: I would like to add though that debugging release builds is a bit tricky since you will lose some information (due to JIT). Almost always, you won't be able to see the values of method arguments. To workaround this, you can temporarily disable JIT optimization using this.
    – Ilian
    Commented Oct 10, 2011 at 13:59
  • Thanks blowdart, and thanks Ilian Pinzon for the additional info. I know you can't get perfect debugging with release code but having the PDBs is better than nothing. Commented Oct 10, 2011 at 14:44
  • Using the "full" setting does not have a performance impact. It simply allows a debugger to be attached to a running process. Commented Feb 16, 2012 at 19:42
  • 1
    Good question on MSDN Matt, msdn.microsoft.com/en-us/library/8cw0bt21, waiting for the answer myself. Commented Feb 24, 2012 at 20:22
5

I'm in the process of writing a unhandled exception handler and the stack trace includes the line number when pdb-only is used, otherwise I just get the name of the Sub/Function when I choose None.

If I don't distribute the .pdb I don't get the line number in the stack trace even with the pdb-only build.

So, I'm distributing (XCOPY deploy on a LAN) the pdb along with the exe from my VB app.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.