ldd 是檢查可執行檔或共享庫動態依賴關係的標準工具，本質是設定環境變數 LD_TRACE_LOADED_OBJECTS=1 後執行動態連結器 /lib/ld-linux.so.*。本文詳細說明參數用法、環境變量原理、庫搜尋順序、輸出解讀與常見問題排查。

基本用法與參數

ldd [選項] 檔案...
# 參數
--version          # 顯示版本
-v, --verbose      # 詳細輸出 (含符號版本)
-d, --data-relocs  # 執行資料重定位，報告缺失目標 (僅 ELF)
-r, --function-relocs # 執行函數重定位，報告缺失目標與函數 (僅 ELF)
-u, --unused       # 顯示未使用的直接依賴
--help             # 使用說明

核心原理：環境變數觸發動態連結器自省

# 手動模擬 ldd 行為
export LD_TRACE_LOADED_OBJECTS=1
ls /usr
# 輸出與 ldd ls 相同
unset LD_TRACE_LOADED_OBJECTS
ls /usr  # 恢復正常執行

相關環境變數：

• LD_TRACE_LOADED_OBJECTS=1：觸發依賴列印 (必要)。
• LD_WARN：-d 對應。
• LD_BIND_NOW：-r 對應 (立即綁定)。
• LD_VERBOSE：-v 對應。
• LD_DEBUG：除錯輸出 (如 LD_DEBUG=libs ldd ls)。

輸出解讀範例

$ ldd /bin/bash
linux-vdso.so.1 => (0x00007ffc12345000)
libtinfo.so.6 => /lib/x86_64-linux-gnu/libtinfo.so.6 (0x00007f8e12345000)
libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2 (0x00007f8e12140000)
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f8e11d80000)
/lib64/ld-linux-x86-64.so.2 (0x00007f8e12560000)

• => 左側：所需庫 (soname)；右側：實際解析路徑與載入位址。
• not found：依賴缺失，**程式無法啟動**。
• linux-vdso.so.1：虛擬動態共享物件 (vdso)，核心提供的用戶態系統呼叫加速介面，無實體檔案。
• /lib64/ld-linux-x86-64.so.2：動態連結器本身。

動態連結器庫搜尋順序 (優先級遞減)

1. DT_RPATH / DT_RUNPATH：編譯時嵌入的路徑 (-Wl,-rpath)。RUNPATH 受 LD_LIBRARY_PATH 影響，RPATH 不受。
2. LD_LIBRARY_PATH：環境變數指定目錄 (冒號分隔)、**臨時測試用**，生產環境避免使用。
3. /etc/ld.so.cache：ldconfig 建立的快取索引，含標準路徑 (/lib, /usr/lib) 及 /etc/ld.so.conf.d/*.conf 設定的路徑。若連結時加 -z nodeflib 則跳過。
4. 預設路徑：/lib, /usr/lib (及架構專用 /lib64, /usr/lib64)。

直接呼叫動態連結器 (等效 ldd)

/lib64/ld-linux-x86-64.so.2 --list /bin/ls
# 或
/lib/ld-linux.so.2 --list /bin/bash  # 32 位

常見問題與排查

最佳實踐

• 建置時使用 -Wl,-rpath='$ORIGIN/../lib' 相對路徑，避免部署路徑依賴。
• 部署時將私有庫置於專屬目錄，透過 ld.so.conf.d 納入快取。
• 定期執行 ldd -r 檢查生產環境二進制完整性。
• 容器化部署時確保基底映像含必要庫版本。

總結：ldd 透過環境變數觸發動態連結器自省，掌握其搜尋順序與環境變數機制，能快速定位「找不到共享庫」、「版本衝突」、「路徑錯配」等經典部署故障，是 Linux 開發運維必備診斷工具。