schroot-script-config(5) [debian man page]
SCHROOT-SCRIPT-CONFIG(5) Debian sbuild SCHROOT-SCRIPT-CONFIG(5) NAME
schroot-script-config - schroot chroot setup script configuration DESCRIPTION
schroot uses scripts to set up and then clean up the chroot environment. These scripts may be customised using the script-config key in /etc/schroot/schroot.conf. This key specifies a file which the setup scripts will source when they are run. The file is a Bourne shell script, and in consequence may contain any valid shell code, in addition to simple variable assignments. This will, for example, allow be- haviour to be customised according to the specific chroot type or name. This file is deprecated, but is still used if present; it will be obsoleted and removed in a future release. All the settings in this file are now settable using configuration keys in schroot.conf, as detailed below. Existing configuration should be modified to use these keys in place of this file. ENVIRONMENT
The environment is the same as for all setup scripts, described in schroot-setup(5). VARIABLES
The following variables may be set to configure setup script behaviour. Note that new variables may be added in future releases. Third- party extensions to schroot which add their own setup scripts may add additional variables which are not documented here; consult the extension documentation for further details. SETUP_COPYFILES A file containing a list of files to copy into the chroot (one file per line). The file will have the same absolute location inside the chroot. Note that this is settable using the setup.copyfiles key. SETUP_FSTAB The filesystem table file to be used to mount filesystems within the chroot. The format of this file is the same as for /etc/fstab, documented in fstab(5). The only difference is that the mountpoint path fs_dir is relative to the chroot, rather than the root. Note that this is settable using the setup.fstab key. Also note that mountpoints are canonicalised on the host, which will ensure that absolute symlinks point inside the chroot, but complex paths containing multiple symlinks may be resolved incorrectly; it is advised to not use nested symlinks as mountpoints. SETUP_NSSDATABASES A file listing the system databases to copy into the chroot. The default databases are 'passwd', 'shadow', 'group', 'services', 'protocols', 'networks', and 'hosts'. 'gshadow' is not yet copied by default, due to not being supported by all but the most recent version of the GNU C library. The databases are copied using getent(1) so all database sources listed in /etc/nsswitch.conf will be used for each database. Note that this is settable using the setup.nssdatabases key. AUTHORS
Roger Leigh. COPYRIGHT
Copyright (C) 2005-2012 Roger Leigh <rleigh@debian.org> schroot is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. SEE ALSO
sbuild(1), schroot(1), sh(1), schroot.conf(5), schroot-setup(5). Version 1.6.4 27 Oct 2012 SCHROOT-SCRIPT-CONFIG(5)
Check Out this Related Man Page
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)