Man Linux: Main Page and Category List

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

EXAMPLES

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

COPYRIGHT

       Copyright (C) 2004 Francesco P. Lovergine <frankie@debian.org>.
       Copyright (C) 2007-2008 Roger Leigh <rleigh@debian.org>.

SEE ALSO

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