| 1 | .\" Copyright © 2005-2009 Roger Leigh <rleigh@debian.org> |
|---|
| 2 | .\" |
|---|
| 3 | .\" schroot is free software: you can redistribute it and/or modify it |
|---|
| 4 | .\" under the terms of the GNU General Public License as published by |
|---|
| 5 | .\" the Free Software Foundation, either version 3 of the License, or |
|---|
| 6 | .\" (at your option) any later version. |
|---|
| 7 | .\" |
|---|
| 8 | .\" schroot is distributed in the hope that it will be useful, but |
|---|
| 9 | .\" WITHOUT ANY WARRANTY; without even the implied warranty of |
|---|
| 10 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
|---|
| 11 | .\" General Public License for more details. |
|---|
| 12 | .\" |
|---|
| 13 | .\" You should have received a copy of the GNU General Public License |
|---|
| 14 | .\" along with this program. If not, see |
|---|
| 15 | .\" <http://www.gnu.org/licenses/>. |
|---|
| 16 | .\" |
|---|
| 17 | .TH SCHROOT-SCRIPT-CONFIG 5 "@RELEASE_DATE@" "Version @VERSION@" "Debian sbuild" |
|---|
| 18 | .SH NAME |
|---|
| 19 | schroot-script-config \- schroot chroot setup script configuration |
|---|
| 20 | .SH DESCRIPTION |
|---|
| 21 | \fBschroot\fP uses scripts to set up and then clean up the chroot |
|---|
| 22 | environment. These scripts may be customised using the \f[CI]script\-config\fP |
|---|
| 23 | key in \fI@SCHROOT_CONF@\fP. This key specifies a file which the setup scripts |
|---|
| 24 | will source when they are run. The file is a Bourne shell script, and in |
|---|
| 25 | consequence may contain any valid shell code, in addition to simple variable |
|---|
| 26 | assignments. This will, for example, allow behaviour to be customised |
|---|
| 27 | according to the specific chroot type or name. |
|---|
| 28 | .SH ENVIRONMENT |
|---|
| 29 | The environment is the same as for all setup scripts, described in |
|---|
| 30 | .BR schroot-setup (5). |
|---|
| 31 | .SH VARIABLES |
|---|
| 32 | The following variables may be set to configure setup script behaviour. Note |
|---|
| 33 | that new variables may be added in future releases. Third-party extensions to |
|---|
| 34 | schroot which add their own setup scripts may add additional variables which |
|---|
| 35 | are not documented here; consult the extension documentation for further |
|---|
| 36 | details. |
|---|
| 37 | .TP |
|---|
| 38 | COPYFILES |
|---|
| 39 | A file containing a list of files to copy into the chroot (one file per line). |
|---|
| 40 | The file will have the same absolute location inside the chroot. |
|---|
| 41 | .TP |
|---|
| 42 | FSTAB |
|---|
| 43 | The filesystem table file to be used to mount filesystems within the chroot. |
|---|
| 44 | The format of this file is the same as for \fI/etc/fstab\fP, documented in |
|---|
| 45 | .BR fstab (5). |
|---|
| 46 | The only difference is that the mountpoint path \fIfs_dir\fP is relative to the |
|---|
| 47 | chroot, rather than the root. |
|---|
| 48 | .TP |
|---|
| 49 | NSSDATABASES |
|---|
| 50 | A file listing the system databases to copy into the chroot. The default |
|---|
| 51 | databases are \[oq]passwd\[cq], \[oq]shadow\[cq], \[oq]group\[cq], |
|---|
| 52 | \[oq]services\[cq], \[oq]protocols\[cq], \[oq]networks\[cq], and |
|---|
| 53 | \[oq]hosts\[cq]. \[oq]gshadow\[cq] is not yet copied by default, due to not |
|---|
| 54 | being supported by all but the most recent version of the GNU C library. The |
|---|
| 55 | databases are copied using |
|---|
| 56 | .BR getent (1) |
|---|
| 57 | so all database sources listed in \fI/etc/nsswitch.conf\fP will be used for |
|---|
| 58 | each database. |
|---|
| 59 | .SH AUTHORS |
|---|
| 60 | Roger Leigh. |
|---|
| 61 | .SH COPYRIGHT |
|---|
| 62 | Copyright \(co 2005\-2009 Roger Leigh \f[CR]<rleigh@debian.org>\fP |
|---|
| 63 | .PP |
|---|
| 64 | \fBschroot\fP is free software: you can redistribute it and/or modify it under |
|---|
| 65 | the terms of the GNU General Public License as published by the Free Software |
|---|
| 66 | Foundation, either version 3 of the License, or (at your option) any later |
|---|
| 67 | version. |
|---|
| 68 | .SH SEE ALSO |
|---|
| 69 | .BR sbuild (1), |
|---|
| 70 | .BR schroot (1), |
|---|
| 71 | .BR sh (1), |
|---|
| 72 | .BR schroot.conf (5), |
|---|
| 73 | .BR schroot\-setup (5). |
|---|
| 74 | .\"# |
|---|
| 75 | .\"# The following sets edit modes for GNU EMACS |
|---|
| 76 | .\"# Local Variables: |
|---|
| 77 | .\"# mode:nroff |
|---|
| 78 | .\"# fill-column:79 |
|---|
| 79 | .\"# End: |
|---|
