Postgres Pro Enterprise : Документация: 9.6: pg_config : Компания Postgres Professional

pg_config
Пред.	Наверх	II. Клиентские приложения Postgres Pro	Начало	След.

pg_config

pg_config — вывести информацию об установленной версии Postgres Pro

Синтаксис

pg_config [параметр...]

Описание

Утилита pg_config выводит параметры конфигурации текущей установленной версии Postgres Pro. Это помогает, например, найти заголовочные файлы и библиотеки, требующиеся программным средствам, которые хотят взаимодействовать с Postgres Pro.

Параметры

При использовании pg_config можно передать следующие параметры:

--bindir: Вывести расположение исполняемых файлов. Можно использовать, например, для поиска утилиты psql. Обычно там же находится и сама утилита pg_config.
--docdir: Вывести расположение файлов документации.
--htmldir: Вывести расположение файлов документации в формате HTML.
--includedir: Вывести расположение заголовочных C-файлов клиентских интерфейсов.
--pkgincludedir: Вывести расположение других заголовочных C-файлов.
--includedir-server: Вывести расположение заголовочных C-файлов для программирования серверной части.
--libdir: Вывести расположение библиотек объектного кода.
--pkglibdir: Вывести расположение динамически подгружаемых модулей, либо путь, где сервер должен их искать. По этому пути также могут размещаться и другие архитектурно-зависимые файлы.
--localedir: Вывести расположение файлов поддержки локалей. Если поддержка локалей не была сконфигурирована на этапе сборки Postgres Pro, будет выведена пустая строка.
--mandir: Вывести расположение страниц руководства man.
--sharedir: Вывести расположение архитектурно-независимых вспомогательных файлов.
--sysconfdir: Вывести расположение системных конфигурационных файлов.
--pgxs: Вывести расположение файлов сборки расширений.
--configure: Вывести список параметров configure, использованных при сборке Postgres Pro. Это может пригодиться, чтобы при последующей сборке сделать идентичную конфигурацию. Или для того, чтобы найти с какими параметрами был собран используемый бинарный пакет. (Стоит отметить, что бинарные пакеты нередко содержат патчи, специфичные для дистрибутивов.) См. примеры ниже.
--cc: Вывести использованное при сборке Postgres Pro значение переменной CC. Оно отражает, какой C-компилятор применялся.
--cppflags: Вывести использованное при сборке Postgres Pro значение переменной CPPFLAGS. Оно отражает флаги C-компилятора, применённые для препроцессора. Обычно это флаги -I.
--cflags: Вывести использованное при сборке Postgres Pro значение переменной CFLAGS. Оно отражает флаги C-компилятора, применённые при сборке.
--cflags_sl: Вывести использованное при сборке Postgres Pro значение переменной CFLAGS_SL. Оно отражает дополнительные флаги C-компилятора для сборки разделяемых библиотек.
--ldflags: Вывести использованное при сборке Postgres Pro значение переменной LDFLAGS. Оно отражает флаги компоновщика.
--ldflags_ex: Вывести использованное при сборке Postgres Pro значение переменной LDFLAGS_EX. Оно отражает флаги компоновщика, использованные при сборке лишь исполняемых файлов.
--ldflags_sl: Вывести использованное при сборке Postgres Pro значение переменной LDFLAGS_SL. Оно отражает флаги компоновщика, использованные при сборке лишь разделяемых библиотек.
--libs: Вывести использованное при сборке Postgres Pro значение переменной LIBS. Обычно оно отражает флаги подключения внешних библиотек к Postgres Pro, переданные с ключом -l.
--version: Вывести версию PostgreSQL, на которой основан Postgres Pro.
--pgpro-version: Вывести версию Postgres Pro.
--pgpro-edition: Вывести редакцию Postgres Pro.
-? --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.

Пример

Чтобы воспроизвести конфигурацию сборки текущей инсталляции Postgres Pro, можно выполнить команду:

eval ./configure `pg_config --configure`

Вывод pg_config --configure содержит символы экранирования, поэтому значения аргументов, содержащие пробелы, представлены корректно. Таким образом, для получения корректного результата необходимо применить eval.

Пред.	Начало	След.
pgbench	Наверх	pg_dump

pg_config
Prev	Up	II. Postgres Pro Client Applications	Home	Next

pg_config

pg_config — retrieve information about the installed version of Postgres Pro

Synopsis

pg_config [option...]

Description

The pg_config utility prints configuration parameters of the currently installed version of Postgres Pro. It is intended, for example, to be used by software packages that want to interface to Postgres Pro to facilitate finding the required header files and libraries.

Options

To use pg_config, supply one or more of the following options:

--bindir: Print the location of user executables. Use this, for example, to find the psql program. This is normally also the location where the pg_config program resides.
--docdir: Print the location of documentation files.
--htmldir: Print the location of HTML documentation files.
--includedir: Print the location of C header files of the client interfaces.
--pkgincludedir: Print the location of other C header files.
--includedir-server: Print the location of C header files for server programming.
--libdir: Print the location of object code libraries.
--pkglibdir: Print the location of dynamically loadable modules, or where the server would search for them. (Other architecture-dependent data files might also be installed in this directory.)
--localedir: Print the location of locale support files. (This will be an empty string if locale support was not configured when Postgres Pro was built.)
--mandir: Print the location of manual pages.
--sharedir: Print the location of architecture-independent support files.
--sysconfdir: Print the location of system-wide configuration files.
--pgxs: Print the location of extension makefiles.
--configure: Print the options that were given to the configure script when Postgres Pro was configured for building. This can be used to reproduce the identical configuration, or to find out with what options a binary package was built. (Note however that binary packages often contain vendor-specific custom patches.) See also the examples below.
--cc: Print the value of the CC variable that was used for building Postgres Pro. This shows the C compiler used.
--cppflags: Print the value of the CPPFLAGS variable that was used for building Postgres Pro. This shows C compiler switches needed at preprocessing time (typically, -I switches).
--cflags: Print the value of the CFLAGS variable that was used for building Postgres Pro. This shows C compiler switches.
--cflags_sl: Print the value of the CFLAGS_SL variable that was used for building Postgres Pro. This shows extra C compiler switches used for building shared libraries.
--ldflags: Print the value of the LDFLAGS variable that was used for building Postgres Pro. This shows linker switches.
--ldflags_ex: Print the value of the LDFLAGS_EX variable that was used for building Postgres Pro. This shows linker switches used for building executables only.
--ldflags_sl: Print the value of the LDFLAGS_SL variable that was used for building Postgres Pro. This shows linker switches used for building shared libraries only.
--libs: Print the value of the LIBS variable that was used for building Postgres Pro. This normally contains -l switches for external libraries linked into Postgres Pro.
--version: Print the PostgreSQL version on which Postgres Pro is based.
--pgpro-version: Print the version of Postgres Pro.
--pgpro-edition: Print the edition of Postgres Pro.
-? --help: Show help about pg_config command line arguments, and exit.

If more than one option is given, the information is printed in that order, one item per line. If no options are given, all available information is printed, with labels.

Notes

The options --docdir, --pkgincludedir, --localedir, --mandir, --sharedir, --sysconfdir, --cc, --cppflags, --cflags, --cflags_sl, --ldflags, --ldflags_sl, and --libs were added in PostgreSQL 8.1. The option --htmldir was added in PostgreSQL 8.4. The option --ldflags_ex was added in PostgreSQL 9.0.

Example

To reproduce the build configuration of the current Postgres Pro installation, run the following command:

eval ./configure `pg_config --configure`

The output of pg_config --configure contains shell quotation marks so arguments with spaces are represented correctly. Therefore, using eval is required for proper results.

Prev	Home	Next
pgbench	Up	pg_dump