PG_BUILDEXT(1) Debian PostgreSQL infrastructure PG_BUILDEXT(1)
NAME
pg_buildext - Build and install a PostgreSQL extension
SYNOPSIS
pg_buildext action srcdir target opts
DESCRIPTION
pg_buildext is a script that will build a PostgreSQL extension in a VPATH way. It supports the configure, build, install, and clean
actions, and will choose to build for the intersection of versions known in debian/pgversions (versions supported by the package) and in
/usr/share/postgresql-common/supported-versions (versions supported in this release).
OPTIONS
action
One of configure, build, install, or clean.
srcdir
Where to find the extension sources, including the debian subdirectory. (Usually $(CURDIR).) If not specified, defaults to the current
directory.
target
The target directory where to build the sources, it will get created for you if it does not exist. If the target contains a %v sign, it
will get replaced by the specific version of PostgreSQL being built against. (Usually build-%v.)
opts
%v signs in opts will get replaced as in target.
configure
Options to pass to the configure script. (Most PostgreSQL extensions do not have a configure script.)
build
Custom CFLAGS options to use for the build.
install
Package name to install for. Make will be called with DESTDIR="srcdir/debian/package".
clean
clean does not take extra options.
USAGE
As pg_buildext invokes make for the build, install, and clean actions, invocations from debian/rules (which is a makefile) should be
prefixed with + so the sub-makes can talk with the make jobserver.
EXAMPLE
build-stamp:
+pg_buildext configure $(CURDIR) build-%v "--libdir=/usr/lib/postgresql/%v/lib --datadir=/usr/share/postgresql-%v-plsh"
+pg_buildext build $(CURDIR) build-%v
install: build
+pg_buildext install $(CURDIR) build-%v postgresql-%v-plsh
clean:
+pg_buildext clean $(CURDIR) build-%v
AUTHOR
Dimitri Fontaine <dim@tapoueh.org>, with extensions by Christoph Berg <myon@debian.org>.
Debian 2012-10-08 PG_BUILDEXT(1)