sbuild-createchroot - create sbuild chroot
sbuild-createchroot [-h|--help | -V|--version] [--verbose]
[--arch=arch] [--foreign] [--resolve-deps | --no-resolve-deps] [--keep-
file] [--setup-only] SUITE TARGET-DIRECTORY DEBIAN-MIRROR-URI [SCRIPT]
buildd-create-chroot USER SUITE TARGET-DIRECTORY DEBIAN-MIRROR-URI
sbuild-createchroot runs debootstrap(1) 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 schroot(1) by creating
a chroot definition file under /etc/schroot/chroot.d. This should be
edited to finish the chroot configuration after sbuild-createchroot has
buildd-create-chroot, like sbuild-createchroot, runs debootstrap(1) to
create a chroot for package building. However, this creates a chroot
specifically for buildd(1) 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.
Note that debootstrap(1) 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 the installation.
Automatically resolve missing dependencies. This is the
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.
SUITE 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.
An http://, file:///, or ssh:/// URI pointing to a suitable
SCRIPT 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.
To create a sid (unstable) chroot in /srv/chroot/unstable using the
ftp.uk.debian.org Debian mirror:
% sudo sbuild-createchroot sid /srv/chroot/unstable \
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 schroot(1).
Francesco P. Lovergine.
Copyright (C) 2004 Francesco P. Lovergine <firstname.lastname@example.org>.
Copyright (C) 2007-2008 Roger Leigh <email@example.com>.
debootstrap(8), schroot(1), sbuild(1), sbuild-setup(7). q