configure 是 GNU Autotools 產生的專案配置腳本,掌握其核心參數是原始碼編譯安裝的關鍵。本文系統分類 40+ 常用選項,附實戰範例。
一、資訊與輔助類
| 參數 | 功能 |
--help | 顯示所有可用選項(含專案專屬選項) |
--version | 顯示生成 configure 的 Autoconf 版本 |
--quiet, --silent | 抑制配置過程輸出 |
--cache-file=FILE | 指定特性檢測快取檔案,加速重複配置 |
--no-create | 試運行(dry-run),不產生輸出檔案 |
二、安裝路徑控制(最常用)
| 參數 | 預設值 | 說明 |
--prefix=PREFIX | /usr/local | 架構獨立檔案安裝根目錄 |
--exec-prefix=EPREFIX | ${prefix} | 架構相依檔案(二進位、庫)安裝根目錄 |
--bindir=DIR | ${exec_prefix}/bin | 使用者執行檔 |
--sbindir=DIR | ${exec_prefix}/sbin | 系統管理員執行檔 |
--libexecdir=DIR | ${exec_prefix}/libexec | 程式內部呼叫的執行檔 |
--sysconfdir=DIR | ${prefix}/etc | 唯讀設定檔 |
--libdir=DIR | ${exec_prefix}/lib | 庫檔案 |
--includedir=DIR | ${prefix}/include | C/C++ 標頭檔 |
--datadir=DIR | ${prefix}/share | 架構獨立資料檔 |
--mandir=DIR | ${prefix}/man | 手冊頁 |
--infodir=DIR | ${prefix}/info | Info 文件 |
--localstatedir=DIR | ${prefix}/var | 單機可變資料 |
--sharedstatedir=DIR | ${prefix}/com | 多機共享可變資料 |
三、程式命名變換
| 參數 | 效果 |
--program-prefix=PREFIX | 安裝後程式名前綴(如 g → gtar) |
--program-suffix=SUFFIX | 安裝後程式名後綴 |
--program-transform-name=PROGRAM | sed 腳本轉換程式名 |
四、交叉編譯與平台指定
| 參數 | 用途 |
--build=BUILD | 建構機器平台(預設 = host) |
--host=HOST | 目標執行平台(預設自動偵測) |
--target=TARGET | 編譯器產出代碼平台(編譯器專用) |
五、功能啟用/停用與相依套件
| 參數 | 功能 | 範例 |
--disable-FEATURE | 停用預設啟用功能 | --disable-gui |
--enable-FEATURE[=ARG] | 啟用預設停用功能 | --enable-buffers=128 |
--with-PACKAGE[=ARG] | 指定外部套件路徑 | --with-tcl=/usr/local |
--without-PACKAGE | 禁用外部套件 | --without-gnu-ld |
六、X11 專用選項(歷史遺留)
--x-includes=DIR:X11 標頭檔目錄
--x-libraries=DIR:X11 庫目錄
七、建構目錄分離最佳實踐(三樹架構)
$ tar zxf pkg-1.0.tar.gz
$ mkdir build && cd build
$ ../pkg-1.0/configure --prefix=/opt/pkg
$ make && make install
優點:原始碼樹保持乾淨、支援多配置並行建構、便於打包分發。