.lf 1 ./sbuild.conf.5.in .\" Copyright © 2011 Roger Leigh .\" .\" This program is free software: you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation, either version 2 of the License, or .\" (at your option) any later version. .\" .\" This program is distributed in the hope that it will be useful, but .\" WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU .\" General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see .\" . .lf 1 ./defs.man .ds WANNA_BUILD_CONF @WANNA_BUILD_CONF@ .ds SCHROOT_CONF /etc/schroot/schroot.conf .ds WANNA_BUILD_SYSCONF_DIR @WANNA_BUILD_SYSCONF_DIR@ .ds SCHROOT_SYSCONF_DIR /etc/schroot .ds BUILDD_CONF /etc/buildd/buildd.conf .ds BUILDD_SYSCONF_DIR /etc/buildd .ds SBUILD_CONF /etc/sbuild/sbuild.conf .ds SBUILD_SYSCONF_DIR /etc/sbuild .ds WANNA_BUILD_LIBEXEC_DIR @WANNA_BUILD_LIBEXEC_DIR@ .ds SBUILD_LIBEXEC_DIR /usr/libexec/sbuild .ds RELEASE_DATE 12 April 2024 .ds VERSION 0.85.7 .ds PACKAGE sbuild .ds PACKAGE_URL .ds PACKAGE_BUGREPORT buildd-tools-devel@lists.alioth.debian.org .ds PACKAGE_STRING sbuild 0.85.7 .ds PACKAGE_VERSION 0.85.7 .ds PACKAGE_TARNAME sbuild .ds PACKAGE_NAME sbuild .lf 17 ./sbuild.conf.5.in .TH SBUILD.CONF 5 "\*[RELEASE_DATE]" "Version \*[VERSION]" "Debian sbuild" .SH NAME sbuild.conf \- configuration file for sbuild .SH DESCRIPTION \fBsbuild.conf\fR 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. .PP 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. .SH CONFIGURATION .lf 1 ./sbuild.conf.man .SS Build environment .TP .BR LD_LIBRARY_PATH STRING type. Library search path to use inside the chroot. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--use-snapshot\fP .br .RE .IP Default: .PP .RS \f[CR]$ld_library_path = undef;\fP .br .RE .TP .BR PATH STRING type. PATH to set when running dpkg-buildpackage. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--use-snapshot\fP .br .RE .IP Default: .PP .RS \f[CR]$path = '/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games';\fP .br .RE .SS Build options .TP .BR APPEND_TO_VERSION STRING type. Suffix to append to version number. May be useful for derivative distributions. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--append-to-version\fP .br .RE .IP Default: .PP .RS \f[CR]$append_to_version = undef;\fP .br .RE .TP .BR BIN_NMU STRING type. Binary NMU changelog entry. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--make-binNMU\fP .br .RE .IP Default: .PP .RS \f[CR]$bin_nmu = undef;\fP .br .RE .TP .BR BIN_NMU_CHANGELOG STRING type. The content of a binary-only changelog entry. Leading and trailing newlines will be stripped. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--binNMU-changelog\fP .br .RE .IP Default: .PP .RS \f[CR]$bin_nmu_changelog = undef;\fP .br .RE .TP .BR BIN_NMU_TIMESTAMP STRING type. Binary NMU timestamp. The timestamp is either given as n integer in Unix time or as a string in the format compatible with Debian changelog entries (i.e. as it is generated by date -R). If set to the default (undef) the date at build time is used. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--binNMU-timestamp\fP .br .RE .IP Default: .PP .RS \f[CR]$bin_nmu_timestamp = undef;\fP .br .RE .TP .BR BIN_NMU_VERSION STRING type. Binary NMU version number. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--binNMU\fP .br \f[CR]--make-binNMU\fP .br .RE .IP Default: .PP .RS \f[CR]$bin_nmu_version = undef;\fP .br .RE .TP .BR BUILD_ARCH STRING type. Build architecture (Arch we are building on). .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--arch\fP .br \f[CR]--build\fP .br .RE .PP .RS \f[CR]build_arch = ...;\fP .br .RE .TP .BR BUILD_ARCH_ALL BOOL type. Build architecture: all packages by default. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--arch-all\fP .br \f[CR]--no-arch-all\fP .br .RE .IP Default: .PP .RS \f[CR]$build_arch_all = undef;\fP .br .RE .TP .BR BUILD_ARCH_ANY BOOL type. Build architecture: any packages by default. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--arch-any\fP .br \f[CR]--no-arch-any\fP .br .RE .IP Default: .PP .RS \f[CR]$build_arch_any = 1;\fP .br .RE .TP .BR 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 superseded by schroot's 'command-prefix' option .IP Default: .PP .RS \f[CR]$build_env_cmnd = '';\fP .br .RE .TP .BR 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. The sbuild user in the chroot must have permissions to create the path. Common writable locations are subdirectories of /tmp or /build. Using /tmp might be dangerous, because (depending on the chroot backend) the /tmp inside the chroot might be a world writable location that can be accessed by processes outside the chroot. The directory /build can only be accessed by the sbuild user and group and should be a safe location. The buildpath must be an empty directory because the last component of the path will be removed after the build is finished. Notice that depending on the chroot backend (see CHROOT_MODE), some locations inside the chroot might be bind mounts that are shared with other sbuild instances. You must avoid using these shared locations as the build path or otherwise concurrent runs of sbuild will likely fail. With the default schroot chroot backend, the directory /build is shared between multiple schroot sessions. You can change this behaviour in /etc/schroot/sbuild/fstab. The behaviour of other chroot backends will vary. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--build-path\fP .br .RE .IP Default: .PP .RS \f[CR]$build_path = undef;\fP .br .RE .TP .BR BUILD_PROFILES STRING type. Build profiles. Separated by spaces. Defaults to the value of the DEB_BUILD_PROFILES environment variable when building natively and to the cross and nocheck profiles when cross-building. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--profiles\fP .br .RE .IP Default: .PP .RS \f[CR]$build_profiles = undef;\fP .br .RE .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-s\fP .br \f[CR]--source\fP .br \f[CR]--no-source\fP .br .RE .IP Default: .PP .RS \f[CR]$build_source = 0;\fP .br .RE .TP .BR 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. .IP Default: .PP .RS \f[CR]$check_space = 1;\fP .br .RE .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--clean-source\fP .br \f[CR]--no-clean-source\fP .br .RE .IP Default: .PP .RS \f[CR]$clean_source = 1;\fP .br .RE .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-d\fP .br \f[CR]--dist\fP .br .RE .IP Default: .PP .RS \f[CR]$distribution = undef;\fP .br .RE .TP .BR DSC_DIR STRING type. By default the package is built in a path of the following format /build/packagename-XXXXXX/packagename-version/ where packagename-version are replaced by the values in debian/changelog. This option allows one to specify a custom packagename-version path where the package is built inside the chroot. This is useful to specify a static path for different versions for example for ccache. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--dsc-dir\fP .br .RE .IP Default: .PP .RS \f[CR]$dsc_dir = undef;\fP .br .RE .TP .BR ENABLE_NETWORK STRING type. By default network access is blocked during build (only implemented for the unshare mode). This lifts the restriction. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--enable-network\fP .br .RE .IP Default: .PP .RS \f[CR]$enable_network = 0;\fP .br .RE .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--force-orig-source\fP .br .RE .IP Default: .PP .RS \f[CR]$force_orig_source = 0;\fP .br .RE .TP .BR GCC_SNAPSHOT BOOL type. Build using current GCC snapshot? .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--use-snapshot\fP .br .RE .IP Default: .PP .RS \f[CR]$gcc_snapshot = 0;\fP .br .RE .TP .BR HOST_ARCH STRING type. Host architecture (Arch we are building for) .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--arch\fP .br \f[CR]--host\fP .br .RE .PP .RS \f[CR]host_arch = ...;\fP .br .RE .TP .BR PGP_OPTIONS ARRAY:STRING type. Additional signing options for dpkg-buildpackage .IP Default: .PP .RS \f[CR]$pgp_options = [\fP .br \f[CR] '-us',\fP .br \f[CR] '-uc'\fP .br \f[CR] ];\fP .br .RE .TP .BR SOURCE_ONLY_CHANGES BOOL type. Also produce a changes file suitable for a source-only upload. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--source-only-changes\fP .br .RE .IP Default: .PP .RS \f[CR]$source_only_changes = 0;\fP .br .RE .TP .BR 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. .IP Default: .PP .RS \f[CR]$toolchain_regex = [\fP .br \f[CR] 'binutils$',\fP .br \f[CR] 'dpkg-dev$',\fP .br \f[CR] 'gcc-[\\d.]+$',\fP .br \f[CR] 'g\\+\\+-[\\d.]+$',\fP .br \f[CR] 'libstdc\\+\\+',\fP .br \f[CR] 'libc[\\d.]+-dev$',\fP .br \f[CR] 'linux-kernel-headers$',\fP .br \f[CR] 'linux-libc-dev$',\fP .br \f[CR] 'gnumach-dev$',\fP .br \f[CR] 'hurd-dev$',\fP .br \f[CR] 'kfreebsd-kernel-headers$'\fP .br \f[CR] ];\fP .br .RE .SS Build timeouts .TP .BR 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. .IP Example: .PP .RS \f[CR]$individual_stalled_pkg_timeout->{'llvm-toolchain-3.8'} = 300;\fP .br \f[CR]$individual_stalled_pkg_timeout->{'kicad-packages3d'} = 90;\fP .br .RE .IP Default: .PP .RS \f[CR]$individual_stalled_pkg_timeout = {};\fP .br .RE .TP .BR LOCK_INTERVAL NUMERIC type. Lock wait interval (seconds). Maximum wait time is (max_lock_trys x lock_interval). .IP Default: .PP .RS \f[CR]$lock_interval = 5;\fP .br .RE .TP .BR MAX_LOCK_TRYS NUMERIC type. Number of times to try waiting for a lock. .IP Default: .PP .RS \f[CR]$max_lock_trys = 120;\fP .br .RE .TP .BR 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. .IP Default: .PP .RS \f[CR]$stalled_pkg_timeout = 150;\fP .br .RE .SS Build validation .TP .BR AUTOPKGTEST STRING type. Path to autopkgtest binary .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--autopkgtest-opt\fP .br \f[CR]--autopkgtest-opts\fP .br .RE .IP Default: .PP .RS \f[CR]$autopkgtest = 'autopkgtest';\fP .br .RE .TP .BR AUTOPKGTEST_OPTIONS ARRAY:STRING type. Options to pass to autopkgtest. Each option is a separate arrayref element. For example, ['-b', ''] to add -b and . .IP Default: .PP .RS \f[CR]$autopkgtest_opts = [];\fP .br .RE .TP .BR AUTOPKGTEST_REQUIRE_SUCCESS BOOL type. Let sbuild fail if autopkgtest fails. .IP Default: .PP .RS \f[CR]$autopkgtest_require_success = 0;\fP .br .RE .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--autopkgtest-root-arg\fP .br \f[CR]--autopkgtest-root-args\fP .br .RE .IP Example: .PP .RS \f[CR]# prefix with "sudo --":\fP .br \f[CR]$autopkgtest_root_args = [];\fP .br \f[CR]$autopkgtest_root_args = ['sudo', '--'];\fP .br \f[CR]# prefix with "env":\fP .br \f[CR]$autopkgtest_root_args = ['env'];\fP .br \f[CR]$autopkgtest_root_args = 'env';\fP .br \f[CR]# prefix with nothing:\fP .br \f[CR]$autopkgtest_root_args = '';\fP .br \f[CR]$autopkgtest_root_args = [''];\fP .br \f[CR]$autopkgtest_root_args = ['', 'whatever'];\fP .br .RE .IP Default: .PP .RS \f[CR]$autopkgtest_root_args = [];\fP .br .RE .TP .BR LINTIAN STRING type. Path to lintian binary .IP Default: .PP .RS \f[CR]$lintian = 'lintian';\fP .br .RE .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--lintian-opt\fP .br \f[CR]--lintian-opts\fP .br .RE .IP Default: .PP .RS \f[CR]$lintian_opts = [];\fP .br .RE .TP .BR LINTIAN_REQUIRE_SUCCESS BOOL type. Let sbuild fail if lintian fails. .IP Default: .PP .RS \f[CR]$lintian_require_success = 0;\fP .br .RE .TP .BR PIUPARTS STRING type. Path to piuparts binary .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--piuparts-opt\fP .br \f[CR]--piuparts-opts\fP .br .RE .IP Default: .PP .RS \f[CR]$piuparts = 'piuparts';\fP .br .RE .TP .BR PIUPARTS_OPTIONS ARRAY:STRING type. Options to pass to piuparts. Each option is a separate arrayref element. For example, ['-b', ''] to add -b and . .IP Default: .PP .RS \f[CR]$piuparts_opts = [];\fP .br .RE .TP .BR PIUPARTS_REQUIRE_SUCCESS BOOL type. Let sbuild fail if piuparts fails. .IP Default: .PP .RS \f[CR]$piuparts_require_success = 0;\fP .br .RE .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--piuparts-root-arg\fP .br \f[CR]--piuparts-root-args\fP .br .RE .IP Example: .PP .RS \f[CR]# prefix with "sudo --":\fP .br \f[CR]$piuparts_root_args = [];\fP .br \f[CR]$piuparts_root_args = ['sudo', '--'];\fP .br \f[CR]# prefix with "env":\fP .br \f[CR]$piuparts_root_args = ['env'];\fP .br \f[CR]$piuparts_root_args = 'env';\fP .br \f[CR]# prefix with nothing:\fP .br \f[CR]$piuparts_root_args = '';\fP .br \f[CR]$piuparts_root_args = [''];\fP .br \f[CR]$piuparts_root_args = ['', 'whatever'];\fP .br .RE .IP Default: .PP .RS \f[CR]$piuparts_root_args = [];\fP .br .RE .TP .BR RUN_AUTOPKGTEST BOOL type. Run autopkgtest .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--run-autopkgtest\fP .br \f[CR]--no-run-autopkgtest\fP .br .RE .IP Default: .PP .RS \f[CR]$run_autopkgtest = 0;\fP .br .RE .TP .BR RUN_LINTIAN BOOL type. Run lintian? .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--run-lintian\fP .br \f[CR]--no-run-lintian\fP .br .RE .IP Default: .PP .RS \f[CR]$run_lintian = 1;\fP .br .RE .TP .BR RUN_PIUPARTS BOOL type. Run piuparts .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--run-piuparts\fP .br \f[CR]--no-run-piuparts\fP .br .RE .IP Default: .PP .RS \f[CR]$run_piuparts = 0;\fP .br .RE .SS Chroot options .TP .BR 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. .IP Default: .PP .RS \f[CR]$apt_allow_unauthenticated = 0;\fP .br .RE .TP .BR APT_CLEAN BOOL type. APT clean. 1 to enable running "apt-get clean" at the start of each build, or 0 to disable. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--apt-clean\fP .br \f[CR]--no-apt-clean\fP .br .RE .IP Default: .PP .RS \f[CR]$apt_clean = 0;\fP .br .RE .TP .BR APT_DISTUPGRADE BOOL type. APT distupgrade. 1 to enable running "apt-get dist-upgrade" at the start of each build, or 0 to disable. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--apt-distupgrade\fP .br \f[CR]--no-apt-distupgrade\fP .br .RE .IP Default: .PP .RS \f[CR]$apt_distupgrade = 1;\fP .br .RE .TP .BR APT_KEEP_DOWNLOADED_PACKAGES BOOL type. Keep downloaded packages in cache by APT. Controls APT::Keep-Downloaded-Packages option used when downloading dependencies. This option only makes sense if /var/cache/apt/archive inside the chroot is made persistent between multiple sbuild invocations. 1 to keep downloaded packages in cache, or 0 to delete them after installation. .IP Default: .PP .RS \f[CR]$apt_keep_downloaded_packages = 0;\fP .br .RE .TP .BR APT_UPDATE BOOL type. APT update. 1 to enable running "apt-get update" at the start of each build, or 0 to disable. This option has no effect on updating the internal sbuild apt repository, the repository for extra packages (see EXTRA_PACKAGES) and the repositories given via EXTRA_REPOSITORIES. These are always updated. Thus, this option only influences updates of the default repositories of the chroot. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--apt-update\fP .br \f[CR]--no-apt-update\fP .br .RE .IP Default: .PP .RS \f[CR]$apt_update = 1;\fP .br .RE .TP .BR 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). .IP Default: .PP .RS \f[CR]$apt_update_archive_only = 1;\fP .br .RE .TP .BR APT_UPGRADE BOOL type. APT upgrade. 1 to enable running "apt-get upgrade" at the start of each build, or 0 to disable. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--apt-upgrade\fP .br \f[CR]--no-apt-upgrade\fP .br .RE .IP Default: .PP .RS \f[CR]$apt_upgrade = 0;\fP .br .RE .TP .BR CHROOT STRING type. Default chroot (defaults to distribution[-arch][-sbuild]) .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-c\fP .br \f[CR]--chroot\fP .br .RE .IP Default: .PP .RS \f[CR]$chroot = undef;\fP .br .RE .TP .BR CHROOT_MODE STRING type. Mechanism to use for chroot virtualisation. Possible value are "schroot" (default), "sudo", "autopkgtest" and "unshare". .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--chroot-mode\fP .br .RE .IP Default: .PP .RS \f[CR]$chroot_mode = 'schroot';\fP .br .RE .TP .BR CHROOT_SETUP_SCRIPT STRING type. Script to run to perform custom setup tasks in the chroot. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--setup-hook\fP .br .RE .IP Default: .PP .RS \f[CR]$chroot_setup_script = undef;\fP .br .RE .TP .BR 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. .IP Default: .PP .RS \f[CR]$chroot_split = 0;\fP .br .RE .TP .BR 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. There is no equivalent for the --anything-failed-commands command line option. All percent escapes mentioned in the sbuild man page can be used. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--setup-hook\fP .br \f[CR]--pre-build-commands\fP .br \f[CR]--chroot-setup-commands\fP .br \f[CR]--chroot-update-failed-commands\fP .br \f[CR]--build-deps-failed-commands\fP .br \f[CR]--build-failed-commands\fP .br \f[CR]--anything-failed-commands\fP .br \f[CR]--starting-build-commands\fP .br \f[CR]--finished-build-commands\fP .br \f[CR]--chroot-cleanup-commands\fP .br \f[CR]--post-build-commands\fP .br \f[CR]--post-build-failed-commands\fP .br .RE .IP Example: .PP .RS \f[CR]# general format\fP .br \f[CR]$external_commands = {\fP .br \f[CR] "pre-build-commands" => [\fP .br \f[CR] ['foo', 'arg1', 'arg2'],\fP .br \f[CR] ['bar', 'arg1', 'arg2', 'arg3'],\fP .br \f[CR] ],\fP .br \f[CR] "chroot-setup-commands" => [\fP .br \f[CR] ['foo', 'arg1', 'arg2'],\fP .br \f[CR] ['bar', 'arg1', 'arg2', 'arg3'],\fP .br \f[CR] ],\fP .br \f[CR] "chroot-update-failed-commands" => [\fP .br \f[CR] ['foo', 'arg1', 'arg2'],\fP .br \f[CR] ['bar', 'arg1', 'arg2', 'arg3'],\fP .br \f[CR] ],\fP .br \f[CR] "build-deps-failed-commands" => [\fP .br \f[CR] ['foo', 'arg1', 'arg2'],\fP .br \f[CR] ['bar', 'arg1', 'arg2', 'arg3'],\fP .br \f[CR] ],\fP .br \f[CR] "build-failed-commands" => [\fP .br \f[CR] ['foo', 'arg1', 'arg2'],\fP .br \f[CR] ['bar', 'arg1', 'arg2', 'arg3'],\fP .br \f[CR] ],\fP .br \f[CR] "starting-build-commands" => [\fP .br \f[CR] ['foo', 'arg1', 'arg2'],\fP .br \f[CR] ['bar', 'arg1', 'arg2', 'arg3'],\fP .br \f[CR] ],\fP .br \f[CR] "finished-build-commands" => [\fP .br \f[CR] ['foo', 'arg1', 'arg2'],\fP .br \f[CR] ['bar', 'arg1', 'arg2', 'arg3'],\fP .br \f[CR] ],\fP .br \f[CR] "chroot-cleanup-commands" => [\fP .br \f[CR] ['foo', 'arg1', 'arg2'],\fP .br \f[CR] ['bar', 'arg1', 'arg2', 'arg3'],\fP .br \f[CR] ],\fP .br \f[CR] "post-build-commands" => [\fP .br \f[CR] ['foo', 'arg1', 'arg2'],\fP .br \f[CR] ['bar', 'arg1', 'arg2', 'arg3'],\fP .br \f[CR] ],\fP .br \f[CR] "post-build-failed-commands" => [\fP .br \f[CR] ['foo', 'arg1', 'arg2'],\fP .br \f[CR] ['bar', 'arg1', 'arg2', 'arg3'],\fP .br \f[CR] ],\fP .br \f[CR]};\fP .br \f[CR]# the equivalent of specifying --anything-failed-commands=%SBUILD_SHELL on the\fP .br \f[CR]# command line\fP .br \f[CR]$external_commands = {\fP .br \f[CR] "chroot-update-failed-commands" => [ [ '%SBUILD_SHELL' ] ],\fP .br \f[CR] "build-deps-failed-commands" => [ [ '%SBUILD_SHELL' ] ],\fP .br \f[CR] "build-failed-commands" => [ [ '%SBUILD_SHELL' ] ],\fP .br \f[CR]};\fP .br .RE .IP Default: .PP .RS \f[CR]$external_commands = {\fP .br \f[CR] 'build-deps-failed-commands' => [],\fP .br \f[CR] 'build-failed-commands' => [],\fP .br \f[CR] 'chroot-cleanup-commands' => [],\fP .br \f[CR] 'chroot-setup-commands' => [],\fP .br \f[CR] 'chroot-update-failed-commands' => [],\fP .br \f[CR] 'finished-build-commands' => [],\fP .br \f[CR] 'post-build-commands' => [],\fP .br \f[CR] 'pre-build-commands' => [],\fP .br \f[CR] 'starting-build-commands' => []\fP .br \f[CR] };\fP .br .RE .TP .BR LOG_EXTERNAL_COMMAND_ERROR BOOL type. Log standard error of commands run by sbuild? .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--log-external-command-error\fP .br .RE .IP Default: .PP .RS \f[CR]$log_external_command_error = 1;\fP .br .RE .TP .BR LOG_EXTERNAL_COMMAND_OUTPUT BOOL type. Log standard output of commands run by sbuild? .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--log-external-command-output\fP .br .RE .IP Default: .PP .RS \f[CR]$log_external_command_output = 1;\fP .br .RE .TP .BR PACKAGE_CHECKLIST STRING type. Where to store list currently installed packages inside chroot .IP Default: .PP .RS \f[CR]$package_checklist = '/var/lib/sbuild/package-checklist';\fP .br .RE .TP .BR PURGE_BUILD_DEPS STRING type. When to purge the build dependencies after a build; possible values are "never", "successful", and "always" .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-p\fP .br \f[CR]--purge\fP .br \f[CR]--purge-deps\fP .br .RE .IP Default: .PP .RS \f[CR]$purge_build_deps = 'always';\fP .br .RE .TP .BR PURGE_BUILD_DIRECTORY STRING type. When to purge the build directory after a build; possible values are "never", "successful", and "always" .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-p\fP .br \f[CR]--purge\fP .br \f[CR]--purge-build\fP .br .RE .IP Default: .PP .RS \f[CR]$purge_build_directory = 'always';\fP .br .RE .TP .BR PURGE_EXTRA_PACKAGES BOOL type. Try to remove all additional packages that are not strictly required for the build right after build dependencies were installed. This currently works best with the aspcud resolver. The apt resolver will not make as much effort to remove all unneeded packages and will keep all providers of a virtual package and all packages from any dependency alternative that happen to be installed. The aptitude and xapt resolver do not implement this feature yet. The removed packages are not yet added again after the build finished. This can have undesirable side effects like lintian not working (because there is no apt to install its dependencies) or bare chroots becoming totally unusable after apt was removed from them. Thus, this option should only be used with throw-away chroots like schroot provides them where the original state is automatically restored after each build. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--purge-extra-packages\fP .br .RE .IP Default: .PP .RS \f[CR]$purge_extra_packages = 0;\fP .br .RE .TP .BR 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" .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-p\fP .br \f[CR]--purge\fP .br \f[CR]--purge-session\fP .br .RE .IP Default: .PP .RS \f[CR]$purge_session = 'always';\fP .br .RE .SS Core options .TP .BR ARCHIVE STRING type. Archive being built. Only set in build log. This might be useful for derivative distributions. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--archive\fP .br .RE .IP Default: .PP .RS \f[CR]$archive = undef;\fP .br .RE .TP .BR BATCH_MODE BOOL type. Enable batch mode? .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-b\fP .br \f[CR]--batch\fP .br .RE .IP Default: .PP .RS \f[CR]$batch_mode = 0;\fP .br .RE .TP .BR BUILD_DIR STRING type. Output directory for build artifacts created by dpkg-buildpackage and the log file. 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--build-dir\fP .br .RE .IP Example: .PP .RS \f[CR]$build_dir = '/home/pete/build';\fP .br .RE .PP .RS \f[CR]build_dir = ...;\fP .br .RE .TP .BR 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: .IP Example: .PP .RS \f[CR]$build_environment = {\fP .br \f[CR] 'CCACHE_DIR' => '/build/cache'\fP .br \f[CR]};\fP .br .RE .IP Default: .PP .RS \f[CR]$build_environment = {};\fP .br .RE .TP .BR 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. .PP .RS \f[CR]build_user = ...;\fP .br .RE .TP .BR CORE_DEPENDS ARRAY:STRING type. Packages which must be installed in the chroot for all builds. .IP Default: .PP .RS \f[CR]$core_depends = [\fP .br \f[CR] 'build-essential:native',\fP .br \f[CR] 'fakeroot:native'\fP .br \f[CR] ];\fP .br .RE .TP .BR 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. The default value for this configuration setting is the list of variable names as returned by Dpkg::BuildInfo::get_build_env_allowed() which is also the list of variable names that is whitelisted to be recorded in .buildinfo files. Caution: the default value listed below was retrieved from the dpkg Perl library version available when this man page was generated. It might be different if your dpkg Perl library version differs. .IP Example: .PP .RS \f[CR]# Setting the old environment filter\fP .br \f[CR]$environment_filter = ['^PATH$',\fP .br \f[CR] '^DEB(IAN|SIGN)?_[A-Z_]+$',\fP .br \f[CR] '^(C(PP|XX)?|LD|F)FLAGS(_APPEND)?$',\fP .br \f[CR] '^USER(NAME)?$',\fP .br \f[CR] '^LOGNAME$',\fP .br \f[CR] '^HOME$',\fP .br \f[CR] '^TERM$',\fP .br \f[CR] '^SHELL$'];\fP .br \f[CR]# Appending FOOBAR to the default\fP .br \f[CR]use Dpkg::Build::Info;\fP .br \f[CR]$environment_filter = [Dpkg::BuildInfo::get_build_env_allowed(), 'FOOBAR'];\fP .br \f[CR]# Removing FOOBAR from the default\fP .br \f[CR]use Dpkg::Build::Info;\fP .br \f[CR]$environment_filter = [map /^FOOBAR$/ ? () : $_, Dpkg::BuildInfo::get_build_env_allowed()];\fP .br .RE .IP Default: .PP .RS \f[CR]$environment_filter = [\fP .br \f[CR] '^AR$',\fP .br \f[CR] '^ARFLAGS$',\fP .br \f[CR] '^AS$',\fP .br \f[CR] '^ASFLAGS$',\fP .br \f[CR] '^ASFLAGS_FOR_BUILD$',\fP .br \f[CR] '^AWK$',\fP .br \f[CR] '^CC$',\fP .br \f[CR] '^CFLAGS$',\fP .br \f[CR] '^CFLAGS_FOR_BUILD$',\fP .br \f[CR] '^CPP$',\fP .br \f[CR] '^CPPFLAGS$',\fP .br \f[CR] '^CPPFLAGS_FOR_BUILD$',\fP .br \f[CR] '^CXX$',\fP .br \f[CR] '^CXXFLAGS$',\fP .br \f[CR] '^CXXFLAGS_FOR_BUILD$',\fP .br \f[CR] '^DEB_BUILD_OPTIONS$',\fP .br \f[CR] '^DEB_BUILD_PROFILES$',\fP .br \f[CR] '^DEB_VENDOR$',\fP .br \f[CR] '^DFLAGS$',\fP .br \f[CR] '^DFLAGS_FOR_BUILD$',\fP .br \f[CR] '^DPKG_ADMINDIR$',\fP .br \f[CR] '^DPKG_DATADIR$',\fP .br \f[CR] '^DPKG_GENSYMBOLS_CHECK_LEVEL$',\fP .br \f[CR] '^DPKG_ORIGINS_DIR$',\fP .br \f[CR] '^DPKG_ROOT$',\fP .br \f[CR] '^FC$',\fP .br \f[CR] '^FFLAGS$',\fP .br \f[CR] '^FFLAGS_FOR_BUILD$',\fP .br \f[CR] '^LANG$',\fP .br \f[CR] '^LC_ADDRESS$',\fP .br \f[CR] '^LC_ALL$',\fP .br \f[CR] '^LC_COLLATE$',\fP .br \f[CR] '^LC_CTYPE$',\fP .br \f[CR] '^LC_IDENTIFICATION$',\fP .br \f[CR] '^LC_MEASUREMENT$',\fP .br \f[CR] '^LC_MESSAGES$',\fP .br \f[CR] '^LC_MONETARY$',\fP .br \f[CR] '^LC_NAME$',\fP .br \f[CR] '^LC_NUMERIC$',\fP .br \f[CR] '^LC_PAPER$',\fP .br \f[CR] '^LC_TELEPHONE$',\fP .br \f[CR] '^LC_TIME$',\fP .br \f[CR] '^LD$',\fP .br \f[CR] '^LDFLAGS$',\fP .br \f[CR] '^LDFLAGS_FOR_BUILD$',\fP .br \f[CR] '^LD_LIBRARY_PATH$',\fP .br \f[CR] '^LEX$',\fP .br \f[CR] '^M2C$',\fP .br \f[CR] '^MAKE$',\fP .br \f[CR] '^MAKEFLAGS$',\fP .br \f[CR] '^OBJC$',\fP .br \f[CR] '^OBJCFLAGS$',\fP .br \f[CR] '^OBJCFLAGS_FOR_BUILD$',\fP .br \f[CR] '^OBJCXX$',\fP .br \f[CR] '^OBJCXXFLAGS$',\fP .br \f[CR] '^OBJCXXFLAGS_FOR_BUILD$',\fP .br \f[CR] '^PC$',\fP .br \f[CR] '^RANLIB$',\fP .br \f[CR] '^SOURCE_DATE_EPOCH$',\fP .br \f[CR] '^YACC$'\fP .br \f[CR] ];\fP .br .RE .TP .BR JOB_FILE STRING type. Job status file (only used in batch mode) .IP Default: .PP .RS \f[CR]$job_file = 'build-progress';\fP .br .RE .TP .BR MANUAL_CONFLICTS ARRAY:STRING type. Additional per-build dependencies. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--add-conflicts\fP .br .RE .IP Default: .PP .RS \f[CR]$manual_conflicts = [];\fP .br .RE .TP .BR MANUAL_CONFLICTS_ARCH ARRAY:STRING type. Additional per-build dependencies. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--add-conflicts-arch\fP .br .RE .IP Default: .PP .RS \f[CR]$manual_conflicts_arch = [];\fP .br .RE .TP .BR MANUAL_CONFLICTS_INDEP ARRAY:STRING type. Additional per-build dependencies. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--add-conflicts-indep\fP .br .RE .IP Default: .PP .RS \f[CR]$manual_conflicts_indep = [];\fP .br .RE .TP .BR MANUAL_DEPENDS ARRAY:STRING type. Additional per-build dependencies. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--add-depends\fP .br .RE .IP Default: .PP .RS \f[CR]$manual_depends = [];\fP .br .RE .TP .BR MANUAL_DEPENDS_ARCH ARRAY:STRING type. Additional per-build dependencies. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--add-depends-arch\fP .br .RE .IP Default: .PP .RS \f[CR]$manual_depends_arch = [];\fP .br .RE .TP .BR MANUAL_DEPENDS_INDEP ARRAY:STRING type. Additional per-build dependencies. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--add-depends-indep\fP .br .RE .IP Default: .PP .RS \f[CR]$manual_depends_indep = [];\fP .br .RE .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--sbuild-mode\fP .br .RE .IP Default: .PP .RS \f[CR]$sbuild_mode = 'user';\fP .br .RE .SS Dependency resolution .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--aspcud-criteria\fP .br .RE .IP Default: .PP .RS \f[CR]$aspcud_criteria = '-removed,-changed,-new';\fP .br .RE .TP .BR BD_UNINSTALLABLE_EXPLAINER STRING type. Method to use for explaining build dependency installation failures. Possible value are "dose3" (default), "apt" and "none". Set to "none", the empty string "" or Perl undef to disable running any explainer. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--bd-uninstallable-explainer\fP .br .RE .IP Default: .PP .RS \f[CR]$bd_uninstallable_explainer = 'dose3';\fP .br .RE .TP .BR 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. Additionally, the 'null' solver is provided. It is a dummy resolver which does not install, upgrade or remove any packages. This allows one to completely control package installation via hooks. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--build-dep-resolver\fP .br .RE .IP Default: .PP .RS \f[CR]$build_dep_resolver = 'apt';\fP .br .RE .TP .BR EXTRA_PACKAGES ARRAY:STRING type. Additional per-build packages available as build dependencies. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--extra-package\fP .br .RE .IP Default: .PP .RS \f[CR]$extra_packages = [];\fP .br .RE .TP .BR EXTRA_REPOSITORIES ARRAY:STRING type. Additional per-build apt repositories. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--extra-repository\fP .br .RE .IP Default: .PP .RS \f[CR]$extra_repositories = [];\fP .br .RE .TP .BR EXTRA_REPOSITORY_KEYS ARRAY:STRING type. Additional per-build apt repository keys. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--extra-repository-key\fP .br .RE .IP Default: .PP .RS \f[CR]$extra_repository_keys = [];\fP .br .RE .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--resolve-alternatives\fP .br \f[CR]--no-resolve-alternatives\fP .br .RE .IP Example: .PP .RS \f[CR]$resolve_alternatives = 0;\fP .br .RE .IP Default: .PP .RS \f[CR]$resolve_alternatives = undef;\fP .br .RE .SS Logging options .TP .BR COMPRESS_BUILD_LOG_MAILS BOOL type. Should build log mails be compressed? .IP Default: .PP .RS \f[CR]$compress_build_log_mails = 1;\fP .br .RE .TP .BR DEBUG NUMERIC type. Debug logging level .IP Default: .PP .RS \f[CR]$debug = 0;\fP .br .RE .TP .BR LOG_COLOUR BOOL type. Add colour highlighting to interactive log messages (informational, warning and error messages). Log files will not be coloured. .IP Default: .PP .RS \f[CR]$log_colour = 1;\fP .br .RE .TP .BR 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'. .IP Default: .PP .RS \f[CR]$log_dir = undef;\fP .br .RE .TP .BR LOG_FILTER BOOL type. Filter variable strings from log messages such as the chroot name and build directory .IP Default: .PP .RS \f[CR]$log_filter = 1;\fP .br .RE .TP .BR MAILFROM STRING type. email address set in the From line of build logs .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--mailfrom\fP .br .RE .IP Default: .PP .RS \f[CR]$mailfrom = 'Source Builder ';\fP .br .RE .TP .BR MAILTO STRING type. email address to mail build logs to .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--mail-log-to\fP .br .RE .IP Default: .PP .RS \f[CR]$mailto = '';\fP .br .RE .TP .BR 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. .IP Default: .PP .RS \f[CR]$mailto_hash = {};\fP .br .RE .TP .BR MIME_BUILD_LOG_MAILS BOOL type. Should build log mails be MIME encoded? .IP Default: .PP .RS \f[CR]$mime_build_log_mails = 1;\fP .br .RE .TP .BR NOLOG BOOL type. Disable use of log file .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-n\fP .br \f[CR]--nolog\fP .br .RE .IP Default: .PP .RS \f[CR]$nolog = 0;\fP .br .RE .TP .BR VERBOSE NUMERIC type. Verbose logging level .IP Default: .PP .RS \f[CR]$verbose = 0;\fP .br .RE .SS Maintainer options .TP .BR KEY_ID STRING type. Key ID to use in .changes for the current upload. It overrides both $maintainer_name and $uploader_name. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-k\fP .br \f[CR]--keyid\fP .br .RE .IP Default: .PP .RS \f[CR]$key_id = undef;\fP .br .RE .TP .BR 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. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-m\fP .br \f[CR]--maintainer\fP .br .RE .IP Default: .PP .RS \f[CR]$maintainer_name = undef;\fP .br .RE .TP .BR UPLOADER_NAME STRING type. Name to use as override in .changes file for the Changed-By: field. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]-e\fP .br \f[CR]--uploader\fP .br .RE .IP Default: .PP .RS \f[CR]$uploader_name = undef;\fP .br .RE .SS Multiarch support (transitional) .TP .BR 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 following will be added to the Build-Depends: crossbuild-essential-${hostarch}:native, libc-dev, libstdc++-dev. The latter two are to work around bug #815172. .IP Example: .PP .RS \f[CR]\fP .br \f[CR]$crossbuild_core_depends = {\fP .br \f[CR] nios2 => ['crossbuild-essential-nios2:native', 'special-package'],\fP .br \f[CR] musl-linux-mips => ['crossbuild-essential-musl-linux-mips:native', 'super-special'],\fP .br \f[CR]}\fP .br .RE .IP Default: .PP .RS \f[CR]$crossbuild_core_depends = {};\fP .br .RE .SS Programs .TP .BR APTITUDE STRING type. Path to aptitude binary .IP Default: .PP .RS \f[CR]$aptitude = 'aptitude';\fP .br .RE .TP .BR APT_CACHE STRING type. Path to apt-cache binary .IP Default: .PP .RS \f[CR]$apt_cache = 'apt-cache';\fP .br .RE .TP .BR APT_GET STRING type. Path to apt-get binary .IP Default: .PP .RS \f[CR]$apt_get = 'apt-get';\fP .br .RE .TP .BR AUTOPKGTEST_VIRT_SERVER STRING type. Path to autopkgtest-virt-* binary, selecting the virtualization server. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--autopkgtest-virt-server\fP .br .RE .IP Default: .PP .RS \f[CR]$autopkgtest_virt_server = 'autopkgtest-virt-schroot';\fP .br .RE .TP .BR AUTOPKGTEST_VIRT_SERVER_OPTIONS ARRAY:STRING type. Additional command-line options for autopkgtest-virt-* .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--autopkgtest-virt-server-opt\fP .br \f[CR]--autopkgtest-virt-server-opts\fP .br .RE .IP Default: .PP .RS \f[CR]$autopkgtest_virt_server_options = [];\fP .br .RE .TP .BR DPKG_BUILDPACKAGE_USER_OPTIONS ARRAY:STRING type. Additional command-line options for dpkg-buildpackage. .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--debbuildopt\fP .br \f[CR]--debbuildopts\fP .br \f[CR]--jobs\fP .br .RE .IP Default: .PP .RS \f[CR]$dpkg_buildpackage_user_options = [];\fP .br .RE .TP .BR DPKG_FILE_SUFFIX STRING type. Suffix to add to filename for files generated by dpkg-buildpackage .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--dpkg-file-suffix\fP .br .RE .IP Default: .PP .RS \f[CR]$dpkg_file_suffix = '';\fP .br .RE .TP .BR DPKG_SOURCE STRING type. Path to dpkg-source binary .IP Default: .PP .RS \f[CR]$dpkg_source = 'dpkg-source';\fP .br .RE .TP .BR DPKG_SOURCE_OPTIONS ARRAY:STRING type. Additional command-line options for dpkg-source .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--dpkg-source-opt\fP .br \f[CR]--dpkg-source-opts\fP .br .RE .IP Default: .PP .RS \f[CR]$dpkg_source_opts = [];\fP .br .RE .TP .BR FAKEROOT STRING type. Path to fakeroot binary .IP Default: .PP .RS \f[CR]$fakeroot = 'fakeroot';\fP .br .RE .TP .BR MAILPROG STRING type. Program to use to send mail .IP Default: .PP .RS \f[CR]$mailprog = '/usr/sbin/sendmail';\fP .br .RE .TP .BR MD5SUM STRING type. Path to md5sum binary .IP Default: .PP .RS \f[CR]$md5sum = 'md5sum';\fP .br .RE .TP .BR SCHROOT_OPTIONS ARRAY:STRING type. Additional command-line options for schroot .IP Default: .PP .RS \f[CR]$schroot_options = [\fP .br \f[CR] '-q'\fP .br \f[CR] ];\fP .br .RE .TP .BR SU STRING type. Path to su binary .IP Default: .PP .RS \f[CR]$su = 'su';\fP .br .RE .TP .BR SUDO STRING type. Path to sudo binary .IP Default: .PP .RS \f[CR]$sudo = 'sudo';\fP .br .RE .TP .BR UNSHARE_BIND_MOUNTS ARRAY type. Bind mount directories from the outside to a mountpoint inside the chroot in unshare mode. .IP Example: .PP .RS \f[CR]$unshare_bind_mounts = [ { directory => "/home/path/outside", mountpoint => "/path/inside" } ];\fP .br .RE .IP Default: .PP .RS \f[CR]$unshare_bind_mounts = [];\fP .br .RE .TP .BR UNSHARE_TMPDIR_TEMPLATE STRING type. Template used to create the temporary unpack directory for the unshare chroot mode. .IP Default: .PP .RS \f[CR]$unshare_tmpdir_template = '/tmp/tmp.sbuild.XXXXXXXXXX';\fP .br .RE .TP .BR XAPT STRING type. .IP Default: .PP .RS \f[CR]$xapt = 'xapt';\fP .br .RE .SS Statistics .TP .BR STATS_DIR STRING type. Directory for writing build statistics to .IP Related .BR sbuild (1) command line options: .PP .RS \f[CR]--stats-dir\fP .br .RE .PP .RS \f[CR]stats_dir = ...;\fP .br .RE .lf 37 ./sbuild.conf.5.in .SH FILES .TP .I /etc/sbuild/sbuild.conf Configuration, maintained by the system administrator. This may be used to override the defaults. .TP .I ~/.sbuildrc User-specific configuration. .SH AUTHORS Roman Hodek . .PP \fBsbuild\fR is based on debbuild, written by James Troup and has been modified by .nf Ben Collins , Ryan Murray , Francesco Paolo Lovergine , Michael Banck , and Roger Leigh .fi .SH COPYRIGHT .nf Copyright \[co] 1998-2000 Roman Hodek Copyright \[co] 1998-1999 James Troup Copyright \[co] 2003-2006 Ryan Murray Copyright \[co] 2001-2003 Rick Younie Copyright \[co] 2003-2004 Francesco Paolo Lovergine Copyright \[co] 2005 Michael Banck Copyright \[co] 2005-2009 Roger Leigh .fi .SH "SEE ALSO" .BR sbuild (1). .\"# .\"# The following sets edit modes for GNU EMACS .\"# Local Variables: .\"# mode:nroff .\"# fill-column:79 .\"# End: