NAME
pbuilder-dist, cowbuilder-dist - multi-distribution pbuilder/cowbuilder
wrapper
SYNOPSIS
pbuilder-dist distribution [architecture] [mainonly] operation [...]
cowbuilder-dist distribution [architecture] [mainonly] operation [...]
DESCRIPTION
pbuilder-dist is a wrapper that makes it easy to use pbuilder with many
different versions of Ubuntu and/or Debian.
It is common to symlink this script in order to give it many names in
the form of pbuilder-distribution or
pbuilder-distribution-architecture, like for example pbuilder-feisty,
pbuilder-sid, pbuilder-gutsy-i386, etc.
The same applies to cowbuilder-dist, which uses cowbuilder. The main
difference between both is that pbuilder compresses the created chroot
as a a tarball, thus using less disc space but needing to uncompress
(and possibly compress) its contents again on each run, and cowbuilder
doesn't do this.
USAGE
There are many arguments listed on the synopsis; each of them, if used,
has to be used exactly in the same order as it appears there. In case
you renamed the script to pbuilder-distribution, do not use the
distribution parameter; same with i386 / amd64 if the name also
contains -architecture.
distribution
Replace this with the codename of the version of Ubuntu or
Debian you want to use.
architecture
This optional parameter will attempt to construct a chroot in a
foreign architecture. For some architecture pairs (e.g. i386 on
an amd64 install), the chroot will be created natively. For
others (e.g. armel on an i386 install), qemu-static and binfmt-
misc will be used. Note that some combinations (e.g. amd64 on
an i386 install) require special separate kernel handling, and
may break in unexpected ways.
mainonly
If you specify mainonly, only packages from the main (in Debian)
or main and restricted (in Ubuntu) components will be used. By
default, all official components are enabled. This only has
effect when creating a new environment.
operation
Replace this with the action you want pbuilder to do (create,
update, build, clean, login or execute). If you don't specify
any action, but the next argument is a .dsc file, it will assume
that it should build. Check its manpage for more details.
[...]
Replace this with other parameters, if needed. For example, if
build is the option, you will need to also specify a .dsc file.
As a special feature, if you specify a .dsc file you can skip
the build option and this script will automatically assume that
building is the action you want to do.
You may also specify --debug-echo so that the pbuilder/
cowbuilder command which would normally be executed is just
printed on the standard output instead. This is useful for
debugging pbuilder-dist.
EXAMPLES
pbuilder-dist gutsy create
Creates a pbuilder environment for Ubuntu Gutsy, with all
components enabled.
pbuilder-sid mainonly create
Creates a pbuilder environment for Debian Sid, with only the
main component.
pbuilder-feisty build ./sample_1.0-0ubuntu1.dsc
Builds the specified package on an already existing Ubuntu
Feisty environment.
pbuilder-dist feisty withlog build ./sample_1.0-0ubuntu1.dsc
Same as above, but stores pbuilder's output on a file.
pbuilder-etch i386 update
Updates an existing i386-architecture Debian Etch environment on
an amd64 system.
cowbuilder-experimental create
Creates a cowbuilder environment for Debian Experimental.
FILES AND ENVIRONMENT VARIABLES
By default, pbuilder-dist will store all the files it generates in
~/pbuilder/. This can be changed by setting the $PBUILDFOLDER global
variable. If the directory doesn't exist, it will be created on the
run.
A file with the log of the last operation, called last_operation.log,
will be saved in the results subdirectory of each build environment.
The default authentication method is sudo. You can change this by
setting the $PBUILDAUTH variable.
BUGS
If you experience any problem with this script contact me on
rainct@ubuntu.com or file a bug at
https://bugs.launchpad.net/ubuntu/+source/ubuntu-dev-tools.
Please ensure first that the problem is really this script and not an
issue with pbuilder or cowbuilder themselves.
SEE ALSO
pbuilder, pbuilderrc, cowbuilder
AUTHORS
pbuilder-dist was written by Siegfried-A. Gevatter <rainct@ubuntu.com>
and includes patches by Iain Lane <iain@orangesquash.org.uk>. This
manual page has been written by Siegfried-A. Gevatter
<rainct@ubuntu.com>.
pbuilder-dist is released under the GNU General Public License, version
2 or later.