Provided by: sbuild_0.62.5-1ubuntu2_all bug

NAME

       sbuild-createchroot - create sbuild chroot

SYNOPSIS

       sbuild-createchroot     [-h|--help    |    -V|--version]    [--verbose]
       [--arch=arch] [--foreign] [--resolve-deps | --no-resolve-deps] [--keep-
       debootstrap-dir]             [--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.

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

       --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 plain type sid (unstable)  chroot  in  /srv/chroot/unstable
       using the ftp.uk.debian.org Debian mirror:

       % sudo sbuild-createchroot sid /srv/chroot/unstable \
           http://ftp.uk.debian.org/debian↵

       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
       target:

       % sudo sbuild-createchroot \
           --make-sbuild-tarball=/var/cache/sbuild/sbuild.tar.gz \
           sid `mktemp -d` \
           http://ftp.uk.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).