Ubuntu Manpage: pbuilderrc - configuration files for personal package builder

Provided by: pbuilder_0.215ubuntu7.1_all

NAME

       pbuilderrc - configuration files for personal package builder

DESCRIPTION

       /etc/pbuilderrc contains default values used in the pbuilder program invocation.

       The  file  itself  is sourced by a shell script, so it is required that the file conforms to shell script
       conventions.

FORMAT

APTCACHE=/var/cache/pbuilder/aptcache
Specify the location that the packages downloaded by apt should be cached. Setting this value to
"" will cause caching to be turned off.

APTCACHEHARDLINK=yes
Specify using hard links in apt cache handling. Changing this to no will disable hard linking and
will copy the files.

It is advised to set this to no if you are using user-mode-linux.

APTCONFDIR=/etc/apt
Configures where the apt configuration files are copied from. By default, this value is empty,
allowing the usual configuration options to take effect. Setting this variable overrides other
options.

ARCHITECTURE=`dpkg --print-architecture`
Specify the default distribution to use. This option only affects when doing pbuilder create

AUTOCLEANAPTCACHE=yes
Always run with --autocleanaptcache option.

AUTO_DEBSIGN=yes
When this value is set to yes, pdebuild will invoke debsign command after building.

BASETGZ=/var/cache/pbuilder/base.tgz
Specifies the default location for the archived chroot image to be created and used. This is
overridden with the option --basetgz.

BINDMOUNTS=directories-to-bind-mount
When this value is set, pbuilder will mount these directories using bind-mount. Do not bind-mount
/
An Example:

BINDMOUNTS="/home /mnt/test"

BUILDPLACE=/var/cache/pbuilder/build/
The default place which the chroot is constructed. pbuilder will use the directory $BUILDPLACE$$.
which means, that it will use the directory and the PID to determine the directory to use. This
should obtain an unique directory for concurrent runs of pbuilder in one machine. This is not
guaranteed to happen on network shared drives, so be aware of this fact when playing with this
option on NFS shared beowulf clusters. Change it to something like
/var/cache/pbuilder/build/$HOSTNAME/ when doing such a thing.

pbuilder clean cleans up this directory.

BUILDRESULT=/var/cache/pbuilder/result/
Specify the default directory which the build result will be copied over to after the building.

Unlike --buildresult command-line option. The path is not canonicalized, so you should specify a
full-path, not a relative path.

CCACHEDIR=/var/cache/pbuilder/ccache
Specifies where ccache will keep its cached compiler output. If this is specified, ccache will be
installed upon pbuilder create or pbuilder update, /usr/lib/ccache will be prepended to the PATH,
CCACHEDIR will be bind-mounted in the chroot, and CCACHE_DIR will be set to CCACHEDIR. Note that
files in CCACHEDIR are chowned to BUILDUSERID (1234 by default).

BUILDRESULTUID=

BUILDRESULTGID=
Set the UID and GID of the files built as result. They probably need to be set to numeric UID
values, so that it works the same inside the chroot and outside the chroot.

If sudo is used, the values specified by sudo is used. They are SUDO_UID, and SUDO_GID. The
default value is 0

BUILDSOURCEROOTCMD=fakeroot
This option is used on invocation of fakeroot for dpkg-buildpackage in pdebuild

BUILDUSERID=1234
The uid to be used inside chroot. It should ideally not collide with user-id outside the chroot,
to avoid user inside chroot having access to processes owned by the user id outside the chroot.

BUILDUSERNAME=pbuilder
The user name of the user the build will run as. Specifying this will enable the use of fakeroot
inside pbuilder.

Note that this will require fakeroot to be installed within the chroot, and fakeroot will
automatically be installed. And -rfakeroot will be added to DEBBUILDOPTS

COMPONENTS=main
Specify the default distribution components to use. This option is space-delimited. This option
only affects when doing pbuilder create or when --override-config is specified for pbuilder update
option.

COMPRESSPROG=gzip
Program to use for compression and decompression of the base.tgz. The default is to use gzip, and
any program that can be used for the --use-compress-program option of tar can be given.

If set to "pigz", compression and decompression is gzip compatible but will use all available
CPUs.

export http_proxy=http://your-proxy:8080/
Defines the proxy for http connection.

export DEBIAN_BUILDARCH=athlon
Uses this variable as DEBIAN_BUILDARCH. This trick can be used for other environmental variables
as well.

DEBBUILDOPTS=
The options given here will be passed on to dpkg-buildpackage. This can be useful e.g. for
binary-only builds. The command-line option --debbuildopts will be appended to any contents
specified here but may also be used to reset the list of options.

The default value is to build source and binary package.

DEBOOTSTRAPOPTS=( '--variant=buildd' '--keyring' '/usr/share/keyrings/debian-archive-keyring.gpg' )
When this option is set to --variant=buildd pbuilder will invoke $DEBOOTSTRAP with
--variant=buildd option, which results in debootstrap creating a minimal chroot for buildd instead
of trying to create a minimal installation chroot. --keyring is used to specify a keyring for
debootstrap.

APTKEYRINGS=()
Additional keyrings to use for package verification with apt, not used for debootstrap (use
$DEBOOTSTRAPOPTS ). Use this to add (local) signed repositories. By default the debian-archive-
keyring package inside the chroot is used.

DEBOOTSTRAP=debootstrap
Use this option to switch the implementation of debootstrap. Known implementations of debootstrap
are cdebootstrap and debootstrap

DEBEMAIL=Maintainer Name <Mail@Address>
If this was specified, dpkg-buildpackage command will be passed with the necessary sponsorship
option -mMaintainer Name <Mail@Address> on building. Overridden with --debemail command-line
option. The default configuration for pbuilder is empty for this value.

export DEBIAN_FRONTEND=noninteractive
Sets interactiveness of pbuilder run. Setting this value to blank will cause the pbuilder run to
be interactive. Change this value when noninteractive upgrades do not work.

DISTRIBUTION=sid
Specify the default distribution to use. This option only affects when doing pbuilder create or
when --override-config is specified for pbuilder update option.

EXTRAPACKAGES="ccache lintian XXX"
Specifies extra packages which the system should install in the chroot on pbuilder create. This
is a space-delimited list. Also this is installed on pbuilder build

HOOKDIR=/usr/lib/pbuilder/hooks
Specifies the default location for the user hooks directory. This is overridden with the option
--hookdir.

If this is specified, hooks are searched for in the chroot, when running pbuilder. If it is not
defined, or is an empty string, hooks are not executed.

For details, see pbuilder(8)

MIRRORSITE=http://www.jp.debian.org/debian
Specify the mirror site which contains the main Debian distribution.

Note that you cannot really use file:/ kind of URL, because the location needs to be accessible
from within the chroot.

OTHERMIRROR=deb http://xxx/xxx/ ./ [| other deb lines... ]
The lines which is added to the sources.list, delimited with | Like:
deb http://local/mirror sid main|deb file:/usr/local/mirror ./

The deb lines here are the ones that will appear at the top of the sources.list inside the chroot.
Be sure to follow the syntax rules of sources.list(5). These lines appear at the beginning of the
constructed sources file, so this is the place to list your local mirror sites; apt will then use
them in preference to the ones listed in MIRRORSITE .

To make changes on mirror site effective on update --override-config needs to be specified.

PDEBUILD_PBUILDER=pbuilder
Specify what pbuilder implementation to use for pdebuild. The currently possible values are
pbuilder and cowbuilder

PKGNAME_LOGFILE_EXTENTION=.build
The extension of filename used in pkgname-logfile option.

PKGNAME_LOGFILE=yes
Always run with --pkgname-logfile option, and create a logfile named after the package name.

PBUILDERROOTCMD=sudo -E
This option is used on invocation of pbuilder build in pdebuild

PBUILDERSATISFYDEPENDSCMD=/usr/lib/pbuilder/pbuilder-satisfydepends
This option is used by various parts of pbuilder to satisfy (i.e. install) the build-dependencies
of a package. There are four implementations:

The "experimental" implementation, "pbuilder-satisfydepends-experimental", which might be useful
to pull packages from experimental or from repositories with a low APT Pin Priority.

The "aptitude" implementation, which will resolve build-dependencies and build-conflicts with
aptitude which helps dealing with complex cases but does not support unsigned APT repositories.

The "gdebi" implementation, which will resolve build-dependencies using gdebi tool, faster than
classic implementation, and does not require installation of a dummy package like the aptitude
implementation.

The "classic" implementation, which was the original implementation used until 0.172.

The default is now "aptitude".

PBUILDERSATISFYDEPENDSOPT=()
Array of flags to give to pbuilder-satisfydepends.

ALLOWUNTRUSTED=no
Allow untrusted (no key installed) and unsigned repositories. Warning: Enabling this option may
allow remote attackers to compromise the system. Better use signed repositories and $APTKEYRINGS
to add the key(s).

APTGETOPT=()
Extra flags to give to apt-get.

APTITUDEGETOPT=()
Extra flags to give to aptitude.

REMOVEPACKAGES=lilo
Specify the packages to be removed on creation of base.tgz Leaving lilo in the chroot is like
keeping a timebomb...

TIMEOUT_TIME=2h
Sets timeout time. Build will be stoped with SIGTERM after the set time.

USEDEVFS=no
Whether to use DEVFS or not.

USEDEVPTS=yes
Specify yes when it is desired to mount /dev/pts interface. It is usually a good idea, since there
are many software which fail miserably when there is no /dev/pts being mounted.

USERUNSHM=yes
Specify yes when it is desired to mount /run/shm mount point. It is usually a good idea in order
to work with software that expect shm to work.

USE_PDEBUILD_INTERNAL=yes
When this option is set to yes pdebuild-internal implementation of pdebuild is used.

USEPROC=yes
Specify yes when it is desired to mount /proc interface. It is usually a good idea, since there
are many software which fail miserably when there is no /proc being mounted.

ADDITIONAL_BUILDRESULTS="
Array of additional files to copy out of the build area.

AUTHOR

       Initial coding, and main maintenance is done by Junichi  Uekawa  <dancer@debian.org>.   User  hooks  code
       added by Dale Amon <amon@vnl.com>

       The homepage is available at http://pbuilder.alioth.debian.org

FILES

       /etc/pbuilderrc, $HOME/.pbuilderrc

NAME

DESCRIPTION

FORMAT

AUTHOR

FILES

SEE ALSO