schroot-script-config - schroot chroot setup script configuration
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 behaviour 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.
The environment is the same as for all setup scripts, described in
schroot-setup(5).
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.
Roger Leigh.
Copyright © 2005-2012 Roger Leigh <
[email protected]>
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.
sbuild(1),
schroot(1),
sh(1),
schroot.conf(5),
schroot-setup(5).