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