buildd-create-chrootUSER SUITE TARGET-DIRECTORY DEBIAN-MIRROR-URI
to create a chroot suitable for building packages with sbuild. Note that while
debootstrap may be used directly, sbuild-createchroot performs additional
setup tasks such as adding additional packages and configuring various files in
the chroot. Invoking sbuild-createchroot is functionally equivalent to
running debootstrap --variant=buildd
--include=fakeroot,build-essential, then editing
/etc/apt/sources.list and /etc/hosts by hand.
The newly-created chroot is set up to work with
by creating a chroot definition file under /etc/schroot/chroot.d. This
should be edited to finish the chroot configuration after
sbuild-createchroot has completed.
buildd-create-chroot, like sbuild-createchroot, runs
to create a chroot for package building. However, this creates a chroot
with an additional mandatory option to specify a user who will be granted sudo
access inside the chroot. This script mainly differs in its additional
customisation of /etc/apt/sources.list to use incoming.debian.org and
security-master.debian.org. It also removes some packages from the
newly-created chroot. Unless you are setting up an official Debian build
daemon, sbuild-createchroot should be used instead. The extra
functionality will be merged into sbuild-createchroot in the future.
Display this manual.
Print version information.
Print all messages.
is the canonical reference for the meaning of the options; they are passed
directly to debootstrap.
Set the target architecture. This may be used if dpkg is not already
installed. See also --foreign, below.
Only perform the initial unpack phase of bootstrapping. This is required if
the target and host architectures do not match. Note that debootstrap requires
running by hand to complete installation; run the debootstrap
/debootstrap/debootstrap installed in TARGET-DIRECTORY to complete
Automatically resolve missing dependencies. This is the default.
Do not automatically resolve missing dependencies.
Don't delete the /debootstrap directory in TARGET-DIRECTORY after
completing the installation.
Comma separated list of packages which will be added to the list of packages to
download and extract.
Comma separated list of packages which will be removed from the list of
packages to download and extract. Note that this can remove essential packages,
so use with extreme care.
Comma separated list of archive components to use (e.g. 'main',
'contrib', 'non-free'). Defaults to 'main'.
Download signatures for retrieved Release files and check them against
keyring-file. By default /etc/apt/trusted.gpg is used. Set to an
empty string to disable signature checking.
The distribution to bootstrap (e.g. 'sarge', 'etch',
'lenny', 'sid'). A complete list may be found in
The directory to create the chroot in. The directory will be created if it
does not already exist.
debootstrap script to run. Not typically required.
Don't run debootstrap. Only perform the setup tasks on an already existing
chroot. This is useful for converting an existing chroot for use with sbuild
which has already been created using a tool such as debootstrap.
Create a bootstrapped file type chroot ready for use with sbuild and save it as
file. The compression format used for the tarball is dependent on the file
extension used in file. See the TARBALL FILE section for more
Don't delete the directory used for creating a file type chroot. This option
does nothing if not creating a file type chroot.
When creating an sbuild tarball file, the compression format used to
generate the tarball depends on the entension used in file. Here is a
listing of the extensions that will be detected and what format the tarball will
be generated as.
Generates an uncompressed tarball.
Generates a compressed tarball using gzip.
Generates a compressed tarball using bzip2.
Generates a compressed tarball using lzip.
Generates a compressed tarball using xz.
If no extension is specified, sbuild-createchroot will rename file to
file.tar.gz and generate file.tar.gz as a compressed tarball using gzip.
To create a plain type sid (unstable) chroot in /srv/chroot/unstable using
the ftp.uk.debian.org Debian mirror:
To create a bootstrapped file type sid (unstable) chroot ready for use with
sbuild and saved in /var/cache/sbuild/sbuild.tar.gz using the
ftp.uk.debian.org Debian mirror and using a temporary directory as the
sbuild-createchroot was previously known as buildd.chroot.
buildd.chroot performed exactly the same tasks, but additionally created a
number of directories in the chroot for use by sbuild. This is now done by
Francesco P. Lovergine.