qemubuilder(8) [debian man page]
qemubuilder(8) pbuilder qemubuilder(8) NAME
qemubuilder - a pbuilder wrapper for qemu. SYNOPSIS
qemubuilder [commands] [options] DESCRIPTION
qemubuilder Executes the specified pbuilder operation with qemu COMMANDS
Most commands imitate pbuilder, see pbuilder manual for details. --create Create the base.qemu image. --update Update the base.qemu image. --build .dsc-file Build a package given a .dsc file --login Start a session within the base.qemu. --execute Execute a command within the base.qemu. --dumpconfig dump configuration information. --arch-diskdevice sd/hd specify whether disk device inside the virtual machine is called /dev/sda or /dev/hda. The possible value is 'sd' or 'hd'. --smp 2 The option passed to SMP. OPTIONS
Most options are the same as pbuilder, except for the following which are handled specially. SMP 2 The SMP option for qemu. I don't think I can support bind-mounts in qemu. Documentation here should be updated according to what's defined in parameter.c, but it isn't. CONFIGURATION FILES
qemubuilder 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 KERNEL_IMAGE=vmlinuz Linux kernel to use. INITRD=initrd initrd to use. ARCHITECTURE=arch The target architecture. You can also use ARCH=arch for compatibility with 0.60 or older. MEMORY_MEGS=64 memory size to use in qemu session, in MB. ARCH_DISKDEVICE=hd The architecture-specific disk device specifier. Most arches use sd these days. The only exceptions were i386 and amd64, which used to use hd. EXAMPLES
qemubuilder --create Create a base.qemu image. qemubuilder --update Update the base.qemu image. qemubuilder --build test_0.1.dsc Build the package specified in dsc file, with the base.qemu image. pdebuild --pbuilder qemubuilder Run qemubuilder --build against the current directory. The current directory should be an extracted Debian source package direc- tory. Edit /etc/pbuilderrc to have PDEBUILD_PBUILDER=qemubuilder to make this the default behavior for pdebuild. qemubuilder --create --distribution sid --basepath /var/cache/pbuilder/base-test.qemu Create a base.qemu image with the path /var/cache/pbuilder/base-test.qemu and distribution sid. Example pbuilderrc for i386 KERNEL_IMAGE=vmlinuz-2.6.18-4-k7 INITRD=initrd.img-2.6.18-4-k7 ARCHITECTURE=i386 BASEPATH=/home/dancer/tmp/base-i386.qemu MEMORY_MEGS=64 Note. INITRD may or may not be required for your system. Debian Installer initrd may or may not work depending on which one you choose, use the one from an installed system. CAVEATS Note that for mirror specification, http://localhost/debian/ usually doesn't work, it will be searching for files on the virtual machine itself, not the host OS. AUTHOR
Junichi Uekawa (dancer@debian.org) SEE ALSO
/usr/share/doc/pbuilder/pbuilder-doc.html, pbuilder (8), pdebuild (1) pbuilder 2008 Aug 10 qemubuilder(8)
Check Out this Related Man Page
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)