Man Linux: Main Page and Category List

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.