mk-sbuild-lv(1)
NAME
mk-sbuild-lv - creates LVM snapshot chroots via schroot and sbuild
SYNOPSIS
mk-sbuild-lv [--arch=ARCH] [--name=NAME] [--personality=PERSONALITY] [--debug] [--source-template=FILE] [--debootstrap-mirror=URL] <VG> <Release>
DESCRIPTION
mk-sbuild-lv creates LVM snapshot chroots via schroot and sbuild.
OPTIONS
Listed below are the command line options for mk-sbuild-lv:
- --arch=ARCH
- What architecture to select (defaults to the native architecture).
- --name=NAME
- Base name for the schroot (arch is appended).
- --personality=PERSONALITY
- What personality to use (defaults to match --arch).
- --debug
- Turn on script debugging.
- --skip-updates
- Do not include the -updates pocket in the installed sources.list.
- --source-template=FILE
- Use FILE as the sources.list template (defaults to $HOME/.mk-sbuild-lv.sources).
- --debootstrap-mirror=URL
- Use URL as the debootstrap source (defaults to http://ports.ubuntu.com for lpia, official Ubuntu repositories for the supported architectures).
- --distro
- Enable distro-specific logic. Currently known distros: "ubuntu" (default) and "debian".
ENVIRONMENT VARIABLES
- LV_SIZE
- Size of source LVs (defaults to 5G).
- SNAPSHOT_SIZE
- Size of snapshot LVs (defaults to 4G).
- SCHROOT_CONF_SUFFIX
- Lines to append to schroot entries.
- SKIP_UPDATES
- Do not include the -updates pocket in the installed sources.list.
FILES
- $HOME/.mk-sbuild-lv.rc
- Sourced for environment variables (defined above).
- $HOME/.mk-sbuild-lv.sources
- Can contain a customized sources.list. It will be read when creating the schroot. See sources.list(5) for more details on the format.
- $HOME/.mk-sbuild-lv.schroot.conf
- Can contain a customized configuration section to be inserted into /etc/schroot/schroot.conf. See schroot.conf(5) for more details on the format.
USING THE CHROOTS
To CHANGE the golden image: schroot -c ${CHROOT_NAME}-source -u root
To ENTER an image snapshot: schroot -c ${CHROOT_NAME}
To BUILD within a snapshot: sbuild -d ${SCHROOT_NAME} PACKAGE*.dsc
for example, to update the packages in a golden image: schroot -c ${CHROOT_NAME}-source -u root -- sh -c "apt-get -qq update && apt-get -qy upgrade && apt-get clean" </dev/null
SEE ALSO
sbuild-setup (7), sources.list (5), schroot.conf (5),
https://help.ubuntu.com/community/SbuildLVMHowto
AUTHOR
- mk-sbuild-lv 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.