summaryrefslogtreecommitdiff
path: root/man/schroot-script-config.5.in
blob: 36946307241bd69000c681e2bc4356aeff2e4c50 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
.\" Copyright © 2005-2010  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.
.\"
.\" schroot is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see
.\" <http://www.gnu.org/licenses/>.
.\"
.TH SCHROOT-SCRIPT-CONFIG 5 "@RELEASE_DATE_S@" "Version @VERSION@" "Debian sbuild"
.SH NAME
schroot-script-config \- schroot chroot setup script configuration
.SH DESCRIPTION
\fBschroot\fP uses scripts to set up and then clean up the chroot
environment.  These scripts may be customised using the \f[CI]script\-config\fP
key in \fI@SCHROOT_CONF@\fP.  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.
.SH ENVIRONMENT
The environment is the same as for all setup scripts, described in
.BR schroot-setup (5).
.SH 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.
.TP
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.
.TP
FSTAB
The filesystem table file to be used to mount filesystems within the chroot.
The format of this file is the same as for \fI/etc/fstab\fP, documented in
.BR fstab (5).
The only difference is that the mountpoint path \fIfs_dir\fP is relative to the
chroot, rather than the root.
.TP
NSSDATABASES
A file listing the system databases to copy into the chroot.  The default
databases are \[oq]passwd\[cq], \[oq]shadow\[cq], \[oq]group\[cq],
\[oq]services\[cq], \[oq]protocols\[cq], \[oq]networks\[cq], and
\[oq]hosts\[cq].  \[oq]gshadow\[cq] 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
.BR getent (1)
so all database sources listed in \fI/etc/nsswitch.conf\fP will be used for
each database.
.SH AUTHORS
Roger Leigh.
.SH COPYRIGHT
Copyright \(co 2005\-2010  Roger Leigh \f[CR]<rleigh@debian.org>\fP
.PP
\fBschroot\fP 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.
.SH SEE ALSO
.BR sbuild (1),
.BR schroot (1),
.BR sh (1),
.BR schroot.conf (5),
.BR schroot\-setup (5).
.\"#
.\"# The following sets edit modes for GNU EMACS
.\"# Local Variables:
.\"# mode:nroff
.\"# fill-column:79
.\"# End: