cowbuilder - a pbuilder wrapper for cowdancer.

       Junichi Uekawa (dancer@debian.org)

       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.

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

       DISTRIBUTION=distributionBUILDRESULT=directoryBUILDPLACE=directoryBASEPATH=pathMIRRORSITE=http://mirrorNO_COWDANCER_UPDATE=1
              See --no-cowdancer-updateDEBIAN_ETCH_WORKAROUND=1
              See --debian-etch-workaround

       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

       anythingspecifiedwith--configfileoption
              Additional configuration at runtime.

cowbuilder Executes the specified pbuilder operation with cowdancer

cowbuildercreate
              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
                   .
                   .

       cowbuilderupdate
              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
                   .
                   .

       cowbuilderbuildtest_0.1.dsc
              Build the package specified in dsc file, with the base.cow image.

       pdebuild--pbuildercowbuilder
              Run cowbuilderbuild 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.cowbuilderlogin--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
              #

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

       cowbuilder - a pbuilder wrapper for cowdancer.

       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[configurationfiletoload]
              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.

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

cowdancer                                          2007 Jun 17                                     cowbuilder(8)

cowbuildercreate[options]cowbuilderupdate[options]cowbuilderbuild[options].dsc-filecowbuilderlogin[options]cowbuilderexecute[options]--script[scriptoptions]cowbuilderdumpconfig