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>.