OPTIONS

Set up the chroot as a cross-building environment targeting the specified
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.

--skip-proposed

Do not include the -proposed pocket in the installed
sources.list.

--source-template=FILE

Use FILE as the sources.list template (defaults to
$HOME/.mk-sbuild.sources).

--debootstrap-mirror=URL

Use URL as the debootstrap source (defaults to
ports.ubuntu.com where appropriate, official Ubuntu
repositories for the supported architectures).

--debootstrap-include=alpha,beta

Pass along a comma separated list of packages to debootstrap's
--include argument. See debootstrap (8) for more details.

--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.

--debootstrap-keyring=keyring

Pass along the path to a gpg keyring file to debootsrap's
--keyring argument. See debootstrap (8) for more details.

--debootstrap-no-check-gpg

Disable checking gpg signatures of downloaded Release files by using
debootstrap's --no-check-gpg option. See debootstrap (8)
for more details.

--distro=DISTRO

Enable distro-specific logic.
When not provided, the distribution is determined from release.
Currently known distros: "debian" and "ubuntu".

--vg=VOLUME_GROUP

Specify a volume group, and subsequently use a default SCHROOT_TYPE of
"lvm-snapshot" rather than "directory" (via overlayfs or
aufs) mounts.

--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".

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.

SCHROOT_PROFILE

Profile to use with schroot. (defaults to sbuild)

SKIP_UPDATES

Do not include the -updates pocket (same as
--skip-updates)

SKIP_PROPOSED

Do not include the -proposed pocket (same as
--skip-proposed)

DEBOOTSTRAP_MIRROR

Mirror location (same as --debootstrap-mirror)

DEBOOTSTRAP_INCLUDE

Comma separated list of packages to include when bootstrapping (same as
--debootstrap-include)

DEBOOTSTRAP_EXCLUDE

Comma separated list of packages to exclude when bootstrapping (same as
--debootstrap-exclude; see warning above)

DEBOOTSTRAP_KEYRING

Keyring file to use for checking gpg signatures of retrieved release files
(same as --debootstrap-keyring)

Use SOURCE_CHROOTS_DIR as home of schroot source directories.
(default /var/lib/schroot/chroots)

SOURCE_CHROOTS_TGZ

Use SOURCE_CHROOTS_TGZ as home of schroot source tarballs.
(default /var/lib/schroot/tarballs)

CHROOT_SNAPSHOT_DIR

Use CHROOT_SNAPSHOT_DIR as home of mounted btrfs snapshots.
(default /var/lib/schroot/snapshots)

FILES

$HOME/.mk-sbuild.rc

Sourced for environment variables (defined above).

$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 (as
appropriate) it will use used instead.
See sources.list (5) for more details on the format.

$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", ".file",
or "btrfs-snapshot" is found (as appropriate) that file will use used instead.
See schroot.conf (5) for more details on the format.