bionic (8) cowbuilder.8.gz

Provided by: cowbuilder_0.86_amd64 bug

NAME

       cowbuilder - a pbuilder wrapper for cowdancer.

SYNOPSIS

       cowbuilder create [options]

       cowbuilder update [options]

       cowbuilder build [options] .dsc-file

       cowbuilder login [options]

       cowbuilder execute [options] -- script [script options]

       cowbuilder dumpconfig

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, up, u
              Update the base.cow image.

       build, b
              Build a package given a .dsc file

       login, l
              Start a session within the base.cow.

       execute, e
              Execute a command within the base.cow.

       dumpconfig
              Dump configuration information, used for debugging.

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
              This  has  a  very  different  meaning to the --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
              Workaround for Debian Etch. cow-shell will search for all files in the 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
              I: Running in no-targz mode
              Distribution is etch.
              Building the build environment
              I: 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
              I: Copying COW directory
              I: Invoking pbuilder
              W: /home/dancer/.pbuilderrc does not exist
              I: Running in no-targz mode
              I: copying local configuration
              I: mounting /proc filesystem
              I: mounting /dev/pts filesystem
              I: policy-rc.d already exists
              Refreshing the base.tgz
              I: 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
              I: Copying COW directory
              I: Invoking pbuilder
              W: /home/dancer/.pbuilderrc does not exist
              I: Running in no-targz mode
              I: copying local configuration
              I: mounting /proc filesystem
              I: mounting /dev/pts filesystem
              I: Mounting /home/dancer
              I: policy-rc.d already exists
              I: 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)