Linux Certif

Toute la documentation sur la certification Linux LPI

mk-sbuild

NAME

mk-sbuild - creates chroots via schroot and sbuild

SYNOPSIS

mk-sbuild [--arch=ARCH] [--name=NAME] [--personality=PERSONALITY] [--debug] [--source-template=FILE] [--debootstrap-mirror=URL] [--distro=DISTRO] [--vg=VOLUME_GROUP] [--type=SCHROOT_TYPE] <Release>

DESCRIPTION

mk-sbuild creates chroots via schroot and sbuild.

OPTIONS

Listed below are the command line options for mk-sbuild:

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

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

--distro=DISTRO

Enable distro-specific logic. Currently known distros: "ubuntu" (default) and "debian".

--vg=VOLUME_GROUP

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

--type=SHROOT_TYPE

Specify a SCHROOT_TYPE. Supported values are "directory" (default if --vg not specified), "lvm-snapshot" (default if --vg specified), 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.

SKIP_UPDATES

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

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)

SOURCE_CHROOTS_DIR

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)

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 (based on the --distro argument) that file 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", 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.

USING THE CHROOTS

To CHANGE the golden image: sudo schroot -c ${CHROOT_NAME}-source -u root

To ENTER an image snapshot: schroot -c ${CHROOT_NAME}

To BUILD within a snapshot: sbuild -A -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 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.