NAME

       cowbuilder - a pbuilder wrapper for cowdancer.

SYNOPSIS

       cowbuilder [commands] [options]

DESCRIPTION

       cowbuilder Executes the specified pbuilder operation with cowdancer

COMMANDS

       Most  commands  invoke  pbuilder  with  the  specified  commands,  see pbuilder manual for
       details.

       --create

              Create the base.cow image.  The directory for base.cow should  be  empty,  or  this
              command will fail.

       --update

              Update the base.cow image.

       --build .dsc-file

              Build a package given a .dsc file

       --login

              Start a session within the base.cow.

       --execute

              Execute a command within the base.cow.

       --dumpconfig

              dump configuration information.

OPTIONS

       Most  options  are  the  same  as  pbuilder,  except  for  the following which are handled
       specially

       --buildplace

              The place where COW operation takes place.

       --basepath
              has a very different meaning to basetgz option of pbuilder, since there is no  tgz.
              This  option  specifies  the  directory in which the COW master data is stored, the
              default being /var/cache/pbuilder/base.cow

       --configfile [configuration file to load]
              Additional configuration file to read after all other configuration files have been
              read.

       --no-cowdancer-update

              Do  not use cowdancer on cowbuilder --update. Please use this option when cowdancer
              is interfering with upgrade process, or cowdancer itself is being  upgraded  within
              chroot.

       --debian-etch-workaround

              Work  around  on  Debian etch compatibility. cow-shell will search for all files in
              chroot, but will work.

CONFIGURATION FILES

       cowbuilder reads the following configuration files per default.

       /usr/share/pbuilder/pbuilderrc
              Application default, not to be changed.

       /etc/pbuilderrc
              System-wide default.

       ~/.pbuilderrc
              User default

       anything specified with --configfile option
              Additional configuration at runtime.

CONFIGURATION FILE OPTIONS

       The possible configuration options are as follows.  Others are ignored.

       DISTRIBUTION=distribution

       BUILDRESULT=directory

       BUILDPLACE=directory

       BASEPATH=path

       MIRRORSITE=http://mirror

       NO_COWDANCER_UPDATE=1

              See --no-cowdancer-update

       DEBIAN_ETCH_WORKAROUND=1

              See --debian-etch-workaround

EXAMPLES

       cowbuilder --create
              Create a base.cow image.

              # cowbuilder --create --hookdir /usr/share/doc/pbuilder/examples/workaround/ --distribution etch --debootstrap debootstrap --basepath /var/cache/pbuilder/base-test.cow
              bash: /root/.pbuilderrc: No such file or directory
              W: /home/dancer/.pbuilderrc does not exist
               -> Running in no-targz mode
              Distribution is etch.
              Building the build environment
               -> running debootstrap
              /usr/sbin/debootstrap
              I: Retrieving Release
                   .
                   .

       cowbuilder --update
              Update the base.cow image.

              # cowbuilder --update
              bash: /root/.pbuilderrc: No such file or directory
               -> Copying COW directory
               -> Invoking pbuilder
              W: /home/dancer/.pbuilderrc does not exist
               -> Running in no-targz mode
               -> copying local configuration
               -> mounting /proc filesystem
               -> mounting /dev/pts filesystem
               -> policy-rc.d already exists
              Refreshing the base.tgz
               -> upgrading packages
                   .
                   .

       cowbuilder --build test_0.1.dsc
              Build the package specified in dsc file, with the base.cow image.

       pdebuild --pbuilder cowbuilder
              Run
              cowbuilder --build
              against the current directory.
              The current directory should be an extracted Debian source package directory.

              Edit
              /etc/pbuilderrc
              to have
              PDEBUILD_PBUILDER=cowbuilder
              to make this the default behavior for
              pdebuild.

       cowbuilder --login --bindmounts /home/dancer
              Start a cow-shell session inside base.cow, with
              /home/dancer
               being bind-mounted to within chroot.

              Note that cowbuilder will not cow-protect what is inside
              /home/

              # cowbuilder --login --bindmount ${HOME}
              bash: /root/.pbuilderrc: No such file or directory
               -> Copying COW directory
               -> Invoking pbuilder
              W: /home/dancer/.pbuilderrc does not exist
               -> Running in no-targz mode
               -> copying local configuration
               -> mounting /proc filesystem
               -> mounting /dev/pts filesystem
              -> Mounting /home/dancer
               -> policy-rc.d already exists
               -> entering the shell
              #

       cowbuilder --create --distribution sid --basepath /var/cache/pbuilder/base-test.cow
              Create a base.cow image with the path
              /var/cache/pbuilder/base-test.cow
              and distribution sid.

AUTHOR

       Junichi Uekawa (dancer@debian.org)

SEE ALSO

       /usr/share/doc/pbuilder/pbuilder-doc.html, pbuilder (8), pdebuild (1)