source: trunk/debathena/scripts/build-server/make-chroot.8 @ 25991

Revision 25991, 2.2 KB checked in by jdreed, 10 years ago (diff)
- Update the profile config script to actually refer to the profile's version of the files - Update manpage to reflect the depressing reality of UDisks
Line 
1.TH MAKE-CHROOT 8 "13 May 2013" "deabthena-build-server"
2.SH NAME
3make-chroot \- Create a chroot suitable for use with the Debathena build environment
4.SH SYNOPSIS
5.nf
6.B make-chroot [options] \fIsuite\fP \fIarch\fP
7.sp
8.SH DESCRIPTION
9.BR make-chroot
10can be used to create a chroot suitable for use with the Debathena build
11environment.  \fIsuite\fP is the codename of a release (e.g. precise,
12squeeze), and \fIarch\fP is one of "i386" or "amd64".
13
14.SH OPTIONS
15.IP -d
16Debug mode.  Sets "-x" in the shell and also will not remove a tar-based
17chroot's directory if something fails.
18.IP -z
19When using tar-based chroots, compress with bzip2.
20.IP -o
21Create an overlayfs chroot, not a tar chroot (default).
22.IP -t
23Create a tar chroot, not an overlayfs chroot.
24
25.SH ENVIRONMENT VARIABLES
26The following environment variables influence this script.
27.IP VG
28When create tar-based chroots, create them in this LVM2 volume group.
29You must use the full path (e.g. /dev/\fIvolgroup\fP). 
30(Default: /dev/builder)
31.IP CHROOTDIR
32Create tar-based chroots in this directory.  (Default: /srv)
33.IP MIRRORHOST
34Use this HTTP host for the upstream mirror.  (Default: localhost:9999)
35.IP DATA
36Data (such as the sources.list files) for make-chroot is found in this
37location. (Default: /usr/share/debathena-build-server).  If the
38directory does not exist, it will fall back to $(dirname $0)
39.IP APTKEY
40The Debathena archive keyring. 
41(Default: /usr/share/keyrings/debathena-archive-keyring.gpg)
42
43.SH NOTES
44
45When using this in a desktop environment, Nautilus/UDisks will happily
46throw up new windows everytime an LV is created or mounted.  To disable
47this, you may wish to use a local low-number udev rule (in
48/etc/udev/rules.d) with content such as:
49
50SUBSYSTEM=="block", DM_UUID=="LVM*", ENV{UDISKS_AUTO}="0", ENV{UDISKS_PRESENTATION_HIDE}="1"
51
52The above rule (on one line) should hide any LVM partitions from UDisks.
53Except it probably won't work, so just disable automounting completely:
54
55gsettings set org.gnome.desktop.media-handling automount false
56gsettings set org.gnome.desktop.media-handling automount-open false
57
58.SH SEE ALSO
59
60schroot.conf(5), debootstrap(8), schroot(1)
61
62.SH AUTHOR
63SIPB Debathena Project (http://debathena.mit.edu)
64
Note: See TracBrowser for help on using the repository browser.