Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

닷넷 응용 프로그램을 위한 PDB 옵션 - full, pdbonly, portable, embedded

PDB에 대해서는 이미 충분히 설명을 했었죠. ^^

PDB 이야기
; https://www.sysnet.pe.kr/2/0/309

C# 컴파일러(csc.exe)의 경우 PDB 생성을 위한 -debug 옵션으로 4가지 값(full, pdbonly, portable, embedded)이 가능한 것을 볼 수 있습니다.

-debug:{full|pdbonly|portable|embedded}
        Specify debugging type ('full' is default,
        'portable' is a cross-platform format,
        'embedded' is a cross-platform format embedded into
        the target .dll or .exe)

해당 옵션은 비주얼 스튜디오에서 C# 프로젝트 설정의 "Build" / "Advanced" - "Output" / "Debugging information" 옵션으로 제어할 수 있지만 직접 csproj 파일에 <DebugType />으로 지정해도 됩니다.

<DebugType>portable</DebugType>

full이 기본값이고, full과 pdbonly의 차이는 다음의 문서에 따라,

-debug (C# Compiler Options)
; https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/compiler-options/debug-compiler-option

실행 시점에 디버거를 연결했을 때에도 소스 코드 디버깅이 가능하냐의 유무로 나뉩니다. 즉, pdbonly로 하는 경우에는 해당 PDB 파일로는 실행 중에 디버거를 연결하면 어셈블리 코드를 보여주는 모드로만 동작하게 됩니다. 하지만, 일단 문서상으로 그렇다는 것이고 실제로 해보면 pdbonly였어도 정상적으로 디버거 연결이 되고 소스 코드 BP까지 모두 동작합니다. 이에 대한 설명은 다음의 Q&A에서 확인할 수 있는데요,

Should I compile release builds with debug info as “full” or “pdb-only”?
; https://stackoverflow.com/questions/7713514/should-i-compile-release-builds-with-debug-info-as-full-or-pdb-only

.NET 1.x 시절에는 full과 pdbonly의 역할이 달랐지만 .NET 2.0 이후로는 동일하게 되었다고 합니다.

그다음 portable 옵션에 대해서는 다음의 문서에서 상세하게 다루고 있습니다.

Portable PDB
; https://github.com/dotnet/core/blob/main/Documentation/diagnostics/portable_pdb.md

위의 문서에도 나오지만, portable PDB에 대한 format은 문서화도 잘 되어 있고,

Portable PDB v1.0: Format Specification
; https://github.com/dotnet/runtime/blob/main/docs/design/specs/PortablePdb-Metadata.md

이에 대한 open source까지 있습니다.

dotnet/symreader-portable
; https://github.com/dotnet/symreader-portable

무엇보다 cross-platform을 지원하므로 쓰지 않을 이유가 없지만 "Portable PDB - Supported scenarios" 문서에 나온 제약이 있다는 점만 유의하시면 됩니다.

그중에서 그나마 유의미한 것이 있다면, 4.7.1 이하의 버전에서는 스택 트레이스에 소스 코드 정보가 누락된다는 점이 있습니다.

예를 들어, 아래의 소스 코드를 4.7.1로 (portable) 빌드하는 경우,

using System;

class Program
{
    static void Main(string[] args)
    {
        Test();
    }

    private static void Test()
    {
        throw new NotImplementedException();
    }
}

이렇게 예외 메시지가 출력되지만,

Unhandled Exception: System.NotImplementedException: The method or operation is not implemented.
   at ConsoleApp1.Program.Test()
   at ConsoleApp1.Program.Main(String[] args)

4.7.2 이상으로 빌드하면 기대했던 소스 파일 및 코드의 라인 정보가 나오게 됩니다.

Unhandled Exception: System.NotImplementedException: The method or operation is not implemented.
   at ConsoleApp1.Program.Test() in C:\temp\ConsoleApp1\Program.cs:line 12
   at ConsoleApp1.Program.Main(String[] args) in C:\temp\ConsoleApp1\Program.cs:line 7

또 다른 제약으로 MS DIA 기반의 WinDBG에서 지원하지 않는다는 것이 있는데, 실제로 해보면 (심지어 4.7.1 이하로 빌드한 응용 프로그램에 대해서도) 다음과 같이 잘 동작합니다.

0:000> !clrstack
OS Thread Id: 0x1114 (0)
        Child SP               IP Call Site
00000061ebafeb58 00007ffd68afd759 [HelperMethodFrame: 00000061ebafeb58] 
00000061ebafec40 00007ffcf0dd0915 Program.Test() [C:\temp\ConsoleApp1\Program.cs @ 11]
00000061ebafec80 00007ffcf0dd08b2 Program.Main(System.String[]) [C:\temp\ConsoleApp1\Program.cs @ 7]
00000061ebafee98 00007ffd50316923 [GCFrame: 00000061ebafee98] 

0:000> !pe
Exception object: 0000023d80002e10
Exception type:   System.NotImplementedException
Message:          The method or operation is not implemented.
InnerException:   <none>
StackTrace (generated):
    SP               IP               Function
    00000061EBAFEC40 00007FFCF0DD0915 ConsoleApp1!Program.Test()+0x45
    00000061EBAFEC80 00007FFCF0DD08B2 ConsoleApp1!Program.Main(System.String[])+0x22

0:000> lm
0000023d`f30d0000 0000023d`f30d8000   ConsoleApp1 C (pdb symbols) C:\temp\ConsoleApp1\bin\Debug\ConsoleApp1.pdb

마지막 옵션에 해당하는 embedded의 경우 portable과 동일하지만 단지 exe/dll 실행 모듈에 병합된다는 차이점이 있습니다. 또한 (아직인지는 모르겠지만) 현재 WinDBG는 바이너리에 포함된 PDB 정보를 인식하지 못해 소스 코드 정보를 출력하지 못합니다.

0:000> !clrstack
OS Thread Id: 0x5104 (0)
        Child SP               IP Call Site
0000008b0aafe918 00007ffd68afd759 [HelperMethodFrame: 0000008b0aafe918] 
0000008b0aafea00 00007ffcf0db0925 Program.Test()
0000008b0aafea40 00007ffcf0db08c2 Program.Main(System.String[])
0000008b0aafec68 00007ffd50316923 [GCFrame: 0000008b0aafec68] 




정리해 보면, .NET Core 응용 프로그램이라면 portable/embedded를 쓰지 않을 이유가 없습니다. 단지 .NET Framework 4.7.1 이하를 지원해야 한다면 기존처럼 full로 권장하고, WinDBG를 고려해야 한다면 embedded보다는 portable이 유용합니다.




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]



donaricano-btn



[최초 등록일: ]
[최종 수정일: 3/28/2021

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 쓴 사람
 




1  2  3  4  5  [6]  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12615정성태4/26/2021192오류 유형: 712. Microsoft Live 로그인 - 계정을 선택하는(Pick an account) 화면에서 진행이 안 되는 문제
12614정성태4/24/2021377개발 환경 구성: 570. C# - Azure AD 인증을 지원하는 ASP.NET Core/5+ 웹 애플리케이션 예제 구성 [2]파일 다운로드1
12613정성태4/23/2021283.NET Framework: 1048. C# - ETW 이벤트의 Keywords에 속한 EventId 구하는 방법 (2) 관리 코드파일 다운로드1
12612정성태4/23/2021260.NET Framework: 1047. C# - ETW 이벤트의 Keywords에 속한 EventId 구하는 방법 (1) PInvoke파일 다운로드1
12611정성태4/22/2021271오류 유형: 711. 닷넷 EXE 실행 오류 - Mixed mode assembly is build against version 'v2.0.50727' of the runtime
12610정성태4/22/2021355.NET Framework: 1046. C# - 컴파일 시점에 참조할 수 없는 타입을 포함한 이벤트 핸들러를 Reflection을 이용해 구독하는 방법파일 다운로드1
12609정성태4/22/2021467.NET Framework: 1045. C# - 런타임 시점에 이벤트 핸들러를 만들어 Reflection을 이용해 구독하는 방법파일 다운로드1
12608정성태4/21/2021587.NET Framework: 1044. C# - Generic Host를 이용해 .NET 5로 리눅스 daemon 프로그램 만드는 방법 [7]파일 다운로드1
12607정성태4/21/2021434.NET Framework: 1043. C# - 실행 시점에 동적으로 Delegate 타입을 만드는 방법파일 다운로드1
12606정성태4/21/2021457.NET Framework: 1042. C# - enum 값을 int로 암시적(implicit) 형변환하는 방법? [2]파일 다운로드1
12605정성태4/18/2021356.NET Framework: 1041. C# - AssemblyID, ModuleID를 관리 코드에서 구하는 방법파일 다운로드1
12604정성태4/18/2021324VS.NET IDE: 163. 비주얼 스튜디오 속성 창의 "Build(빌드)" / "Configuration(구성)"에서의 "활성" 의미
12603정성태4/16/2021378VS.NET IDE: 162. 비주얼 스튜디오 - 상속받은 컨트롤이 디자인 창에서 지원되지 않는 문제
12602정성태4/16/2021512VS.NET IDE: 161. x64 DLL 프로젝트의 컨트롤이 Visual Studio의 Designer에서 보이지 않는 문제
12601정성태4/15/2021348.NET Framework: 1040. C# - REST API 대신 github 클라이언트 라이브러리를 통해 프로그래밍으로 접근
12600정성태4/15/2021320.NET Framework: 1039. C# - Kubeconfig의 token 설정 및 인증서 구성을 자동화하는 프로그램
12599정성태4/14/2021311.NET Framework: 1038. C# - 인증서 및 키 파일로부터 pfx/p12 파일을 생성하는 방법파일 다운로드1
12598정성태4/14/2021336.NET Framework: 1037. openssl의 PEM 개인키 파일을 .NET RSACryptoServiceProvider에서 사용하는 방법 (2)파일 다운로드1
12597정성태4/13/2021308개발 환경 구성: 569. csproj의 내용을 공통 설정할 수 있는 Directory.Build.targets / Directory.Build.props 파일
12596정성태4/12/2021366개발 환경 구성: 568. Windows의 80 포트 점유를 해제하는 방법
12595정성태4/12/2021320.NET Framework: 1036. SQL 서버 - varbinary 타입에 대한 문자열의 CAST, CONVERT 변환을 C# 코드로 구현
12594정성태4/11/2021445.NET Framework: 1035. C# - kubectl 명령어 또는 REST API 대신 Kubernetes 클라이언트 라이브러리를 통해 프로그래밍으로 접근 [1]파일 다운로드1
12593정성태4/10/2021386개발 환경 구성: 567. Docker Desktop for Windows - kubectl proxy 없이 k8s 대시보드 접근 방법
12592정성태4/10/2021337개발 환경 구성: 566. Docker Desktop for Windows - k8s dashboard의 Kubeconfig 로그인 및 Skip 방법
12591정성태4/9/2021597.NET Framework: 1034. C# - byte 배열을 Hex(16진수) 문자열로 고속 변환하는 방법파일 다운로드1
12590정성태4/9/2021339.NET Framework: 1033. C# - .NET 4.0 이하에서 Console.IsInputRedirected 구현
1  2  3  4  5  [6]  7  8  9  10  11  12  13  14  15  ...