← Back to branch summary

~ubuntu-branches/ubuntu/maverick/schroot/maverick-updates

« back to all changes in this revision

Viewing changes to bin/schroot/schroot-setup.5.in

  • Committer: Bazaar Package Importer
  • Author(s): Roger Leigh
  • Date: 2008-01-20 22:51:04 UTC
  • mfrom: (1.1.15 upstream)
  • Revision ID: james.westby@ubuntu.com-20080120225104-3zhs8gk9byqigato
Tags: 1.1.6-1
http://bugs.debian.org/439215
http://bugs.debian.org/452263
http://bugs.debian.org/428808
http://bugs.debian.org/459658
http://bugs.debian.org/395062
http://bugs.debian.org/427047
http://bugs.debian.org/461531
* New upstream development release.
* Acknowledge NMU.  Thanks to Lucas Nussbaum for fixing the Boost
  library names following another incompatible change in Boost
  (Closes: #439215).
* debian/control: Suggest lvm2 instead of lvm-common (Closes: #452263).
* debian/copyright:
  - Update with new GIT source code repository location.
  - Update licence to GPLv3.
* debian/schroot.init: Update licence to GPLv3.
* bin/schroot/setup/20network, bin/schroot/setup/30passwd: For files to
  copy, compare file device, inode and contents to avoid copying
  identical files (Closes: #428808).
* If unknown keys are present in the configuration file, print a warning
  message to alert the user (Closes: #459658).
* The filesystems to mount in the chroot may be customised by the system
  administrator through the use of an fstab file on a per-chroot basis,
  and a new helper utility, schroot-mount (Closes: #395062, #427047).
  Thanks for your patience while we took the time to implement this the
  right way.
* Update Vietnamese translation (Closes: #461531).  Thanks to Clytie
  Siddall.
* debian/schroot.preinst: Add rm_conffile function to remove
  /etc/schroot/setup.d/20network and /etc/schroot/setup.d/30passwd for
  versions prior to this.  These are replaced by
  /etc/schroot/setup.d/20copyfiles.
* debian/schroot.NEWS: Document conffile changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bin/schroot/schroot-setup.5.in
1
 
.\" Copyright © 2005-2007  Roger Leigh <rleigh@debian.org>
 
1
.\" Copyright © 2005-2008  Roger Leigh <rleigh@debian.org>
2
2
.\"
3
 
.\" schroot is free software; you can redistribute it and/or modify it
 
3
.\" schroot is free software: you can redistribute it and/or modify it
4
4
.\" under the terms of the GNU General Public License as published by
5
 
.\" the Free Software Foundation; either version 2 of the License, or
 
5
.\" the Free Software Foundation, either version 3 of the License, or
6
6
.\" (at your option) any later version.
7
7
.\"
8
8
.\" schroot is distributed in the hope that it will be useful, but
11
11
.\" General Public License for more details.
12
12
.\"
13
13
.\" You should have received a copy of the GNU General Public License
14
 
.\" along with this program; if not, write to the Free Software
15
 
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston,
16
 
.\" MA  02111-1307  USA
17
 
.TH SCHROOT-SETUP 5 "@RELEASE_DATE@" "Version @VERSION@" "Debian sbuild"
 
14
.\" along with this program.  If not, see
 
15
.\" <http://www.gnu.org/licenses/>.
 
16
.\"
 
17
.TH SCHROOT\-SETUP 5 "@RELEASE_DATE@" "Version @VERSION@" "Debian sbuild"
18
18
.SH NAME
19
 
schroot-setup \[em] schroot chroot setup scripts
 
19
schroot\-setup \[em] schroot chroot setup scripts
20
20
.SH DESCRIPTION
21
21
\fBschroot\fP uses scripts to to set up and then clean up the chroot
22
22
environment.  The directories \f[BI]@SCHROOT_CONF_SETUP_D@\fP and
52
52
Note that the scripts should be \fIidempotent\fP.  They \fBmust\fP be
53
53
idempotent during the \[oq]exec\-stop\[cq] and \[oq]setup\-stop\[cq] phases,
54
54
because they may be run more than once.
55
 
.SH
56
 
ENVIRONMENT
 
55
.SH ENVIRONMENT
57
56
.SS General variables
58
57
.TP
59
58
AUTH_USER
77
76
SESSION_ID
78
77
The session identifier.
79
78
.TP
 
79
CHROOT_SESSION_CREATE
 
80
Set to \[oq]true\[cq] if a session will be created, otherwise \[oq]false\[cq].
 
81
.TP
 
82
CHROOT_SESSION_CLONE
 
83
Set to \[oq]true\[cq] if a session will be cloned, otherwise \[oq]false\[cq].
 
84
.TP
 
85
CHROOT_SESSION_PURGE
 
86
Set to \[oq]true\[cq] if a session will be purged, otherwise \[oq]false\[cq].
 
87
.TP
80
88
CHROOT_TYPE
81
89
The type of the chroot.  This is useful for restricting a setup task to
82
90
particular types of chroot (e.g. only block devices or LVM snapshots).
152
160
\f[BI]10mount\fP
153
161
Mount and unmount filesystems.
154
162
.TP
155
 
\f[BI]20network\fP
156
 
Configure networking by copying resolv.conf from the host system.
157
 
.TP
158
 
\f[BI]30passwd\fP
159
 
Configure passwd, shadow and groups in the chroot.  This copies the files from
160
 
the host system.
 
163
\f[BI]20copyfiles\fP
 
164
Copy files from th host system into the chroot.  Configure networking by
 
165
copying hosts and resolv.conf, and user accounts by copying passwd, shadow and
 
166
groups.
161
167
.TP
162
168
\f[BI]50chrootname\fP
163
169
Set the chroot name (\fI/etc/debian_chroot\fP) in the chroot.  This may be used
176
182
.SH AUTHORS
177
183
Roger Leigh.
178
184
.SH COPYRIGHT
179
 
Copyright \(co 2005\-2007  Roger Leigh \f[CR]<rleigh@debian.org>\fP
 
185
Copyright \(co 2005\-2008  Roger Leigh \f[CR]<rleigh@debian.org>\fP
180
186
.PP
181
 
This program is free software; you can redistribute it and/or modify it
182
 
under the terms of the GNU General Public License as published by the Free
183
 
Software Foundation; either version 2 of the License, or (at your option)
184
 
any later version.
 
187
\fBschroot\fP is free software: you can redistribute it and/or modify it under
 
188
the terms of the GNU General Public License as published by the Free Software
 
189
Foundation, either version 3 of the License, or (at your option) any later
 
190
version.
185
191
.SH SEE ALSO
186
 
.BR sbuild (1),
 
192
.BR schroot (1),
187
193
.BR schroot.conf (5),
188
 
.BR run-parts (8).
 
194
.BR schroot\-script\-config (5),
 
195
.BR run\-parts (8).
189
196
.\"#
190
197
.\"# The following sets edit modes for GNU EMACS
191
198
.\"# Local Variables: