支援的版本:目前 (17) / 16 / 15 / 14 / 13
開發版本:devel
不支援的版本:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1

pg_config

pg_config — 檢索關於已安裝 PostgreSQL 版本的資訊

概要

pg_config [選項...]

描述

pg_config 工具會列印目前已安裝的 PostgreSQL 版本的組態參數。例如,它旨在供想要與 PostgreSQL 介面的軟體套件使用,以方便尋找所需的標頭檔和函式庫。

選項

若要使用 pg_config,請提供下列一或多個選項

--bindir

列印使用者可執行檔的位置。例如,使用它來尋找 psql 程式。這通常也是 pg_config 程式所在的位置。

--docdir

列印說明文件檔案的位置。

--htmldir

列印 HTML 說明文件檔案的位置。

--includedir

列印客戶端介面的 C 標頭檔的位置。

--pkgincludedir

列印其他 C 標頭檔的位置。

--includedir-server

列印伺服器程式設計的 C 標頭檔的位置。

--libdir

列印物件碼函式庫的位置。

--pkglibdir

列印動態可載入模組的位置,或伺服器會搜尋它們的位置。(其他與架構相關的資料檔案也可能安裝在此目錄中。)

--localedir

列印語言環境支援檔案的位置。(如果建置 PostgreSQL 時未配置語言環境支援,則這將會是空字串。)

--mandir

列印手冊頁面的位置。

--sharedir

列印與架構無關的支援檔案的位置。

--sysconfdir

列印系統範圍組態檔案的位置。

--pgxs

列印延伸模組 makefile 的位置。

--configure

列印在配置 PostgreSQL 以進行建置時,提供給 configure 指令碼的選項。這可以用於重現相同的組態,或找出二進位套件的建置選項。(但請注意,二進位套件通常包含供應商特定的自訂修補程式。)另請參閱以下範例。

--cc

列印用於建置 PostgreSQLCC 變數的值。這會顯示使用的 C 編譯器。

--cppflags

列印用於建置 PostgreSQLCPPFLAGS 變數的值。這會顯示預處理時間所需的 C 編譯器開關(通常為 -I 開關)。

--cflags

列印用於建置 PostgreSQLCFLAGS 變數的值。這會顯示 C 編譯器開關。

--cflags_sl

列印用於建置 PostgreSQLCFLAGS_SL 變數的值。這會顯示用於建置共用函式庫的額外 C 編譯器開關。

--ldflags

列印用於建置 PostgreSQLLDFLAGS 變數的值。這會顯示連結器開關。

--ldflags_ex

列印用於建置 PostgreSQLLDFLAGS_EX 變數的值。這會顯示僅用於建置可執行檔的連結器開關。

--ldflags_sl

列印用於建置 PostgreSQLLDFLAGS_SL 變數的值。這會顯示僅用於建置共用函式庫的連結器開關。

--libs

列印用於建置 PostgreSQLLIBS 變數的值。這通常包含 -l 開關,用於連結到 PostgreSQL 中的外部函式庫。

--version

列印 PostgreSQL 的版本。

-?
--help

顯示關於 pg_config 命令列引數的說明,並結束。

如果提供多個選項,資訊會依該順序列印,每行一個項目。如果未提供任何選項,則會列印所有可用的資訊,並附帶標籤。

備註

選項 --docdir--pkgincludedir--localedir--mandir--sharedir--sysconfdir--cc--cppflags--cflags--cflags_sl--ldflags--ldflags_sl--libs 已在 PostgreSQL 8.1 中新增。選項 --htmldir 已在 PostgreSQL 8.4 中新增。選項 --ldflags_ex 已在 PostgreSQL 9.0 中新增。

範例

若要重現目前 PostgreSQL 安裝的建置組態,請執行下列命令

eval ./configure `pg_config --configure`

pg_config --configure 的輸出包含 shell 引號,以便正確表示帶有空格的參數。 因此,需要使用 eval 才能獲得正確的結果。

提交更正

如果您在文件中發現任何不正確、與您對特定功能的體驗不符或需要進一步澄清的地方,請使用此表格回報文件問題。