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)