支持的版本: 当前 (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 变量的值。这通常包含链接到 PostgreSQL 的外部库的 -l 开关。

--version

打印 PostgreSQL 的版本。

-?
--help

显示有关 pg_config 命令行参数的帮助,然后退出。

如果提供了多个选项,则会按该顺序打印信息,每行一个项目。 如果未提供任何选项,则会打印所有可用信息,并带有标签。

注意

选项 --docdir--pkgincludedir--localedir--mandir--sharedir--sysconfdir--cc--cppflags--cflags--cflags_sl--ldflags--ldflags_sl--libsPostgreSQL 8.1 中添加。选项 --htmldirPostgreSQL 8.4 中添加。选项 --ldflags_exPostgreSQL 9.0 中添加。

示例

要重现当前 PostgreSQL 安装的构建配置,请运行以下命令

eval ./configure `pg_config --configure`

pg_config --configure 的输出包含 shell 引号,因此可以正确表示带有空格的参数。因此,需要使用 eval 才能获得正确的结果。

提交更正

如果您在文档中发现任何不正确的内容,与您特定功能的使用体验不符或需要进一步澄清的内容,请使用此表格报告文档问题。