SBUILD-CREATECHROOT(8)						   Debian sbuild					    SBUILD-CREATECHROOT(8)

NAME

       sbuild-createchroot - create sbuild chroot

SYNOPSIS

       sbuild-createchroot  [-h|--help	| -V|--version] [--verbose] [--arch=arch] [--foreign] [--resolve-deps | --no-resolve-deps] [--keep-deboot-
       strap-dir] [--include=package1[,package2,[packagen]]] [--exclude=package1[,package2,[packagen]]] [--components=component1[,component2,[com-
       ponentn]]]  [--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-essen-
       tial, 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-mas-
       ter.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 TAR-
	      GET-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/deboot-
	      strap/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 num-
       ber 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 (C) 2004 Francesco P. Lovergine <frankie@debian.org>.
       Copyright (C) 2007-2008 Roger Leigh <rleigh@debian.org>.
       Copyright (C) 2010 Andres Mejia <mcitadel@gmail.com>.

SEE ALSO

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

Version 0.63.2							    18 Aug 2012 					    SBUILD-CREATECHROOT(8)