pkgbuild - Package Build Engine
pkgbuild [--help] [--version] [--interactive] [-v] [-vv] [-bstage] [--short-circuit] [--define "name value"] [--with-option] [--with- out-option] [--rebuild] [--pkgformat fmt] spec...
PKGBUILD(1) General Commands Manual PKGBUILD(1) NAME pkgbuild - Package Build Engine SYNOPSIS pkgbuild [--help] [--version] [--interactive] [-v] [-vv] [-bstage] [--short-circuit] [--define "name value"] [--with-option] [--with- out-option] [--rebuild] [--pkgformat fmt] spec... DESCRIPTION pkgbuild is a build engine that uses build recipes similar to rpm- build's spec file to build software components and create SVr4 or IPS binary packages. OPTIONS Miscellaneous Options --help displays a short help text --version prints the version of pkgbuild -v verbose mode -vv very verbose mode Build Options --interactive starts a subshell if a build fails allowing the user to alter the state of the build tree and then abort or continue the build -bstage build a component, exit after stage stage where stage is one of: p source tree setup (%prep only) c compile (%prep and %build) i install (%prep, %build and %install) b binary package (%prep, %build, %install and package) s source package (%prep, %build, %install and package) a binary and source package (%prep, %build, %install and package) --short-circuit start the build straight from the stage specified with the -b option, bypassing the stages leading up to it. For example --short-circuit -bi will run the %install section only, bypass- ing %prep and %build and exiting after %install. --rebuild rebuild a source package --pkgformat fmt create the binary and source packages using the fmt package for- mat, where fmt is one of: filesystem, fs SVr4 filesystem format datastream, ds SVr4 datastream format ips Image Packaging System package Build Features --define "name value" defines a macro called name and assigns value as the macro value before reading the spec file(s). --with-option same as --define "_with_option --with-option" --without-option same as --define "_without_option --without-option" EXAMPLES Example 1: set up the source tree for foo.spec: pkgbuild -bp foo.spec Example 2: build bar.spec with debug options: pkgbuild --with-debug -ba bar.spec ENVIRONMENT VARIABLES The following environment variables affect the execution of pkgbuild: PKGBUILD_IPS_SERVER the server to post IPS binary packages to, defaults to the local repository PKGBUILD_SRC_IPS_SERVER the server to post IPS source packages to, defaults to PKG- BUILD_IPS_SERVER EXIT STATUS The following exit values are returned: 1 ERROR 2 ERROR sending package to IPS server 3 ERROR closing transaction with IPS server 0 OK FILES /usr/bin/pkgbuild executable for pkgbuild ~/.pkgbuildmacros user defined macros. The format of this file is on definition per line in the following format: %macro_name value ATTRIBUTES See attributes(7) for descriptions of the following attributes: +--------------------+------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +--------------------+------------------+ |Availability | package/pkgbuild | +--------------------+------------------+ |Interface Stability | Volatile | +--------------------+------------------+ ATTRIBUTES See attributes(7) for descriptions of the following attributes: +---------------+------------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | +---------------+------------------+ |Availability | package/pkgbuild | +---------------+------------------+ |Stability | Uncommitted | +---------------+------------------+ SEE ALSO Spec file description in /usr/share/doc/pkgbuild/spec-files.txt attributes(7), pkgtool(1), spectool(1), pkg(7), pkgmk(1) NOTES Written by Laszlo (Laca) Peter, Oracle Corporation, 2010 Source code for open source software components in Oracle Solaris can be found at https://www.oracle.com/downloads/opensource/solaris-source- code-downloads.html. This software was built from source available at https://github.com/oracle/solaris-userland. The original community source was downloaded from http://prdownloads.sourceforge.net/pkg- build/pkgbuild-1.3.105.tar.bz2. Further information about this software can be found on the open source community website at http://pkgbuild.sourceforge.net/. May 17, 2010 PKGBUILD(1)