cowbuilder(8)							     cowdancer							     cowbuilder(8)

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)

cowdancer							    2007 Jun 17 						     cowbuilder(8)