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
I 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
R --basetgz .
I BUILDPLACE= /var/cache/pbuilder/build/
The default place which the chroot is constructed.
pbuilder
will use the directory
R $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.
I 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.
I 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.
I OTHERMIRROR= deb http://xxx/xxx/ ./ [| other deb lines... ]
The lines which is added to the sources.list, delimited with
|
Like
deb http://local/mirror stable 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
R 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.
I 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.
I COMPONENTS= main
Specify the default distribution components to use.
This option only affects when doing
pbuilder create
or when
--override-config
is specified for
pbuilder update
option.
I export http_proxy= http://your-proxy:8080/
Defines the proxy for http connection.
I 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.
I 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.
I HOOKDIR= /usr/lib/pbuilder/hooks
Specifies the default location for the user hooks
directory.
This is overridden with the option
R --hookdir .
If this is specified, hooks are searched for in
the chroot, when running
R pbuilder .
If it is not defined, or is an empty string,
hooks are not executed.
For details, see
pbuilder.1
I DEBBUILDOPTS=
The options given here will be passed on to
R dpkg-buildpackage .
This can be useful e.g. for binary-only builds. The command-line option
--debbuildopts
overrides any contents specified here.
The default value is to build source and binary package.
I BINDMOUNTS= directories-to-bind-mount
When this value is set, pbuilder will mount these directories using
bind-mount.
Example:
BINDMOUNTS=/home /mnt/test
Do not bind-mount
/
I USE_PDEBUILD_INTERNAL= yes
When this option is set to
yes
pdebuild-internal
implementation of
pdebuild
is used.
I DEBOOTSTRAPOPTS= '--variant=buildd'
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.
I DEBOOTSTRAP= debootstrap
Use this option to switch the implementation of
debootstrap.
Known implementations of debootstrap are
cdebootstrap
and
debootstrap
I EXTRAPACKAGES= ccache linda XXX
Specifies extra packages which the system should install
in the chroot on
R pbuilder create .
This is a space-delimited list.
Also this is installed on
pbuilder build
I export DEBIAN_BUILDARCH= athlon
Uses this variable as
R DEBIAN_BUILDARCH .
This trick can be used for other environmental variables as well.
I 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.
I 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.
I REMOVEPACKAGES= lilo
Specify the packages to be removed on creation of
base.tgz
Leaving lilo in the chroot is like keeping a timebomb...
I 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.
I BUILDSOURCEROOTCMD= fakeroot
This option is used on invocation of fakeroot
for
dpkg-buildpackage
in
pdebuild
I PBUILDERROOTCMD= sudo
This option is used on invocation of
pbuilder build
in
pdebuild
I 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 two alternate 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, and 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
I 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.
I 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
I 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.
I TIMEOUT_TIME= 2h
Sets timeout time.
Build will be stoped with SIGTERM after the set time.
I 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.
I USEDEVFS= no
Whether to use DEVFS or not.
I 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
R SUDO_UID , and
R SUDO_GID .
The default value is
0
I AUTO_DEBSIGN= yes
When this value is set to yes,
pdebuild
will invoke debsign command after building.
I PKGNAME_LOGFILE_EXTENTION= .build
The extension of filename used in pkgname-logfile option.
I PKGNAME_LOGFILE= yes
Always run with
--pkgname-logfile
option, and create a logfile named after the package name.
I PDEBUILD_PBUILDER= pbuilder
Specify what pbuilder implementation to use for pdebuild.
The currently possible values are
pbuilder
and
cowbuilder
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
SEE ALSO
R /usr/share/doc/pbuilder/pbuilder-doc.html ,
R pbuilder (8),
R pdebuild (1)
\" LocalWords: interactiveness noninteractive pdebuild pbuilder buildd
\" LocalWords: pbuilderrc