Provided by: sbuild_0.67.0-2ubuntu7.1_all bug

NAME

       sbuild-createchroot - create sbuild chroot

SYNOPSIS

       sbuild-createchroot   [-h|--help  |  -V|--version]  [--verbose]  [--arch=arch]  [--chroot-
       suffix=suffix] [--foreign] [--resolve-deps |  --no-resolve-deps]  [--keep-debootstrap-dir]
       [--debootstrap=debootstrap]                     [--include=package1[,package2,[packagen]]]
       [--exclude=package1[,package2,[packagen]]]
       [--components=component1[,component2,[componentn]]]               [--keyring=keyring-file]
       [--setup-only]  [--make-sbuild-tarball=file]  [--keep-sbuild-chroot-dir]   SUITE   TARGET-
       DIRECTORY DEBIAN-MIRROR-URI [SCRIPT]

       buildd-create-chroot USER SUITE TARGET-DIRECTORY DEBIAN-MIRROR-URI

DESCRIPTION

       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 completed.

       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.

OPTIONS

   Actions
       -h, --help
              Display this manual.

       -V, --version
              Print version information.

   General options
       -v, --verbose
              Print all messages.

   Debootstrap options
       Note  that  debootstrap(1) is the canonical reference for the meaning of the options; they
       are passed directly to debootstrap.

       --arch=arch
              Set the target architecture.  This may be used if dpkg is  not  already  installed.
              See also --foreign, below.

       --chroot-suffix=suffix
              Add a custom suffix to the chroot name. Defaults to '-sbuild'.

       --foreign
              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.

       --resolve-deps
              Automatically resolve missing dependencies.  This is the default.

       --no-resolve-deps
              Do not automatically resolve missing dependencies.

       --keep-debootstrap-dir
              Don't delete the /debootstrap directory in TARGET-DIRECTORY  after  completing  the
              installation.

       --debootstrap=debootstrap
              Define a custom debootstrap variant. Defaults to 'debootstrap'.

       --include=package1[,package2,[packagen]]
              Comma  separated  list  of  packages which will be added to the list of packages to
              download and extract.

       --exclude=package1[,package2,[packagen]]
              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.

       --components=component1[,component2,[componentn]]
              Comma separated list of archive components to use (e.g.  ‘main’,  ‘contrib’,  ‘non-
              free’).  Defaults to ‘main’.

       --keyring=keyring-file
              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 /usr/share/debootstrap/scripts.

       TARGET-DIRECTORY
              The directory to create the chroot in.  The directory will be created  if  it  does
              not already exist.

       DEBIAN-MIRROR-URI
              An http://, file:///, or ssh:/// URI pointing to a suitable archive mirror.

       SCRIPT debootstrap script to run.  Not typically required.

   sbuild-createchroot behaviour
       --setup-only
              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.

       --make-sbuild-tarball=file
              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 details.

       --keep-sbuild-chroot-dir
              Don't  delete  the directory used for creating a file type chroot. This option does
              nothing if not creating a file type chroot.

TARBALL FILE

       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.

       *.tar  Generates an uncompressed tarball.

       *.tar.gz|*.tgz
              Generates a compressed tarball using gzip.

       *.tar.bz2|*.tbz
              Generates a compressed tarball using bzip2.

       *.tar.lz|*.tlz
              Generates a compressed tarball using lzip.

       *.tar.xz|*.txz
              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.

EXAMPLES

       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 httpredir.debian.org Debian http mirror
       redirector service and using a temporary directory as the target:

       % sudo sbuild-createchroot \
           --make-sbuild-tarball=/srv/chroot/unstable-amd64.tar.gz \
           sid `mktemp -d` \
           http://httpredir.debian.org/debian

       To   create  a  plain  type  sid  (unstable)  chroot  in  /srv/chroot/unstable  using  the
       httpredir.debian.org Debian http mirror redirector service:

       % sudo sbuild-createchroot sid /srv/chroot/unstable-amd64 \
           http://httpredir.debian.org/debian

HISTORY

       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).

AUTHORS

       Roger Leigh.
       Francesco P. Lovergine.
       Andres Mejia.

COPYRIGHT

       Copyright © 2004 Francesco P. Lovergine <frankie@debian.org>.
       Copyright © 2007-2008 Roger Leigh <rleigh@debian.org>.
       Copyright © 2010 Andres Mejia <mcitadel@gmail.com>.

SEE ALSO

       debootstrap(8), schroot(1), sbuild(1), sbuild-setup(7).