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)
12575정성태3/24/2021679개발 환경 구성: 557. Docker Desktop for Windows에서 DockerDesktopVM 기반의 Kubernetes 구성
12574정성태3/23/20211103.NET Framework: 1030. C# Socket의 Close/Shutdown 동작 (동기 모드)
12573정성태3/22/2021903개발 환경 구성: 556. WSL 인스턴스 초기 설정 명령어
12572정성태3/22/2021798.NET Framework: 1029. C# - GC 호출로 인한 메모리 압축(Compaction)을 확인하는 방법파일 다운로드1
12571정성태3/21/2021801오류 유형: 706. WSL 2 기반으로 "Enable Kubernetes" 활성화 시 초기화 실패 [1]
12570정성태3/19/2021798개발 환경 구성: 555. openssl - CA로부터 인증받은 새로운 인증서를 생성하는 방법
12569정성태3/18/2021986개발 환경 구성: 554. WSL 인스턴스 export/import 방법 및 단축 아이콘 설정 방법
12568정성태3/18/2021668오류 유형: 705. C# 빌드 - Couldn't process file ... due to its being in the Internet or Restricted zone or having the mark of the web on the file.
12567정성태3/17/2021707개발 환경 구성: 553. Docker Desktop for Windows를 위한 k8s 대시보드 활성화 [1]
12566정성태3/17/2021769개발 환경 구성: 552. Kubernetes - kube-apiserver와 REST API 통신하는 방법 (Docker Desktop for Windows 환경)
12565정성태3/17/2021570오류 유형: 704. curl.exe 실행 시 dll not found 오류
12564정성태3/16/2021665VS.NET IDE: 160. 새 프로젝트 창에 C++/CLI 프로젝트 템플릿이 없는 경우
12563정성태3/16/2021729개발 환경 구성: 551. C# - JIRA REST API 사용 정리 (3) jira-oauth-cli 도구를 이용한 키 관리
12562정성태3/15/2021824개발 환경 구성: 550. C# - JIRA REST API 사용 정리 (2) JIRA OAuth 토큰으로 API 사용하는 방법파일 다운로드1
12561정성태3/12/2021653VS.NET IDE: 159. Visual Studio에서 개행(\n, \r) 등의 제어 문자를 치환하는 방법 - 정규 표현식 사용
12560정성태3/11/20211026개발 환경 구성: 549. ssh-keygen으로 생성한 개인키/공개키 파일을 각각 PKCS8/PEM 형식으로 변환하는 방법
12559정성태3/11/2021728.NET Framework: 1028. 닷넷 5 환경의 Web API에 OpenAPI 적용을 위한 NSwag 또는 Swashbuckle 패키지 사용파일 다운로드1
12558정성태3/10/20211024Windows: 192. Power Automate Desktop (Preview) 소개 - Bitvise SSH Client 제어 [1]
12557정성태3/10/2021575Windows: 191. 탐색기의 보안 탭에 있는 "Object name" 경로에 LEFT-TO-RIGHT EMBEDDING 제어 문자가 포함되는 문제
12556정성태3/9/2021531오류 유형: 703. PowerShell ISE의 Debug / Toggle Breakpoint 메뉴가 비활성 상태인 경우
12555정성태3/8/2021762Windows: 190. C# - 레지스트리에 등록된 DigitalProductId로부터 라이선스 키(Product Key)를 알아내는 방법파일 다운로드2
12554정성태3/8/2021945.NET Framework: 1027. 닷넷 응용 프로그램을 위한 PDB 옵션 - full, pdbonly, portable, embedded
12553정성태3/5/2021827개발 환경 구성: 548. 기존 .NET Framework 프로젝트를 .NET Core 용으로 변환해 주는 upgrade-assistant, try-convert 도구 소개
12552정성태3/5/2021596개발 환경 구성: 547. github workflow/actions에서 Visual Studio Marketplace 패키지 등록하는 방법
12551정성태3/5/2021652오류 유형: 702. 비주얼 스튜디오 - The 'CascadePackage' package did not load correctly. (2)
12550정성태3/5/2021599오류 유형: 701. Live Share 1.0.3713.0 버전을 1.0.3884.0으로 업데이트 이후 ContactServiceModelPackage 오류 발생하는 문제
1  2  3  4  5  6  7  8  9  10  11  [12]  13  14  15  ...