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

Вывести путь размещения файлов сборки расширений.

--configure

Вывести список параметров configure, использованных при сборке PostgreSQL. Это может пригодиться, чтобы при последующей сборке сделать идентичную конфигурацию. Или для того, чтобы найти с какими параметрами был собран используемый бинарный пакет. (Стоит отметить, что бинарные пакеты нередко содержат патчи, специфичные для дистрибутивов.) См. примеры ниже.

--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. Обычно оно отражает флаги подключения внешних библиотек к PostgreSQL, переданные с ключом -l.

--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 содержит символы экранирования, поэтому значения аргументов, содержащие пробелы, представлены корректно. Таким образом, применение eval необходимо для получения верного результата.