mk-sbuild - creates chroots via schroot and sbuild
mk-sbuild [options...] <release>
mk-sbuild creates chroots via schroot and sbuild.
are the command line options for mk-sbuild:
What architecture to select (defaults to the native architecture).
Set up the chroot as a cross-building environment targeting the specified architecture.
Base name for the schroot (arch is appended).
What personality to use (defaults to match --arch).
Turn on script debugging.
Do not include the -updates pocket in the installed sources.list.
Do not include the -proposed pocket in the installed sources.list.
Use FILE as the sources.list template (defaults to $HOME/.mk-sbuild.sources).
Use URL as the debootstrap source (defaults to http://ports.ubuntu.com where appropriate, official Ubuntu repositories for the supported architectures).
Pass along a comma separated list of packages to debootstrap’s --include argument. See debootstrap (8) for more details.
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.
Pass along the path to a gpg keyring file to debootsrap’s --keyring argument. See debootstrap (8) for more details.
Disable checking gpg signatures of downloaded Release files by using debootstrap’s --no-check-gpg option. See debootstrap (8) for more details.
Enable distro-specific logic. When not provided, the distribution is determined from release. Currently known distros: "debian" and "ubuntu".
Specify a volume group, and subsequently use a default SCHROOT_TYPE of "lvm-snapshot" rather than "directory" (via overlayfs or aufs) mounts.
Specify a SCHROOT_TYPE. Supported values are "directory" (default if --vg not specified), "lvm-snapshot" (default if --vg specified), "btrfs-snapshot", and "file".
Size of source LVs (defaults to 5G).
Size of snapshot LVs (defaults to 4G).
Lines to append to schroot entries.
Profile to use with schroot. (defaults to sbuild)
Do not include the -updates pocket (same as --skip-updates)
Do not include the -proposed pocket (same as --skip-proposed)
Mirror location (same as --debootstrap-mirror)
Comma separated list of packages to include when bootstrapping (same as --debootstrap-include)
Comma separated list of packages to exclude when bootstrapping (same as --debootstrap-exclude; see warning above)
Keyring file to use for checking gpg signatures of retrieved release files (same as --debootstrap-keyring)
Disable gpg verification of retrieved release files (same as --debootstrap-no-check-gpg)
Use SOURCE_CHROOTS_DIR as home of schroot source directories. (default /var/lib/schroot/chroots)
Use SOURCE_CHROOTS_TGZ as home of schroot source tarballs. (default /var/lib/schroot/tarballs)
Use CHROOT_SNAPSHOT_DIR as home of mounted btrfs snapshots. (default /var/lib/schroot/snapshots)
Sourced for environment variables (defined above).
Can contain a customized sources.list. It will be read when creating the schroot. If a file with ".ubuntu" or ".debian" is found (as appropriate) it will use used instead. See sources.list (5) for more details on the format.
Can contain a customized configuration section to be inserted into /etc/schroot/schroot.conf. If a file with ".lvm-snapshot", ".directory", ".file", or "btrfs-snapshot" is found (as appropriate) that file will use used instead. See schroot.conf (5) for more details on the format.
To CHANGE the
golden image: sudo schroot -c
To ENTER an image snapshot: schroot -c $SCHROOT_NAME
To BUILD within a snapshot: sbuild -A -d $SCHROOT_NAME $PACKAGE*.dsc
for example, to update the packages in a sid-amd64 golden image:
schroot -c sid-amd64-source -u root -- sh -c "apt-get -qq update && apt-get -qy upgrade && apt-get clean" </dev/null
mk-sbuild was written by Kees Cook <kees [AT] ubuntu.com>. This man page was written by Ryan Kavanagh <ryanakca [AT] kubuntu.org>. Both are released under the GNU General Public License, version 3 or later.