sbuild.conf(5)
NAME
sbuild.conf - configuration file for sbuild
DESCRIPTION
sbuild.conf is a Perl script which is sourced by sbuild to permit configuration. It is run in a sandbox and restricted to setting a small number of variables, detailed below, which may be set to configure the behaviour of sbuild. Each variable has an internal name, shown in all caps, and a perl variable showing the default setting. Note that the internal name is not accessible within sbuild.conf; only the variable may be assigned. Also note that some of the defaults are set to be unique for each build, and so some of the defaults shown here are unique to the user and system used to build sbuild, and will be different for your system. While sbuild permits many aspects of its behaviour to be configured, this should not normally be required. The defaults should be adequate for most uses, and should only be changed if you are doing something more advanced, or have specialist requirements.
CONFIGURATION
Build environment
LD_LIBRARY_PATH
STRING type. Library search path to use inside the chroot.
Related sbuild(1) command line options:
--use-snapshot
Default:
$ld_library_path = undef;
PATH STRING type. PATH to set when running dpkg-buildpackage.
Related sbuild(1) command line options:
--use-snapshot
Default:
$path =
'/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games';
Build options
APPEND_TO_VERSION
STRING type. Suffix to append to version number. May be useful
for derivative distributions.
Related sbuild(1) command line options:
--append-to-version
Default:
$append_to_version = undef;
BIN_NMU
STRING type. Binary NMU changelog entry.
Related sbuild(1) command line options:
--make-binNMU
Default:
$bin_nmu = undef;
BIN_NMU_VERSION
STRING type. Binary NMU version number.
Related sbuild(1) command line options:
--binNMU
--make-binNMU
Default:
$bin_nmu_version = undef;
BUILD_ARCH
STRING type. Build architecture (Arch we are building on).
Related sbuild(1) command line options:
--arch
--build
build_arch = ...;
BUILD_ARCH_ALL
BOOL type. Build architecture: all packages by default.
Related sbuild(1) command line options:
--arch-all
--no-arch-all
Default:
$build_arch_all = 0;
BUILD_ARCH_ANY
BOOL type. Build architecture: any packages by default.
Related sbuild(1) command line options:
--arch-any
--no-arch-any
Default:
$build_arch_any = 1;
BUILD_ENV_CMND
STRING type. This command is run with the dpkg-buildpackage
command line passed to it (in the chroot, if doing a chrooted
build). It is used by the sparc buildd (which is sparc64) to
call the wrapper script that sets the environment to sparc
(32-bit). It could be used for other build environment setup
scripts. Note that this is superceded by schroot's 'command-
prefix' option
Default:
$build_env_cmnd = '';
BUILD_PATH
STRING type. By default the package is built in a path of the
following format /build/packagename-XXXXXX/packagename-version/
where XXXXXX is a random ascii string. This option allows one to
specify a custom path where the package is built inside the
chroot. Notice that the sbuild user in the chroot must have
permissions to create the path. Common writable locations are
subdirectories of /tmp or /build. The buildpath must be an empty
directory because the last component of the path will be removed
after the build is finished. If you are running multiple sbuild
instances with the same build path in parallel for the same
package, make sure that your build path is not in a directory
commonly mounted by all sbuild instances (like /tmp or /home).
In that case, use for example /build instead. Otherwise, your
builds will probably fail or contain wrong content.
Related sbuild(1) command line options:
--build-path
Default:
$build_path = undef;
BUILD_PROFILES
STRING type. Build profiles. Separated by spaces.
Related sbuild(1) command line options:
--profiles
Default:
$build_profiles = '';
BUILD_SOURCE
BOOL type. By default, do not build a source package (binary
only build). Set to 1 to force creation of a source package,
but note that this is inappropriate for binary NMUs, where the
option will always be disabled.
Related sbuild(1) command line options:
-s
--source
--no-source
Default:
$build_source = 0;
CHECK_SPACE
BOOL type. Check free disk space prior to starting a build.
sbuild requires the free space to be at least twice the size of
the unpacked sources to allow a build to proceed. Can be
disabled to allow building if space is very limited, but the
threshold to abort a build has been exceeded despite there being
sufficient space for the build to complete.
Default:
$check_space = 1;
CLEAN_SOURCE
BOOL type. When running sbuild from within an unpacked source
tree, run the 'clean' target before generating the source
package. This might require some of the build dependencies
necessary for running the 'clean' target to be installed on the
host machine. Only disable if you start from a clean checkout
and you know what you are doing.
Related sbuild(1) command line options:
--clean-source
--no-clean-source
Default:
$clean_source = 1;
DISTRIBUTION
STRING type. Default distribution. By default, no distribution
is defined, and the user must specify it with the -d option.
However, a default may be configured here if desired. Users
must take care not to upload to the wrong distribution when this
option is set, for example experimental packages will be built
for upload to unstable when this is not what is required.
Related sbuild(1) command line options:
-d
--dist
Default:
$distribution = undef;
FORCE_ORIG_SOURCE
BOOL type. By default, the -s option only includes the
.orig.tar.gz when needed (i.e. when the Debian revision is 0 or
1). By setting this option to 1, the .orig.tar.gz will always
be included when -s is used.
Related sbuild(1) command line options:
--force-orig-source
Default:
$force_orig_source = 0;
GCC_SNAPSHOT
BOOL type. Build using current GCC snapshot?
Related sbuild(1) command line options:
--use-snapshot
Default:
$gcc_snapshot = 0;
HOST_ARCH
STRING type. Host architecture (Arch we are building for)
Related sbuild(1) command line options:
--arch
--host
host_arch = ...;
PGP_OPTIONS
ARRAY:STRING type. Additional signing options for dpkg-
buildpackage
Default:
$pgp_options = [
'-us',
'-uc'
];
SOURCE_ONLY_CHANGES
BOOL type. Also produce a changes file suitable for a source-
only upload.
Related sbuild(1) command line options:
--source-only-changes
Default:
$source_only_changes = 0;
TOOLCHAIN_REGEX
ARRAY:STRING type. Regular expressions identifying toolchain
packages. Note that for backward compatibility, this is also
settable using the array @toolchain_regex (deprecated), rather
than an array reference.
Default:
$toolchain_regex = [
'binutils$',
'dpkg-dev$',
'gcc-[\d.]+$',
'g\+\+-[\d.]+$',
'libstdc\+\+',
'libc[\d.]+-dev$',
'linux-kernel-headers$',
'linux-libc-dev$',
'gnumach-dev$',
'hurd-dev$',
'kfreebsd-kernel-headers$'
];
Build timeouts
INDIVIDUAL_STALLED_PKG_TIMEOUT
HASH:NUMERIC type. Some packages may exceed the general timeout
(e.g. redirecting output to a file) and need a different
timeout. This has is a mapping between source package name and
timeout. Note that for backward compatibility, this is also
settable using the hash %individual_stalled_pkg_timeout
(deprecated) , rather than a hash reference.
Example:
%individual_stalled_pkg_timeout = (smalleiffel => 300,
jade => 300,
atlas => 300,
glibc => 1000,
'gcc-3.3' => 300,
kwave => 600);
Default:
$individual_stalled_pkg_timeout = {};
LOCK_INTERVAL
NUMERIC type. Lock wait interval (seconds). Maximum wait time
is (max_lock_trys x lock_interval).
Default:
$lock_interval = 5;
MAX_LOCK_TRYS
NUMERIC type. Number of times to try waiting for a lock.
Default:
$max_lock_trys = 120;
STALLED_PKG_TIMEOUT
NUMERIC type. Time (in minutes) of inactivity after which a
build is terminated. Activity is measured by output to the log
file.
Default:
$stalled_pkg_timeout = 150;
Build validation
AUTOPKGTEST
STRING type. Path to autopkgtest binary
Related sbuild(1) command line options:
--autopkgtest-opt
--autopkgtest-opts
Default:
$autopkgtest = 'autopkgtest';
AUTOPKGTEST_OPTIONS
ARRAY:STRING type. Options to pass to autopkgtest. Each option
is a separate arrayref element. For example, ['-b',
'<chroot_tarball>'] to add -b and <chroot_tarball>.
Default:
$autopkgtest_opts = [];
AUTOPKGTEST_ROOT_ARGS
ARRAY:STRING type. Preceding arguments to launch autopkgtest as
root. With the default value (the empty array) "sudo --" will be
used as a prefix. If the first element in the array is the empty
string, no prefixing will be done. If the value is a scalar, it
will be prefixed by that string. If the scalar is an empty
string, no prefixing will be done.
Related sbuild(1) command line options:
--autopkgtest-root-arg
--autopkgtest-root-args
Example:
# prefix with "sudo --":
$autopkgtest_root_args = [];
$autopkgtest_root_args = ['sudo', '--'];
# prefix with "env":
$autopkgtest_root_args = ['env'];
$autopkgtest_root_args = 'env';
# prefix with nothing:
$autopkgtest_root_args = '';
$autopkgtest_root_args = [''];
$autopkgtest_root_args = ['', 'whatever'];
Default:
$autopkgtest_root_args = [];
LINTIAN
STRING type. Path to lintian binary
Default:
$lintian = 'lintian';
LINTIAN_OPTIONS
ARRAY:STRING type. Options to pass to lintian. Each option is
a separate arrayref element. For example, ['-i', '-v'] to add
-i and -v.
Related sbuild(1) command line options:
--lintian-opt
--lintian-opts
Default:
$lintian_opts = [];
PIUPARTS
STRING type. Path to piuparts binary
Related sbuild(1) command line options:
--piuparts-opt
--piuparts-opts
Default:
$piuparts = 'piuparts';
PIUPARTS_OPTIONS
ARRAY:STRING type. Options to pass to piuparts. Each option is
a separate arrayref element. For example, ['-b',
'<chroot_tarball>'] to add -b and <chroot_tarball>.
Default:
$piuparts_opts = [];
PIUPARTS_ROOT_ARGS
ARRAY:STRING type. Preceding arguments to launch piuparts as
root. With the default value (the empty array) "sudo --" will be
used as a prefix. If the first element in the array is the empty
string, no prefixing will be done. If the value is a scalar, it
will be prefixed by that string. If the scalar is an empty
string, no prefixing will be done.
Related sbuild(1) command line options:
--piuparts-root-arg
--piuparts-root-args
Example:
# prefix with "sudo --":
$piuparts_root_args = [];
$piuparts_root_args = ['sudo', '--'];
# prefix with "env":
$piuparts_root_args = ['env'];
$piuparts_root_args = 'env';
# prefix with nothing:
$piuparts_root_args = '';
$piuparts_root_args = [''];
$piuparts_root_args = ['', 'whatever'];
Default:
$piuparts_root_args = [];
RUN_AUTOPKGTEST
BOOL type. Run autopkgtest
Related sbuild(1) command line options:
--run-autopkgtest
--no-run-autopkgtest
Default:
$run_autopkgtest = 0;
RUN_LINTIAN
BOOL type. Run lintian?
Related sbuild(1) command line options:
--run-lintian
--no-run-lintian
Default:
$run_lintian = 0;
RUN_PIUPARTS
BOOL type. Run piuparts
Related sbuild(1) command line options:
--run-piuparts
--no-run-piuparts
Default:
$run_piuparts = 0;
Chroot options
APT_ALLOW_UNAUTHENTICATED
BOOL type. Force APT to accept unauthenticated packages. By
default, unauthenticated packages are not allowed. This is to
keep the build environment secure, using apt-secure(8). By
setting this to 1, APT::Get::AllowUnauthenticated is set to
"true" when running apt-get. This is disabled by default: only
enable it if you know what you are doing.
Default:
$apt_allow_unauthenticated = 0;
APT_CLEAN
BOOL type. APT clean. 1 to enable running "apt-get clean" at
the start of each build, or 0 to disable.
Related sbuild(1) command line options:
--apt-clean
--no-apt-clean
Default:
$apt_clean = 0;
APT_DISTUPGRADE
BOOL type. APT distupgrade. 1 to enable running "apt-get dist-
upgrade" at the start of each build, or 0 to disable.
Related sbuild(1) command line options:
--apt-distupgrade
--no-apt-distupgrade
Default:
$apt_distupgrade = 1;
APT_UPDATE
BOOL type. APT update. 1 to enable running "apt-get update" at
the start of each build, or 0 to disable.
Related sbuild(1) command line options:
--apt-update
--no-apt-update
Default:
$apt_update = 1;
APT_UPDATE_ARCHIVE_ONLY
BOOL type. Update local temporary APT archive directly (1, the
default) or set to 0 to disable and do a full apt update (not
recommended in case the mirror content has changed since the
build started).
Default:
$apt_update_archive_only = 1;
APT_UPGRADE
BOOL type. APT upgrade. 1 to enable running "apt-get upgrade"
at the start of each build, or 0 to disable.
Related sbuild(1) command line options:
--apt-upgrade
--no-apt-upgrade
Default:
$apt_upgrade = 0;
CHROOT STRING type. Default chroot (defaults to
distribution[-arch][-sbuild])
Related sbuild(1) command line options:
-c
--chroot
Default:
$chroot = undef;
CHROOT_MODE
STRING type. Mechanism to use for chroot virtualisation.
Possible value are "schroot" (default), "sudo" and "adt".
Related sbuild(1) command line options:
--chroot-mode
Default:
$chroot_mode = 'schroot';
CHROOT_SETUP_SCRIPT
STRING type. Script to run to perform custom setup tasks in the
chroot.
Related sbuild(1) command line options:
--setup-hook
Default:
$chroot_setup_script = undef;
CHROOT_SPLIT
BOOL type. Run in split mode? In split mode, apt-get and dpkg
are run on the host system, rather than inside the chroot.
Default:
$chroot_split = 0;
EXTERNAL_COMMANDS
HASH:ARRAY:STRING type. External commands to run at various
stages of a build. Commands are held in a hash of arrays of
arrays data structure.
Related sbuild(1) command line options:
--setup-hook
--pre-build-commands
--chroot-setup-commands
--chroot-update-failed-commands
--build-deps-failed-commands
--build-failed-commands
--anything-failed-commands
--starting-build-commands
--finished-build-commands
--chroot-cleanup-commands
--post-build-commands
Example:
$external_commands = {
"pre-build-commands" => [
['foo', 'arg1', 'arg2'],
['bar', 'arg1', 'arg2', 'arg3'],
],
"chroot-setup-commands" => [
['foo', 'arg1', 'arg2'],
['bar', 'arg1', 'arg2', 'arg3'],
],
"chroot-update-failed-commands" => [
['foo', 'arg1', 'arg2'],
['bar', 'arg1', 'arg2', 'arg3'],
],
"build-deps-failed-commands" => [
['foo', 'arg1', 'arg2'],
['bar', 'arg1', 'arg2', 'arg3'],
],
"build-failed-commands" => [
['foo', 'arg1', 'arg2'],
['bar', 'arg1', 'arg2', 'arg3'],
],
"starting-build-commands" => [
['foo', 'arg1', 'arg2'],
['bar', 'arg1', 'arg2', 'arg3'],
],
"finished-build-commands" => [
['foo', 'arg1', 'arg2'],
['bar', 'arg1', 'arg2', 'arg3'],
],
"chroot-cleanup-commands" => [
['foo', 'arg1', 'arg2'],
['bar', 'arg1', 'arg2', 'arg3'],
],
"post-build-commands" => [
['foo', 'arg1', 'arg2'],
['bar', 'arg1', 'arg2', 'arg3'],
],
};
Default:
$external_commands = {
'build-deps-failed-commands' => [],
'build-failed-commands' => [],
'chroot-cleanup-commands' => [],
'chroot-setup-commands' => [],
'chroot-update-failed-commands' => [],
'finished-build-commands' => [],
'post-build-commands' => [],
'pre-build-commands' => [],
'starting-build-commands' => []
};
LOG_EXTERNAL_COMMAND_ERROR
BOOL type. Log standard error of commands run by sbuild?
Related sbuild(1) command line options:
--log-external-command-error
Default:
$log_external_command_error = 1;
LOG_EXTERNAL_COMMAND_OUTPUT
BOOL type. Log standard output of commands run by sbuild?
Related sbuild(1) command line options:
--log-external-command-output
Default:
$log_external_command_output = 1;
PACKAGE_CHECKLIST
STRING type. Where to store list currently installed packages
inside chroot
Default:
$package_checklist = '/var/lib/sbuild/package-checklist';
PURGE_BUILD_DEPS
STRING type. When to purge the build dependencies after a
build; possible values are "never", "successful", and "always"
Related sbuild(1) command line options:
-p
--purge
--purge-deps
Default:
$purge_build_deps = 'always';
PURGE_BUILD_DIRECTORY
STRING type. When to purge the build directory after a build;
possible values are "never", "successful", and "always"
Related sbuild(1) command line options:
-p
--purge
--purge-build
Default:
$purge_build_directory = 'always';
PURGE_SESSION
STRING type. Purge the schroot session following a build. This
is useful in conjunction with the --purge and --purge-deps
options when using snapshot chroots, since by default the
snapshot will be deleted. Possible values are "always"
(default), "never", and "successful"
Related sbuild(1) command line options:
-p
--purge
--purge-session
Default:
$purge_session = 'always';
Core options
ARCHIVE
STRING type. Archive being built. Only set in build log. This
might be useful for derivative distributions.
Related sbuild(1) command line options:
--archive
Default:
$archive = undef;
BATCH_MODE
BOOL type. Enable batch mode?
Related sbuild(1) command line options:
-b
--batch
Default:
$batch_mode = 0;
BUILD_DIR
STRING type. This option is deprecated. Directory for chroot
symlinks and sbuild logs. Defaults to the current directory if
unspecified. It is used as the location of chroot symlinks
(obsolete) and for current build log symlinks and some build
logs. There is no default; if unset, it defaults to the current
working directory. $HOME/build is another common configuration.
Example:
$build_dir = '/home/pete/build';
build_dir = ...;
BUILD_ENVIRONMENT
HASH:STRING type. Environment to set during the build.
Defaults to setting PATH and LD_LIBRARY_PATH only. Note that
these environment variables are not subject to filtering with
ENVIRONMENT_FILTER. Example:
Example:
$build_environment = {
'CCACHE_DIR' => '/build/cache'
};
Default:
$build_environment = {};
BUILD_USER
STRING type. Username used for running dpkg-buildpackage. By
default the user running sbuild is used within the chroot as
well but that might allow a process from within the chroot to
break out of the chroot by attaching to a process running
outside the chroot with eg. gdb and then becoming root inside
the chroot through schroot and thus be able to leave the chroot.
build_user = ...;
CORE_DEPENDS
ARRAY:STRING type. Packages which must be installed in the
chroot for all builds.
Default:
$core_depends = [
'build-essential:native',
'fakeroot:native'
];
ENVIRONMENT_FILTER
ARRAY:STRING type. Only environment variables matching one of
the regular expressions in this arrayref will be passed to dpkg-
buildpackage and other programs run by sbuild.
Default:
$environment_filter = [
'^PATH$',
'^DEB(IAN|SIGN)?_[A-Z_]+$',
'^(C(PP|XX)?|LD|F)FLAGS(_APPEND)?$',
'^USER(NAME)?$',
'^LOGNAME$',
'^HOME$',
'^TERM$',
'^SHELL$'
];
JOB_FILE
STRING type. Job status file (only used in batch mode)
Default:
$job_file = 'build-progress';
MANUAL_CONFLICTS
ARRAY:STRING type. Additional per-build dependencies.
Related sbuild(1) command line options:
--add-conflicts
Default:
$manual_conflicts = [];
MANUAL_CONFLICTS_ARCH
ARRAY:STRING type. Additional per-build dependencies.
Related sbuild(1) command line options:
--add-conflicts-arch
Default:
$manual_conflicts_arch = [];
MANUAL_CONFLICTS_INDEP
ARRAY:STRING type. Additional per-build dependencies.
Related sbuild(1) command line options:
--add-conflicts-indep
Default:
$manual_conflicts_indep = [];
MANUAL_DEPENDS
ARRAY:STRING type. Additional per-build dependencies.
Related sbuild(1) command line options:
--add-depends
Default:
$manual_depends = [];
MANUAL_DEPENDS_ARCH
ARRAY:STRING type. Additional per-build dependencies.
Related sbuild(1) command line options:
--add-depends-arch
Default:
$manual_depends_arch = [];
MANUAL_DEPENDS_INDEP
ARRAY:STRING type. Additional per-build dependencies.
Related sbuild(1) command line options:
--add-depends-indep
Default:
$manual_depends_indep = [];
SBUILD_MODE
STRING type. sbuild behaviour; possible values are "user" (exit
status reports build failures) and "buildd" (exit status does
not report build failures) for use in a buildd setup. "buildd"
also currently implies enabling of "legacy features" such as
chroot symlinks in the build directory and the creation of
current symlinks in the build directory.
Related sbuild(1) command line options:
--sbuild-mode
Default:
$sbuild_mode = 'user';
Dependency resolution
ASPCUD_CRITERIA
STRING type. Optimization criteria in extended MISC 2012 syntax
passed to aspcud through apt-cudf. Optimization criteria are
separated by commas, sorted by decreasing order of priority and
are prefixed with a polarity (+ to maximize and - to minimize).
The default criteria is '-removed,-changed,-new' which first
minimizes the number of removed packages, then the number of
changed packages (up or downgrades) and then the number of new
packages. A common task is to minimize the number of packages
from experimental. To do this you can add a criteria like
'-count(solution,APT-Release:=/a=experimental/)' to the default
criteria. This will then minimize the number of packages in the
solution which contain the string 'a=experimental' in the 'APT-
Release' field of the EDSP output created by apt. See the apt-
cudf man page help on the --criteria option for more
information.
Related sbuild(1) command line options:
--aspcud-criteria
Default:
$aspcud_criteria = '-removed,-changed,-new';
BUILD_DEP_RESOLVER
STRING type. Build dependency resolver. The 'apt' resolver is
currently the default, and recommended for most users. This
resolver uses apt-get to resolve dependencies. Alternative
resolvers are 'apt', 'aptitude' and 'aspcud'. The 'apt' resolver
uses a built-in resolver module while the 'aptitude' resolver
uses aptitude to resolve build dependencies. The aptitude
resolver is similar to apt, but is useful in more complex
situations, such as where multiple distributions are required,
for example when building from experimental, where packages are
needed from both unstable and experimental, but defaulting to
unstable. If the dependency situation is too complex for either
apt or aptitude to solve it, you can use the 'aspcud' resolver
which (in contrast to apt and aptitude) is a real solver (in the
math sense) and will thus always find a solution if a solution
exists.
Related sbuild(1) command line options:
--build-dep-resolver
Default:
$build_dep_resolver = 'apt';
EXTRA_PACKAGES
ARRAY:STRING type. Additional per-build packages available as
build dependencies.
Related sbuild(1) command line options:
--extra-package
Default:
$extra_packages = [];
EXTRA_REPOSITORIES
ARRAY:STRING type. Additional per-build apt repositories.
Related sbuild(1) command line options:
--extra-repository
Default:
$extra_repositories = [];
EXTRA_REPOSITORY_KEYS
ARRAY:STRING type. Additional per-build apt repository keys.
Related sbuild(1) command line options:
--extra-repository-key
Default:
$extra_repository_keys = [];
RESOLVE_ALTERNATIVES
BOOL type. Should the dependency resolver use alternatives in
Build-Depends, Build-Depends-Arch and Build-Depends-Indep? By
default, using 'apt' resolver, only the first alternative will
be used; all other alternatives will be removed. When using the
'aptitude' resolver, it will default to using all alternatives.
Note that this does not include architecture-specific
alternatives, which are reduced to the build architecture prior
to alternatives removal. This should be left disabled when
building for unstable; it may be useful when building for
experimental or backports. Set to undef to use the default, 1
to enable, or 0 to disable.
Related sbuild(1) command line options:
--resolve-alternatives
--no-resolve-alternatives
Example:
$resolve_alternatives = 0;
Default:
$resolve_alternatives = undef;
SBUILD_BUILD_DEPENDS_PUBLIC_KEY
STRING type. GPG public key for temporary local apt archive.
Default:
$sbuild_build_depends_public_key = '/var/lib/sbuild/apt-
keys/sbuild-key.pub';
SBUILD_BUILD_DEPENDS_SECRET_KEY
STRING type. GPG secret key for temporary local apt archive.
Default:
$sbuild_build_depends_secret_key = '/var/lib/sbuild/apt-
keys/sbuild-key.sec';
Logging options
COMPRESS_BUILD_LOG_MAILS
BOOL type. Should build log mails be compressed?
Default:
$compress_build_log_mails = 1;
DEBUG NUMERIC type. Debug logging level
Default:
$debug = 0;
LOG_COLOUR
BOOL type. Colour log messages such as critical failures,
warnings and success
Default:
$log_colour = 1;
LOG_DIR
STRING type. Directory for storing build logs. This defaults
to '.' when SBUILD_MODE is set to 'user' (the default), and to
'$HOME/logs' when SBUILD_MODE is set to 'buildd'.
Default:
$log_dir = undef;
LOG_FILTER
BOOL type. Filter variable strings from log messages such as
the chroot name and build directory
Default:
$log_filter = 1;
MAILFROM
STRING type. email address set in the From line of build logs
Related sbuild(1) command line options:
--mailfrom
Default:
$mailfrom = 'Source Builder <sbuild>';
MAILTO STRING type. email address to mail build logs to
Related sbuild(1) command line options:
--mail-log-to
Default:
$mailto = '';
MAILTO_HASH
HASH:STRING type. Like MAILTO, but per-distribution. This is a
hashref mapping distribution name to MAILTO. Note that for
backward compatibility, this is also settable using the hash
%mailto (deprecated), rather than a hash reference.
Default:
$mailto_hash = {};
MIME_BUILD_LOG_MAILS
BOOL type. Should build log mails be MIME encoded?
Default:
$mime_build_log_mails = 1;
NOLOG BOOL type. Disable use of log file
Related sbuild(1) command line options:
-n
--nolog
Default:
$nolog = 0;
VERBOSE
NUMERIC type. Verbose logging level
Default:
$verbose = 0;
Maintainer options
KEY_ID STRING type. Key ID to use in .changes for the current upload.
It overrides both $maintainer_name and $uploader_name.
Related sbuild(1) command line options:
-k
--keyid
Default:
$key_id = undef;
MAINTAINER_NAME
STRING type. Name to use as override in .changes files for the
Maintainer field. The Maintainer field will not be overridden
unless set here.
Related sbuild(1) command line options:
-m
--maintainer
Default:
$maintainer_name = undef;
UPLOADER_NAME
STRING type. Name to use as override in .changes file for the
Changed-By: field.
Related sbuild(1) command line options:
-e
--uploader
Default:
$uploader_name = undef;
Multiarch support (transitional)
CROSSBUILD_CORE_DEPENDS
HASH:ARRAY:STRING type. Per-architecture dependencies required
for cross-building. By default, if a Debian architecture is not
found as a key in this hash, the package crossbuild-
essential-${hostarch}:native will be installed.
Example:
$crossbuild_core_depends = {
nios2 => ['crossbuild-essential-nios2:native', 'special-
package'],
musl-linux-mips => ['crossbuild-essential-musl-linux-
mips:native', 'super-special'],
}
Default:
$crossbuild_core_depends = {};
Programs
ADT_VIRT_SERVER
STRING type. Path to adt-virt-* binary, selecting the
virtualization server.
Related sbuild(1) command line options:
--adt-virt-server
Default:
$adt_virt_server = 'adt-virt-schroot';
ADT_VIRT_SERVER_OPTIONS
ARRAY:STRING type. Additional command-line options for adt-
virt-*
Related sbuild(1) command line options:
--adt-virt-server-opt
--adt-virt-server-opts
Default:
$adt_virt_server_options = [];
APTITUDE
STRING type. Path to aptitude binary
Default:
$aptitude = 'aptitude';
APT_CACHE
STRING type. Path to apt-cache binary
Default:
$apt_cache = 'apt-cache';
APT_GET
STRING type. Path to apt-get binary
Default:
$apt_get = 'apt-get';
DCMD STRING type. Path to dcmd binary
Default:
$dcmd = 'dcmd';
DPKG_BUILDPACKAGE_USER_OPTIONS
ARRAY:STRING type. Additional command-line options for dpkg-
buildpackage.
Related sbuild(1) command line options:
--debbuildopt
--debbuildopts
--jobs
Default:
$dpkg_buildpackage_user_options = [];
DPKG_SOURCE
STRING type. Path to dpkg-source binary
Default:
$dpkg_source = 'dpkg-source';
DPKG_SOURCE_OPTIONS
ARRAY:STRING type. Additional command-line options for dpkg-
source
Related sbuild(1) command line options:
--dpkg-source-opt
--dpkg-source-opts
Default:
$dpkg_source_opts = [];
FAKEROOT
STRING type. Path to fakeroot binary
Default:
$fakeroot = 'fakeroot';
MAILPROG
STRING type. Program to use to send mail
Default:
$mailprog = '/usr/sbin/sendmail';
MD5SUM STRING type. Path to md5sum binary
Default:
$md5sum = 'md5sum';
SCHROOT_OPTIONS
ARRAY:STRING type. Additional command-line options for schroot
Default:
$schroot_options = [
'-q'
];
SU STRING type. Path to su binary
Default:
$su = 'su';
SUDO STRING type. Path to sudo binary
Default:
$sudo = 'sudo';
XAPT STRING type.
Default:
$xapt = 'xapt';
Statistics
STATS_DIR
STRING type. Directory for writing build statistics to
Related sbuild(1) command line options:
--stats-dir
stats_dir = ...;
FILES
/etc/sbuild/sbuild.conf
Configuration, maintained by the system administrator. This may
be used to override the defaults.
~/.sbuildrc
User-specific configuration.
AUTHORS
Roman Hodek <[email protected]>. sbuild is based on debbuild, written by James Troup <[email protected]> and has been modified by Ben Collins <[email protected]>, Ryan Murray <[email protected]>, Francesco Paolo Lovergine <[email protected]>, Michael Banck <[email protected]>, and Roger Leigh <[email protected]>
COPYRIGHT
Copyright 1998-2000 Roman Hodek <[email protected]> Copyright 1998-1999 James Troup <[email protected]> Copyright 2003-2006 Ryan Murray <[email protected]> Copyright 2001-2003 Rick Younie <[email protected]> Copyright 2003-2004 Francesco Paolo Lovergine <[email protected]> Copyright 2005 Michael Banck <[email protected]> Copyright 2005-2009 Roger Leigh <[email protected]>
SEE ALSO
sbuild(1).
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
