MODULES #

список объектов разделяемых библиотек, собираемых из исходных файлов с тем же основа имени (не включайте суффиксы библиотек в данный список)

MODULE_big #

разделяемая библиотека, собираемая из нескольких исходных файлов (перечислите объектные файлы в OBJS)

PROGRAM #

исполняемая программа для сборки (перечислите объектные файлы в OBJS)

Также могут быть установлены следующие переменные:

Разместите этот makefile под именем Makefile в директории, в которой находится ваше расширение. Затем вы можете выполнить make для компиляции, а затем make install для установки вашего модуля. По умолчанию расширение компилируется и устанавливается для той Digital Q.DataBase инсталляции, которая соответствует первой pg_config программе найденной в вашем PATH. Вы можете использовать другую инсталляцию, установив значение PG_CONFIG так, чтобы оно указывало на её pg_config программу либо в make-файле, либо в make командной строке.

Вы также можете запустить make в директории вне дерева исходных кодов вашего расширения, если хотите хранить директорию сборки отдельно. Эта процедура также называется VPATH сборкой. Порядок действий:

mkdir build_dir
cd build_dir
make -f /path/to/extension/source/tree/Makefile
make -f /path/to/extension/source/tree/Makefile install

В качестве альтернативы вы можете настроить директорию для VPATH-сборки тем же способом, который используется для основного исходного кода. Один из способов сделать это — использовать основной сценарий config/prep_buildtree. После завершения этой процедуры сборку можно выполнить, установив make переменную VPATH следующим образом:

make VPATH=/path/to/extension/source/tree
make VPATH=/path/to/extension/source/tree install

Данная процедура позволяет работать с более широким спектром структур каталогов.

Сценарии, перечисленные в REGRESS переменной, используются для регрессионного тестирования модуля, которое можно запустить с помощью команды make installcheck после выполнения make install. Для корректной работы необходимо наличие запущенного Digital Q.DataBase сервера. Файлы сценариев, перечисленные в REGRESS должны находиться в подкаталоге с именем sql/ в каталоге расширения. Данные файлы должны иметь расширение .sql, которое не следует включать в REGRESS список в make-файле. Для каждого теста также должен существовать файл, содержащий ожидаемый результат, в подкаталоге с именем expected/также должен присутствовать файл с ожидаемым результатом, имеющий то же основное имя и расширение .out. make installcheck запускает каждый тестовый сценарий с использованием psqlи сравнивает полученный результат с соответствующим эталонным файлом. Любые расхождения будут записаны в файл regression.diffs в формате diff -c format. Обратите внимание, что попытка выполнения теста при отсутствии файла с ожидаемым результатом будет зафиксирована как «trouble», поэтому убедитесь в наличии всех необходимых эталонных файлов.

Сценарии, перечисленные в ISOLATION используются для тестов, проверяющих работу параллельных сессий с вашим модулем, которые можно инициировать с помощью make installcheck после выполнения make install. Для обеспечения корректной работы необходимо наличие запущенного экземпляра Digital Q.DataBase сервер. Файлы сценариев, указанные в ISOLATION должны находиться в подкаталоге с именем specs/ в каталоге вашего расширения. Эти файлы должны иметь расширение .spec, которое не следует включать в ISOLATION список в make-файле. Для каждого теста также должен существовать файл, содержащий ожидаемый результат, в подкаталоге с именем expected/также должен присутствовать файл с ожидаемым результатом, имеющий то же основное имя и расширение .out. make installcheck выполняет каждый сценарий тестирования и сравнивает полученный результат с соответствующим эталонным файлом. Все различия будут записаны в файл output_iso/regression.diffs в diff -c format. Обратите внимание: попытка запуска теста, для которого отсутствует эталонный файл, будет отмечена как «trouble», поэтому убедитесь в наличии всех эталонных файлов.

TAP_TESTS позволяет использовать TAP-тесты. Данные каждого запуска находятся в подкаталоге с именем tmp_check/.