pg_config
pg_config — 获取已安装的 PostgreSQL 版本的信息
大纲
pg_config [option...]
描述
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打印构建 PostgreSQL 时所用的
CC变量值。这显示所使用的 C 编译器。--cppflags打印构建 PostgreSQL 时所用的
CPPFLAGS变量值。这显示预处理阶段所需的 C 编译器开关(通常是-I开关)。--cflags打印构建 PostgreSQL 时所用的
CFLAGS变量值。这显示 C 编译器开关。--cflags_sl打印构建 PostgreSQL 时所用的
CFLAGS_SL变量值。这显示构建共享库时使用的额外 C 编译器开关。--ldflags打印构建 PostgreSQL 时所用的
LDFLAGS变量值。这显示链接器开关。--ldflags_ex打印构建 PostgreSQL 时所用的
LDFLAGS_EX变量值。这显示仅用于构建可执行文件的链接器开关。--ldflags_sl打印构建 PostgreSQL 时所用的
LDFLAGS_SL变量值。这显示仅用于构建共享库的链接器开关。--libs打印构建 PostgreSQL 时所用的
LIBS变量值。这通常包含外部库的-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。