Linux Certif

Toute la documentation sur la certification Linux LPI

sbuild

NAME

sbuild - build debian packages from source

SYNOPSIS

sbuild [-h|--help | -V|--version] [-v|--verbose | -q|--quiet] [-D|--debug] [-A|--arch-all] [--archive=archive] [-d|--dist=distribution] [--arch=architecture] [-s|--source] [--force-orig-source] [--make-binNMU=changelog-entry] [--binNMU=NMU-version] [--append-to-version=string] [--add-depends=dependency] [--add-conflicts=dependency] [--add-depends-indep=dependency] [--add-conflicts-indep=dependency] [-m|--maintainer=maintainer] [-e|--uploader=uploader] [-k|--keyid=key-id] [--purge=purge-mode] [-b|--batch] [-n|--nolog] [--setup-hook=hook-script] PACKAGE1_VERSION[.dsc] [PACKAGE2_VERSION[.dsc] [PACKAGEn_VERSION[.dsc]]]

VERSION

This man page documents the packaged version of sbuild. This version is maintained by the buildd-tools project developers on Alioth (https://alioth.debian.org/projects/buildd-tools/).

There is also a version maintained by Ryan Murray which is adapted to build daemon needs, with similar functionality. This version should be equally capable of working in a buildd setup, but has a number of enhancements aimed at making it suitable for use by end-users.

DESCRIPTION

sbuild rebuilds Debian binary packages from the corresponding Debian source. It is similar to dbuild and debbuild, but, unlike them, it knows about source dependencies.

sbuild can fetch the Debian source over a network, or it can use locally available sources.

sbuild mails the build logs to a user. It is configured by the configuration files /etc/sbuild/sbuild.conf and ~/.sbuildrc. An example sbuildrc is available in /usr/share/doc/sbuild/examples/example.sbuildrc. sbuild will not run without a valid ~/.sbuildrc.

Optionally, source dependencies are read from /var/lib/sbuild/source-dependencies-*; see that file for more information on source-dependencies. Also see README.Debian.

You can build either using a local package with its .dsc file or a remote one by specifying an explicit dpkg version.

Note: sbuild must be run in the directory (~/build by default) with the chroot-{stable,testing,unstable} symlink to the chroot or it will do the build in the base install which is not what you want. When using schroot, these requirements do not apply. If the -c or --chroot option is used, the specified chroot will be used. Otherwise, the chroot having the name (or alias) of the specified distribution will be used; schroot uses a chroot named $distribution-$arch-sbuild, $distribution-sbuild, $distribution-$arch or $distribution, in that order of preference.

OPTIONS

-h, --help

Display this manual.

-V, --version

Print version information.

--add-depends=dependency

--add-conflicts=dependency

--add-depends-indep=dependency

--add-conflicts-indep=dependency

These options add a build dependencies to the source package being built, in addition to the build dependency information specified in debian/control. These dependencies will be concatenated directly to the Build-Depends, Build-Conflicts, Build-Depends-Indep and Build-Conflicts-Indep dependencies, respectively. The options may be used any number of times to add multiple dependencies. The format is identical to the format used in debian/control.

--arch=architecture

Build using the architecture specified. A chroot named $distribution-$arch-sbuild or $distribution-arch is searched for, in that order of preference. The chroot must be installed and configured appropriately to build as that architecture, e.g. using personality=linux32 to build i386 packages on an amd64 system.

-A, --arch-all

Also build Architecture: all packages, i.e. use dpkg-buildpackage -b instead of -B.

-b, --batch

Operate in batchmode, i.e. write a build-progress file during execution and files on shutdown to facilitate a clean restart.

-c, --chroot

Use the specified chroot. If not specified, the default is the first of $distribution-$arch-sbuild, $distribution-sbuild, $distribution-$arch or $distribution that exists.

-C, --check-depends-algorithm=algorithm

Selects the algorithm to check for build dependencies. The default algorithm ('first-only') just checks the first package, even if there are alternative dependencies available. The second algorithm ('alternatives') also tries to satisfy the build dependencies using these alternatives.

-d, --dist=distribution

Fetch source packages from specified distribution.

--archive=archive

Communicate with specified archive.

-f, --force-depends=dependency-line

This option overrides source dependency information for a package. It can be given more than one time with accumulating effect. The argument is a line of source dependencies in the same format as in /var/lib/sbuild/source-dependencies.

-D, --debug

Enable debug output.

--apt-update

Run apt-get update in the chroot before executing the build.

-m, --maintainer=maintainer

Passed to dpkg-genchanges and is used to set the Maintainer: field in the .changes file(s). This defaults to the DEBEMAIL environment variable if set.

-e, --uploader=uploader

Passed to dpkg-genchanges and is used to set the Changed-by: field in the .changes file(s).

-k, --keyid=key-id

Passed to dpkg-genchanges and is used to set the key to sign the .changes file(s). Default is not using any key.

-n, --nolog

Do not create a package log file in the $log_dir directory and no build log file, but print everything to stdout. Also do not send any log mails.

-p, --purge=purge-mode

purge-mode determines if the build directory will be deleted after a build. Possible values are always, never, and successful.

-s, --source

Also build source package, i.e. use dpkg-buildpackage without -B.

--force-orig-source

When used with in conjunction with -s, this option forces the inclusion of the orig.tar.gz file in the generated .changes file, even in cases where it would not normally be included, i.e. use dpkg-buildpackage -sa.

--use-snapshot

Installs the latest snapshot gcc compiler from the gcc-snapshot package, and alters the build environment to use the snapshot compiler for the build.

-v, --verbose

Be verbose, i.e. all information goes to stdout as well as to the log files.

-q, --quiet

Be quiet. This is the opposite of --verbose.

--make-binNMU=changelog-entry

With this option, sbuild will create a new changelog entry in debian/changelog of every package built. The version number will be in the format for binary-only NMUs (see --binNMU); the maintainer is set to the maintainer name configured for sbuild. changelog-entry will be used as the changelog entry following "Binary-only non-maintainer upload for ARCH -- no source changes". Please note that the versions in the PACKAGE_VERSION[.dsc] arguments still have to be the unmodified (non-NMU ones) so that the sources can be found. The version number in log files and mails will be modified by sbuild automatically.

--binNMU=NMU-version

The version number of the binary NMU. This should be used in conjunction with --make-binNMU. version is a single number for the (+bn) format used for binary NMUs.

--append-to-version=stringP

This option is similar to --make-binNMU except that it allows the user to specify an arbitrary string to be appended to the version number (immediately before the '+' in the Debian revision if --make-binNMU is also provided).

--setup-hook=hook-script

Run the specified script inside the chroot before building. This script may perform any required actions to customise or configure the chroot. Note that the script will be run inside the chroot, and so the script must exist inside the chroot rather than the host system.

ENVIRONMENT VARIABLES

The following environment variables are used by sbuild:

DEBEMAIL

The maintainer name of the user.

HOME

The home directory of the user.

LOGNAME

Used in lockfiles.

sourcebase

A URL for a Debian source distribution; generated by sbuild for scripts in source-dependencies.

binarybase

A URL for a Debian binary distribution; generated by sbuild for scripts in source-dependencies.

FILES

/etc/sbuild/sbuild.conf

Configuration, maintained by the system administrator. This may be used to override the defaults.

/etc/sbuild/chroot

Directory containing symbolic links to chroots. This is only used for sudo chroot access; schroot access uses the schroot chroot configuration.

~/.sbuildrc

User-specific configuration.

/var/lib/sbuild

Build statistics, source dependencies and lock files.

AUTHORS

Roman Hodek <Roman.Hodek@informatik.uni-erlangen.de>.

sbuild is based on debbuild, written by James Troup <james@nocrew.org> and has been modified by

 Ben Collins <bcollins@debian.org>,
 Ryan Murray <rmurray@debian.org>,
 Francesco Paolo Lovergine <frankie@debian.org>,
 Michael Banck <mbanck@debian.org>, and
 Roger Leigh <rleigh@debian.org>
 

COPYRIGHT

 Copyright © 1998-2000 Roman Hodek <roman@hodek.net>
 Copyright © 1998-1999 James Troup <troup@debian.org>
 Copyright © 2003-2006 Ryan Murray <rmurray@debian.org>
 Copyright © 2001-2003 Rick Younie <younie@debian.org>
 Copyright © 2003-2004 Francesco Paolo Lovergine <frankie@debian.org>
 Copyright © 2005      Michael Banck <mbanck@debian.org>
 Copyright © 2005-2008 Roger Leigh <rleigh@debian.org>
 

SEE ALSO

avg-pkg-build-time(1), schroot(1), sbuild-setup(7).