mirror of
https://git.launchpad.net/ubuntu-dev-tools
synced 2025-03-13 08:01:09 +00:00
134 lines
4.5 KiB
Groff
134 lines
4.5 KiB
Groff
.TH MK\-SBUILD "1" "09 February 2010" "ubuntu-dev-tools"
|
|
|
|
.SH NAME
|
|
mk\-sbuild \- creates chroots via schroot and sbuild
|
|
|
|
.SH SYNOPSIS
|
|
\fBmk\-sbuild\fR [\fB\-\-arch=ARCH\fR] [\fB\-\-name=NAME\fR]
|
|
[\fB\-\-personality=PERSONALITY\fR] [\fB\-\-debug\fR] [\fB\-\-source\-template=FILE\fR]
|
|
[\fB\-\-debootstrap\-mirror=URL\fR] [\fB\-\-distro=DISTRO\fR]
|
|
[\fB\-\-vg=VOLUME_GROUP\fR] [\fB\-\-type=SCHROOT_TYPE\fR] <\fBRelease\fR>
|
|
|
|
.SH DESCRIPTION
|
|
\fBmk\-sbuild\fR creates chroots via schroot and sbuild.
|
|
|
|
.SH OPTIONS
|
|
Listed below are the command line options for mk\-sbuild:
|
|
.TP
|
|
.B \-\-arch=ARCH
|
|
What architecture to select (defaults to the native architecture).
|
|
.TP
|
|
.B \-\-name=NAME
|
|
Base name for the schroot (arch is appended).
|
|
.TP
|
|
.B \-\-personality=PERSONALITY
|
|
What personality to use (defaults to match \-\-arch).
|
|
.TP
|
|
.B \-\-debug
|
|
Turn on script debugging.
|
|
.TP
|
|
.B \-\-skip\-updates
|
|
Do not include the \-updates pocket in the installed sources.list.
|
|
.TP
|
|
.B \-\-source\-template=FILE
|
|
Use FILE as the sources.list template (defaults to $HOME/.mk\-sbuild.sources).
|
|
.TP
|
|
.B \-\-debootstrap\-mirror=URL
|
|
Use URL as the debootstrap source (defaults to http://ports.ubuntu.com for lpia,
|
|
official Ubuntu repositories for the supported architectures).
|
|
.TP
|
|
.B \-\-debootstrap\-include=alpha,beta
|
|
Pass along a comma separated list of packages to debootstrap's \-\-include
|
|
argument. See debootstrap (8) for more details.
|
|
.TP
|
|
.B \-\-debootstrap\-exclude=alpha,beta
|
|
Pass along a comma separated list of packages to debootstrap's \-\-exclude
|
|
argument. WARNING: be careful using this option as you can end up
|
|
excluding essential package. See debootstrap (8) for more details.
|
|
.TP
|
|
.B \-\-distro=DISTRO
|
|
Enable distro-specific logic. Currently known distros: "ubuntu" (default)
|
|
and "debian".
|
|
.TP
|
|
.B \-\-vg=VOLUME_GROUP
|
|
Specify a volume group, and subsequently use a default SCHROOT_TYPE of
|
|
"lvm-snapshot" rather than "directory" (via aufs) mounts.
|
|
.TP
|
|
.B \-\-type=SHROOT_TYPE
|
|
Specify a SCHROOT_TYPE. Supported values are "directory" (default if
|
|
\-\-vg not specified), "lvm-snapshot" (default if \-\-vg specified),
|
|
"btrfs-snapshot", and "file".
|
|
|
|
.SH ENVIRONMENT VARIABLES
|
|
.TP
|
|
.B LV_SIZE
|
|
Size of source LVs (defaults to 5G).
|
|
.TP
|
|
.B SNAPSHOT_SIZE
|
|
Size of snapshot LVs (defaults to 4G).
|
|
.TP
|
|
.B SCHROOT_CONF_SUFFIX
|
|
Lines to append to schroot entries.
|
|
.TP
|
|
.B SKIP_UPDATES
|
|
Do not include the \-updates pocket in the installed sources.list.
|
|
.TP
|
|
.B DEBOOTSTRAP_MIRROR
|
|
Mirror location (same as \-\-debootstrap-mirror)
|
|
.TP
|
|
.B DEBOOTSTRAP_INCLUDE
|
|
Comma separated list of packages to include when bootstrapping (same as \-\-debootstrap-include)
|
|
.TP
|
|
.B DEBOOTSTRAP_EXCLUDE
|
|
Comma separated list of packages to exclude when bootstrapping (same as \-\-debootstrap-exclude; see warning above)
|
|
.TP
|
|
.B SOURCE_CHROOTS_DIR
|
|
use SOURCE_CHROOTS_DIR as home of schroot source directories. (default
|
|
/var/lib/schroot/chroots)
|
|
.TP
|
|
.B SOURCE_CHROOTS_TGZ
|
|
use SOURCE_CHROOTS_TGZ as home of schroot source tarballs. (default
|
|
/var/lib/schroot/tarballs)
|
|
.TP
|
|
.B CHROOT_SNAPSHOT_DIR
|
|
use CHROOT_SNAPSHOT_DIR as home of mounted btrfs snapshots (default
|
|
/var/lib/schroot/snapshots)
|
|
|
|
|
|
.SH FILES
|
|
.TP
|
|
.B $HOME/.mk\-sbuild.rc
|
|
Sourced for environment variables (defined above).
|
|
.TP
|
|
.B $HOME/.mk\-sbuild.sources[.$DISTRO]
|
|
Can contain a customized sources.list.
|
|
It will be read when creating the schroot.
|
|
If a file with ".ubuntu" or ".debian" is found (based on the \-\-distro
|
|
argument) that file will use used instead.
|
|
See sources.list(5) for more details on the format.
|
|
.TP
|
|
.B $HOME/.mk\-sbuild.schroot.conf[.$SCHROOT_TYPE]
|
|
Can contain a customized configuration section to be inserted into
|
|
/etc/schroot/schroot.conf.
|
|
If a file with ".lvm-snapshot", ".directory", or ".file" is found (based on the
|
|
values of the \-\-vg and \-\-type arguments) that file will use used instead.
|
|
See schroot.conf(5) for more details on the format.
|
|
.SH USING THE CHROOTS
|
|
.TP
|
|
To CHANGE the golden image: \fBsudo schroot \-c ${CHROOT_NAME}\-source \-u root\fR
|
|
.TP
|
|
To ENTER an image snapshot: \fBschroot \-c ${CHROOT_NAME}\fR
|
|
.TP
|
|
To BUILD within a snapshot: \fBsbuild \-A \-d ${SCHROOT_NAME} PACKAGE*.dsc\fR
|
|
.TP
|
|
for example, to update the packages in a golden image: \fBschroot \-c ${CHROOT_NAME}\-source \-u root -- sh \-c "apt-get \-qq update && apt-get \-qy upgrade && apt-get clean" </dev/null\fR
|
|
|
|
.SH SEE ALSO
|
|
sbuild\-setup (7), sources.list (5), schroot.conf (5),
|
|
https://help.ubuntu.com/community/SbuildLVMHowto
|
|
|
|
.SH AUTHOR
|
|
\fBmk\-sbuild\fR was written by Kees Cook <kees@ubuntu.com>.
|
|
This man page was written by Ryan Kavanagh <ryanakca@kubuntu.org>.
|
|
Both are released under the GNU General Public License, version 3 or later.
|