[Rust 공식문서 한국어 정리] ㊷. Rust 링킹(Linking) 가이드

[Rust 공식문서 한국어 정리] ㊷. Rust 링킹(Linking) 가이드

원문 제목: Linker — rustc Codegen Options
작성자: Rust Compiler Team

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 1. 서론 — 이 문서가 다루는 내용
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

이 문서는 Rust 컴파일러의 링킹 과정과 관련된 옵션, 전략, 그리고 고급 설정을 설명합니다.
정적 링킹과 동적 링킹의 차이, 링커 선택, 그리고 링크 타임 최적화(LTO)를 다룹니다.
Rust 바이너리가 외부 라이브러리와 어떻게 연결되는지, 그리고 배포 시 의존성을 어떻게 관리하는지를 중심으로 설명합니다.
크로스 컴파일, 임베디드, 그리고 배포용 정적 바이너리 생성을 위한 링킹 전략도 포함합니다.
시스템 프로그래밍과 배포 자동화를 다루는 개발자에게 필수적인 저수준 개념입니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔑 2. 핵심 개념 4가지
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

① 정적 링킹: 외부 라이브러리 코드를 실행 파일에 포함시켜 독립적인 바이너리를 만듭니다.
② 동적 링킹: 외부 라이브러리를 런타임에 로드하여 바이너리 크기를 줄이고 메모리를 공유합니다.
③ LTO: Link Time Optimization으로, 링크 단계에서 전체 프로그램 최적화를 수행합니다.
④ 링커 설정: .cargo/config.toml이나 RUSTFLAGS로 사용자 정의 링커와 옵션을 지정합니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📖 3. 주요 내용 상세
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Rust는 기본적으로 시스템 기본 링커(ld, link.exe 등)를 사용합니다.
링커는 대상 플랫폼과 C 런타임을 결정하며, 크로스 컴파일 시에는 명시적으로 지정해야 합니다.
CARGO_TARGET_X86_64_PC_WINDOWS_GNU_LINKER 환경변수나 .cargo/config.toml의 [target] 섹션으로 링커를 변경할 수 있습니다.

정적 링킹은 musl 타겟이나 RUSTFLAGS에 -C target-feature=+crt-static을 사용하여 활성화합니다.
정적 바이너리는 외부 의존성 없이 단일 파일로 배포할 수 있어 Docker alpine 이미지나 임베디드에 유리합니다.
다만 바이너리 크기가 커지고, 보안 패치 시 전체 재배포가 필요하다는 단점이 있습니다.

동적 링킹은 glibc 기반 Linux나 Windows에서 기본적으로 사용됩니다.
동적 바이너리는 작고, 시스템 라이브러리 업데이트를 자동으로 반영하지만, 배포 환경에 동일한 라이브러리 버전이 필요합니다.
Linux에서는 ldd 명령으로 동적 의존성을 확인할 수 있습니다.

LTO는 링크 단계에서 크레이트 간 최적화를 수행하여 성능을 향상시킵니다.
Cargo.toml의 [profile.release]에서 lto = true 또는 lto = "thin"으로 설정합니다.
Thin LTO는 병렬 처리가 가능하여 Full LTO보다 빠르지만, 최적화 수준은 약간 낮을 수 있습니다.
LTO를 활성화하면 컴파일 시간이 크게 증가하지만, 바이너리 크기와 런타임 성능이 개선됩니다.

링크 타임에서의 심볼 충돌이나 undefined reference 오류는 의존성 순서나 링커 옵션 부족으로 발생합니다.
Rust는 기본적으로 --extern과 -L 옵션으로 의존성을 전달하지만, 네이티브 라이브러리 연결 시에는 추가 설정이 필요할 수 있습니다.
build.rs에서 println!("cargo:rustc-link-lib=...")와 println!("cargo:rustc-link-search=...")으로 네이티브 링크를 제어합니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛠 4. 실전 활용
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

배포용 바이너리는 musl 타겟이나 crt-static으로 정적 링킹하여 의존성 문제를 제거합니다.
릴리스 프로파일에서 LTO를 활성화하여 바이너리 크기와 성능을 최적화합니다.
크로스 컴파일 시 .cargo/config.toml에서 타겟별 링커와 sysroot를 정확히 지정합니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 5. 정리
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

링킹은 Rust 바이너리 생성의 마지막 단계로, 배포 전략과 직결됩니다.
정적/동적 링킹, LTO, 링커 설정을 상황에 맞게 선택하면 최적의 배포 결과물을 얻을 수 있습니다.
링크 오류 발생 시 의존성 순서와 네이티브 라이브러리 경로를 우선 점검하세요.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔗 출처 링크
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

원문: https://doc.rust-lang.org/rustc/codegen-options/index.html#linker
Cargo Profiles: https://doc.rust-lang.org/cargo/reference/profiles.html

#Rust #Linking #StaticLinking #DynamicLinking #LTO #Deployment #번역