NAME

       pbuilder-dist, cowbuilder-dist - multi-distribution pbuilder/cowbuilder wrapper

SYNOPSIS

       pbuilder-dist distribution [architecture] operation [options] [...]

       cowbuilder-dist distribution [architecture] operation [options] [...]

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

       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.

OPTIONS

       --main-only (deprecated: mainonly)
              If  you  specify  this  option, 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.

       --debug-echo
              The  generated  pbuilder/cowbuilder  command will be printed to the standard output
              instead of being executed. This is useful for debugging.

       --buildresult DIRECTORY (pbuilder-dist only)
              If this option is specified, the resultant files of the pbuilder build  are  placed
              in DIRECTORY.

       --release-only
              Only use the release pocket.  Default for development releases.

       --security-only
              Only  use  the  release  and  security pockets.  Suitable environment for preparing
              security updates.

       --updates-only
              Only use the release, security,  and  updates  pocket.   Not  the  proposed-updates
              pocket.

EXAMPLES

       pbuilder-dist gutsy create
              Creates a pbuilder environment for Ubuntu Gutsy, with all components enabled.

       pbuilder-sid --main-only 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 environment  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.

       By  default,  pbuilder-dist  use  the  master  Debian  and  Ubuntu  mirrors.  The pbuilder
       MIRRORSITE and OTHERMIRROR variables are supported, as are the  standard  ubuntu-dev-tools
       variables:             UBUNTUTOOLS_DEBIAN_MIRROR,             PBUILDER_DIST_DEBIAN_MIRROR,
       UBUNTUTOOLS_DEBSEC_MIRROR,     PBUILDER_DIST_DEBSEC_MIRROR,     UBUNTUTOOLS_UBUNTU_MIRROR,
       PBUILDER_DIST_UBUNTU,                 UBUNTUTOOLS_UBUNTU_PORTS_MIRROR,                 and
       PBUILDER_DIST_UBUNTU_PORTS_MIRROR.  See ubuntu-dev-tools (5) for details.

       You may also want to know that pbuilder-dist exports DIST and ARCH  environment  variables
       to  the  invoked  process,  containing  the  name of the distribution and the architecture
       targeted by the current build. You can make use of them, for example, in pbuilderrc.

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(1), pbuilderrc(5), cowbuilder(1), ubuntu-dev-tools(5).

AUTHORS

       pbuilder-dist   and   this   manual   page   were   written   by   Siegfried-A.   Gevatter
       <rainct@ubuntu.com>,  with  contributions from Iain Lane <iain@orangesquash.org.uk>, Emmet
       Hikory <persia@ubuntu.com> and others.

       pbuilder-dist is released under the GNU General Public License, version 2 or later.