수 기가바이트 규모의 실행 파일 링크 시간을 절반으로 줄이고 디버깅하는 도구
디버그 정보가 수 기가바이트에 달하는 거대한 프로젝트를 다룰 때, 링크 단계에서 기다리는 시간이 개발 흐름을 끊습니다. 이 저장소는 에픽 게임즈가 만든 네이티브 디버거와 전용 링크러, 그리고 자체 디버그 정보 형식을 하나로 묶어 줍니다. 현재는 Windows x64 로컬 환경에서 PDB 파일을 기반으로 동작하며, 향후 Linux 지원으로 확장할 계획입니다.
알파 단계의 현재 지원 범위
프로젝트는 현재 알파 버전으로, Windows x64 로컬 디버깅만 지원합니다. 디버거는 PDB 파일을 읽어 동작하며, Linux x64 및 DWARF 디버그 정보 지원은 향후 계획에 있습니다. 개발팀은 디버거의 안정성을 높이기 위해 버그 리포트, 덤프 파일, 재현 방법을 함께 제출해 줄 것을 요청하고 있습니다. 이 단계의 최우선 과제는 Windows 개발 환경에서 핵심 구성 요소의 신뢰성을 확보하는 것입니다.
RDI 형식과 radbin 유틸리티
디버거는 기존 도구체인이 생성하는 PDB나 DWARF 대신 자체적인 RAD Debug Info(RDI) 형식을 사용합니다. radbin 유틸리티는 PDB나 PE/ELF 파일에 포함된 DWARF 정보를 RDI 형식으로 변환하거나, RDI 파일의 내용을 텍스트로 덤프하는 역할을 합니다. 이 변환은 필요할 때 자동으로 수행되어 기존 도구와의 호환성을 유지합니다. RDI 형식의 정의와 파싱 로직은 src/lib_rdi 폴더에 있는 C 언어 파일들로 구성되어 있습니다.
대규모 프로젝트용 RAD Linker
RAD Linker는 x64 PE/COFF 바이너리를 생성하는 링크러로, 특히 거대한 실행 파일을 만들 때 빠릅니다.
- 대형 페이지 지원
/rad_large_pages옵션을 활성화하면 링크 시간을 추가로 25% 단축할 수 있습니다. 하지만 Windows의 대형 페이지 지원이 불안정할 수 있어 Docker나 VM과 같이 환경이 리셋되는 곳에서만 사용을 권장합니다. - PDB 오버플로 해결 내부 32비트 테이블이 오버플로되어 깨지는 PDB 문제를 피하기 위해 RDI 형식을 직접 생성할 수 있는 옵션을 제공합니다.
로컬 빌드 환경 설정
Windows x64 환경에서는 Microsoft C/C++ Build Tools v15(2017) 이상과 Windows SDK가 필요합니다. vcvarsall.bat x64를 실행한 터미널에서 build.bat 스크립트를 실행하면 디버거가 빌드됩니다. Linux x64 환경에서는 GCC 또는 Clang과 libfreetype, libx11 등 몇 가지 동적 라이브러리 개발 패키지가 필요합니다. ./build.sh를 실행하여 빌드하며, release 인자를 추가하면 최적화된 바이너리를 생성할 수 있습니다. 디버거 외에도 radlink나 radbin을 빌드하려면 해당 인자를 함께 전달해야 합니다.
도입 전 점검 포인트
이 도구는 아직 알파 버전이므로, 프로덕션 환경보다는 개발 및 테스트 환경에서 사용하는 것이 적절합니다. 현재는 Windows x64 로컬 디버깅만 지원하며, Linux 지원은 로드맵에 있는 단계입니다. 링크러의 대형 페이지 기능은 일반 Windows 환경에서 메모리 단편화를 유발할 수 있으므로 주의가 필요합니다. 또한, 링크 타임 최적화(LTO)는 아직 지원되지 않으며, 향후 clang을 활용한 LTO가 계획되어 있습니다. 자신의 프로젝트 규모와 환경이 이 도구의 현재 지원 범위와 일치하는지 확인한 후 도입을 결정해야 합니다.