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)
