Разместить все файлы внутри каталога ПРЕФИКС, а не в /usr/local/pgsql. Собственно файлы будут установлены в различные подкаталоги этого каталога; в самом каталоге ПРЕФИКС никакие файлы не размещаются.

Вы можете установить архитектурно-зависимые файлы в размещение с другим префиксом, ИСП-ПРЕФИКС, отличным от ПРЕФИКС. Это бывает полезно для совместного использования таких файлов несколькими системами. По умолчанию ИСП-ПРЕФИКС считается равным ПРЕФИКС и все файлы, архитектурно-зависимые и независимые, устанавливаются в одно дерево каталогов, что вам скорее всего и нужно.

Задаёт каталог для исполняемых двоичных программ. По умолчанию это ИСП-ПРЕФИКС/bin, что обычно означает /usr/local/pgsql/bin.

Задаёт каталог для различных файлов конфигурации, ПРЕФИКС/etc по умолчанию.

Задаёт каталог для установки библиотек и динамически загружаемых модулей. Значение по умолчанию — ИСП-ПРЕФИКС/lib.

Задаёт каталог для установки заголовочных файлов C и C++. Значение по умолчанию — ПРЕФИКС/include.

Задаёт корневой каталог для разного рода статических файлов. Этот параметр определяет только базу для некоторых из следующих параметров. Значение по умолчанию — ПРЕФИКС/share.

Задаёт каталог для статических файлов данных, используемых установленными программами. Значение по умолчанию — DATAROOTDIR. Заметьте, что это совсем не тот каталог, в котором будут размещены файлы базы данных.

Задаёт каталог для установки данных локализации, в частности, каталогов перевода сообщений. Значение по умолчанию — DATAROOTDIR/locale.

Страницы man, поставляемые в составе PostgreSQL, будут установлены в этот каталог, в соответствующие подкаталоги manx. Значение по умолчанию — DATAROOTDIR/man.

Задаёт корневой каталог для установки файлов документации, кроме страниц «man». Этот параметр только определяет базу для следующих параметров. Значение по умолчанию — DATAROOTDIR/doc/postgresql.

В этот каталог будет помещена документация PostgreSQL в формате HTML. Значение по умолчанию — DATAROOTDIR.

Включает поддержку национальных языков (NLS, Native Language Support), то есть возможность выводить сообщения программы не только на английском языке. Значение ЯЗЫКИ представляет необязательный список кодов языков через пробел, поддержка которых вам нужна, например: --enable-nls='de fr ru'. (Пересечение заданного вами списка и множества действительно доступных переводов будет вычислено автоматически.) Если список не задаётся, устанавливаются все доступные переводы.

Для использования этой возможности вам потребуется реализация API Gettext.

Включает поддержку языка PL/Perl на стороне сервера.

Включает поддержку языка PL/Python на стороне сервера.

Включает поддержку языка PL/Tcl на стороне сервера.

Tcl устанавливает файл tclConfig.sh, содержащий конфигурационные данные, необходимые для сборки модулей, взаимодействующих с Tcl. Этот файл обычно находится автоматически в известном размещении, но если вы хотите использовать другую версию Tcl, вы должны указать каталог, где искать tclConfig.sh.

Включает поддержку библиотеки ICU, что позволяет использовать правила сортировки ICU (см. Раздел 24.2). Для этого должен быть установлен пакет ICU4C. В настоящее время требуется ICU4C версии не ниже 4.2.

По умолчанию для определения нужных параметров компиляции будет использоваться pkg-config. Этот вариант работает для ICU4C версии 4.6 и новее. Для более старых версий или в отсутствие pkg-config соответствующие параметры для configure можно задать в переменных ICU_CFLAGS и ICU_LIBS, как в этом примере:

./configure ... --with-icu ICU_CFLAGS='-I/путь/include' ICU_LIBS='-L/путь/lib -licui18n -licuuc -licudata'

(Даже если ICU4C находится в пути поиска, который использует компилятор, тем не менее нужно задать непустые значения, чтобы избежать обращения к pkg-config, например, ICU_CFLAGS=' '.)

Включает поддержку JIT-компиляции (см. Главу 32) на базе LLVM. Для этого должна быть установлена библиотека LLVM. В настоящее время требуется версия LLVM не ниже 3.9.

Программа llvm-config будет использоваться для выяснения требуемых параметров компиляции. Поиск её будет выполняться в заданных путях PATH по имени llvm-config, а затем llvm-config-$major-$minor для всех поддерживаемых версий. Если нужную программу найти таким образом не удастся, воспользуйтесь переменной LLVM_CONFIG и укажите путь к корректному llvm-config. Например:

./configure ... --with-llvm LLVM_CONFIG='/path/to/llvm/bin/llvm-config'

Для поддержки LLVM требуется совместимый компилятор clang (указываемый, если это требуется, в переменной окружения CLANG) и работающий компилятор C++ (указываемый, если требуется, в переменной окружения CXX).

Собрать с поддержкой сжатия LZ4.

Собрать с поддержкой сжатия Zstandard.

Включает поддержку соединений SSL (зашифрованных). Единственной поддерживаемой БИБЛИОТЕКОЙ является openssl. Для такой сборки необходимо установить пакет OpenSSL. Скрипт configure проверит наличие необходимых заголовочных файлов и библиотек, чтобы убедиться в целостности инсталляции OpenSSL до начала сборки.

Устаревший вариант указания --with-ssl=openssl.

Включает поддержку аутентификации GSSAPI. На многих платформах подсистема GSSAPI (обычно входящая в состав Kerberos) устанавливается не в то размещение, которое просматривается по умолчанию (например, /usr/include, /usr/lib), так что помимо этого параметра вам придётся задать параметры --with-includes и --with-libraries. Скрипт configure проверит наличие необходимых заголовочных файлов и библиотек, чтобы убедиться в целостности инсталляции GSSAPI, прежде чем продолжить.

Включает поддержку LDAP для проверки подлинности и получения параметров соединения (за дополнительными сведениями обратитесь к Разделу 34.18 и Разделу 21.10). В Unix для этого нужно установить пакет OpenLDAP. В Windows используется стандартная библиотека WinLDAP. Скрипт configure проверит наличие необходимых заголовочных файлов и библиотек, чтобы убедиться в целостности инсталляции OpenLDAP, прежде чем продолжить.

Включает поддержку PAM (Pluggable Authentication Modules, подключаемых модулей аутентификации).

Включает поддержку аутентификации BSD. (Инфраструктура аутентификации BSD в настоящее время доступна только в OpenBSD.)

Включает поддержку служебных уведомлений для systemd. Это улучшает интеграцию с системой, когда сервер запускается под управлением systemd, и не оказывает никакого влияния в противном случае; за дополнительными сведениями обратитесь к Разделу 19.3. Для использования этой поддержки в системе должна быть установлена libsystemd с сопутствующими заголовочными файлами.

Включает поддержку Bonjour, протокола автоматического обнаружения служб. Для этого Bonjour должен поддерживаться самой операционной системой. Рекомендуется для macOS.

Собрать модуль uuid-ossp (предоставляющий функции для генерирования UUID), используя заданную библиотеку UUID. БИБЛИОТЕКА может быть следующей:

Устаревший вариант указания --with-uuid=ossp.

Собрать с libxml2, включая тем самым поддержку SQL/XML. Для этого требуется libxml версии 2.6.23 или новее.

Для определения нужных параметров компиляции и компоновки PostgreSQL обратится к pkg-config, если эта программа установлена, и запросит у неё информацию о libxml2. В противном случае будет вызвана программа xml2-config, входящая в состав libxml2. Вариант с pkg-config предпочтительнее, так как он лучше работает в конфигурации сборки для разных архитектур.

Для использования libxml2 в нестандартном размещении вы можете задать переменные окружения для pkg-config (см. документацию pkg-config) или указать в переменной окружения XML2_CONFIG путь к программе xml2-config, относящейся к нужной инсталляции libxml2, либо задать непосредственно переменные XML2_CFLAGS и XML2_LIBS. (Если программа pkg-config установлена, переопределить предоставляемую ей информацию о нахождении libxml2 можно, установив переменную XML2_CONFIG или присвоив непустые значения обеим переменным XML2_CFLAGS и XML2_LIBS.)

Собрать с libxslt, включая тем самым возможность выполнять XSL-преобразования XML-документов в модуле xml2. Для этого также должен быть указан ключ --with-libxml.

Запрещает использование библиотеки Readline (а также libedit). При этом отключается редактирование командной строки и история в psql.

Отдаёт предпочтение библиотеке libedit с лицензией BSD, а не Readline (GPL). Этот параметр имеет значение, только если установлены обе библиотеки; по умолчанию в этом случае используется Readline.

Запрещает использование библиотеки Zlib. При этом отключается поддержка сжатых архивов утилитами pg_dump и pg_restore.

Позволяет провести сборку, если PostgreSQL не может воспользоваться циклическими блокировками CPU на данной платформе. Отсутствие таких блокировок приводит к кардинальному снижению производительности, поэтому использовать этот вариант следует, только если сборка прерывается и выдаётся сообщение, что ваша платформа эти блокировки не поддерживает. Если вы не можете собрать PostgreSQL на вашей платформе без этого указания, сообщите о данной проблеме разработчикам PostgreSQL.

Отключает использование атомарных операций процессора. На архитектурах, где такие операции отсутствуют, этот параметр никак не действует. Там же, где они поддерживаются, отказ от их использования приведёт к падению производительности. Этот параметр полезен только для отладки и для сравнительной оценки быстродействия.

Отключает потокобезопасное поведение клиентских библиотек. При этом параллельные потоки программ на базе libpq и ECPG не будут безопасно контролировать собственные дескрипторы соединений. Используйте это только на тех платформах, где отсутствует полноценная поддержка потоков.

Значение КАТАЛОГИ представляет список каталогов через двоеточие, которые будут просмотрены компилятором при поиске заголовочных файлов. Если дополнительные пакеты (например, GNU Readline) установлены у вас в нестандартное расположение, вам придётся использовать этот параметр и, возможно, также добавить соответствующий параметр --with-libraries.

Пример: --with-includes=/opt/gnu/include:/usr/sup/include.

Значение КАТАЛОГИ представляет список каталогов через двоеточие, в котором следует искать библиотеки. Возможно, вам потребуется использовать этот параметр (и соответствующий --with-includes), если какие-то пакеты установлены у вас в нестандартное размещение.

Пример: --with-libraries=/opt/gnu/lib:/usr/sup/lib.

В PostgreSQL включена собственная база данных часовых поясов, необходимая для операций с датой и временем. На самом деле эта база данных совместима с базой часовых поясов IANA, поставляемой в составе многих операционных систем FreeBSD, Linux, Solaris, поэтому устанавливать её дополнительно может быть излишне. С этим параметром вместо базы данных, включённой в пакет исходного кода PostgreSQL, будет использоваться системная база данных часовых поясов, находящаяся в заданном КАТАЛОГЕ. КАТАЛОГ должен задаваться абсолютным путём (в ряде операционных систем принят путь /usr/share/zoneinfo). Заметьте, что процедура установки не будет проверять несоответствия или ошибки в данных часовых поясов. Поэтому, используя этот параметр, рекомендуется выполнить регрессионные тесты, чтобы убедиться, что выбранная вами база данных часовых поясов работает корректно с PostgreSQL.

Этот параметр в основном предназначен для тех, кто собирает двоичные пакеты для дистрибутивов и хорошо знает свою операционную систему. Основной плюс от использования системных данных в том, что пакет PostgreSQL не придётся обновлять при изменениях местных определений часовых поясов. Ещё один плюс заключается в упрощении кросс-компиляции, так как при инсталляции не требуется собирать базу данных часовых поясов.

Заданная СТРОКА добавляется к номеру версии PostgreSQL. Это можно использовать, например, чтобы двоичные файлы, собранные из промежуточных снимков Git или кода с дополнительными правками, отличались от стандартных дополнительной строкой в версии, например, содержащей идентификатор git describe или номер выпуска дистрибутивного пакета.

Не добавлять в исполняемые файлы PostgreSQL атрибут, с которым они будут искать разделяемые библиотеки в каталоге библиотек инсталляции (см. --libdir). На большинстве платформ этот атрибут задаёт абсолютный путь к каталогу библиотек, поэтому этот вариант не подходит, если вы намерены перемещать готовую инсталляцию. Однако вам в любом случае нужно каким-то образом указать, где исполняемые файлы могут найти разделяемые библиотеки. Обычно для этого нужно настроить механизм динамического связывания в операционной системе, указав нужный каталог библиотек; за подробностями обратитесь к Подразделу 17.5.1.

Задаёт НОМЕР порта по умолчанию для сервера и клиентов. Стандартное значение — 5432. Этот порт всегда можно изменить позже, но если вы укажете другой номер здесь, и сервер, и клиенты будут скомпилированы с одним значением, что очень удобно. Обычно менять это значение имеет смысл, только если вы намерены запускать в одной системе несколько серверов PostgreSQL.

Задаёт имя по умолчанию для субъекта-службы Kerberos, используемое GSSAPI (по умолчанию это postgres). Обычно менять его имеет смысл только в сборке для среды Windows, где оно должно быть задано в верхнем регистре (POSTGRES).

Задаёт размер сегмента (в гигабайтах). Сервер делит большие таблицы на несколько файлов в файловой системе, ограничивая размер каждого данным размером сегмента. Это позволяет обойти ограничения на размер файлов, существующие на многих платформах. Размер сегмента по умолчанию, 1 гигабайт, безопасен для всех поддерживаемых платформ. Если же ваша операционная система поддерживает «большие файлы» (а сегодня это поддерживают почти все), вы можете установить больший размер сегмента. Это позволит уменьшить число файловых дескрипторов, используемых при работе с очень большими таблицами. Но будьте осторожны, чтобы выбранное значение не превысило максимум, поддерживаемый вашей платформой и файловыми системами, которые вы будете применять. Возможно, допустимый размер файла будет ограничиваться и другими утилитами, которые вы захотите использовать, например tar. Рекомендуется, хотя и не требуется, чтобы это значение было степенью 2. Заметьте, что с изменением этого значения нарушается совместимость формата базы на диске, то есть вы не сможете использовать pg_upgrade для перехода к сборке с другим размером сегмента.

Задаёт размер блока (в килобайтах). Эта величина будет единицей хранения и ввода/вывода данных таблиц. Значение по умолчанию, 8 килобайт, достаточно универсально; но в особых случаях может быть оправдан другой размер блока. Это значение должно быть степенью 2 от 1 до 32 (в килобайтах). Заметьте, что с изменением этого значения нарушается совместимость формата базы на диске, то есть вы не сможете использовать pg_upgrade для перехода к сборке с другим размером блока.

Задаёт размер блока WAL (в килобайтах) Эта величина будет единицей хранения и ввода/вывода записей WAL. Значение по умолчанию, 8 килобайт, достаточно универсально; но в особых случаях может быть оправдан другой размер блока. Это значение должно быть степенью 2 от 1 до 64 (в килобайтах). Заметьте, что с изменением этого значения нарушается совместимость формата базы на диске, то есть вы не сможете использовать pg_upgrade для перехода к сборке с другим размером блока WAL.

Включает компиляцию всех программ и библиотек с отладочными символами. Это значит, что вы сможете запускать программы в отладчике для анализа проблем. При такой компиляции размер установленных исполняемых файлов значительно увеличивается, а компиляторы, кроме GCC, обычно отключают оптимизацию, что снижает быстродействие. Однако наличие отладочных символов очень полезно при решении возможных проблем любой сложности. В настоящее время рекомендуется использовать этот параметр для производственной среды, только если применяется компилятор GCC. Но если вы занимаетесь разработкой или испытываете бета-версию, его следует использовать всегда.

Включает для сервера проверочные утверждения, проверяющие множество условий, которые «не должны происходить». Это бесценно в процессе разработки кода, но эти проверки могут значительно замедлить работу сервера. Кроме того, включение этих проверок не обязательно увеличит стабильность вашего сервера! Проверочные утверждения не категоризируются по важности, поэтому относительно безвредная ошибка может привести к перезапуску сервера, если утверждение не выполнится. Применять это следует, только если вы занимаетесь разработкой или испытываете бета-версию, но не в производственной среде.

Включает тесты по технологии Perl TAP. Для этого у вас должен быть установлен Perl и модуль IPC::Run. За дополнительными сведениями обратитесь к Разделу 33.4.

Включает автоматическое отслеживание зависимостей. С этим параметром скрипты Makefile настраиваются так, чтобы при изменении любого заголовочного файла пересобирались все зависимые объектные файлы. Это полезно в процессе разработки, но если вам нужно только скомпилировать и установить сервер, это будет лишней тратой времени. В настоящее время это работает только с GCC.

При использовании GCC все программы и библиотеки компилируются с инструментарием, оценивающим покрытие кода тестами. Если его запустить, в каталоге сборки будут сформированы файлы с метриками покрытия кода. За дополнительными сведениями обратитесь к Разделу 33.5. Этот параметр предназначен только для GCC и только для использования в процессе разработки.

При использовании GCC все программы и библиотеки компилируются так, чтобы их можно было профилировать. В результате по завершении серверного процесса будет создаваться подкаталог с файлом gmon.out, содержащим данные для профилирования. Этот параметр предназначен только для GCC и только для тех, кто занимается разработкой.

Включает при компиляции PostgreSQL поддержку средства динамической трассировки DTrace. За дополнительными сведениями обратитесь к Разделу 28.5.

Задать расположение программы dtrace можно в переменной окружения DTRACE. Часто это необходимо, потому что dtrace обычно устанавливается в каталог /usr/sbin, который может отсутствовать в PATH.

Дополнительные параметры командной строки для dtrace можно задать в переменной окружения DTRACEFLAGS. В Solaris, чтобы включить поддержку DTrace для 64-битной сборки, необходимо передать параметр DTRACEFLAGS="-64". Например, с компилятором GCC:

./configure CC='gcc -m64' --enable-dtrace DTRACEFLAGS='-64' ...

С компилятором Sun:

./configure CC='/opt/SUNWspro/bin/cc -xtarget=native64' --enable-dtrace DTRACEFLAGS='-64' ...