LINK_WHAT_YOU_USE

版本 3.7 新增。

這是一個布林選項，當設定為 TRUE 時，會加入連結時檢查，以印出正在連結但沒有提供目標所使用符號的共享函式庫清單。這旨在作為程式碼檢查工具。

由 CMAKE_<LANG>_LINK_WHAT_YOU_USE_FLAG 指定的旗標將會傳遞給連結器，以便命令列上指定的所有函式庫都將連結到目標中。然後，由 CMAKE_LINK_WHAT_YOU_USE_CHECK 指定的命令將在目標連結後執行，以檢查二進制文件中不必要連結的共享函式庫。

注意

目前，它僅支援 ELF 平台，並且僅適用於可執行檔和共享或模組函式庫目標。此屬性將會被任何其他目標和組態忽略。

此屬性由 CMAKE_LINK_WHAT_YOU_USE 變數的值初始化，如果該變數在建立目標時設定。