1pbuilderrc(5) pbuilder pbuilderrc(5)
2
6 pbuilderrc - configuration files for personal package builder
7
9 /etc/pbuilderrc contains default values used in the pbuilder program
10 invocation.
11 The file itself is sourced by a shell script, so it is required that
13 the file conforms to shell script conventions.
14 The environment variable PBUILDER_OPERATION contains the current opera‐
16 tion mode of pbuilder, and can be used to do a conditional configura‐
17 tion. Possible values are build, clean, create, debuild, dumpconfig,
18 execute, login, update.
19
22 APTCACHE=/var/cache/pbuilder/aptcache
23 Specify the location that the packages downloaded by apt should
24 be cached. Setting this value to "" will cause caching to be
25 turned off.
26 APTCACHEHARDLINK=yes
28 Specify using hard links in apt cache handling. Changing this
29 to no will disable hard linking and will copy the files.
30 It is advised to set this to no if you are using user-mode-
32 linux.
33 APTCONFDIR=/etc/apt
35 Configures where the apt configuration files are copied from.
36 By default, this value is empty, allowing the usual configura‐
37 tion options to take effect. Setting this variable overrides
38 other options.
39 ARCHITECTURE=`dpkg --print-architecture`
42 Specifies the build architecture (as described in dpkg-architec‐
43 ture(1)). It'll be the architecture used when creating the
44 chroot, defaults to the
45 system one. The supported values are the ones debootstrap sup‐
46 ports.
47 AUTOCLEANAPTCACHE=yes
50 Always run with --autocleanaptcache option.
51 AUTO_DEBSIGN=yes
53 When this value is set to yes, pdebuild will invoke debsign com‐
54 mand after building.
55 BASETGZ=/var/cache/pbuilder/base.tgz
57 Specifies the default location for the archived chroot image to
58 be created and used. This is overridden with the option
59 --basetgz.
60 BINDMOUNTS=directories-to-bind-mount[:internal-mountpoint]
62 When this value is set, pbuilder will mount these directories
63 using bind-mount. Different directories are space separated, a
64 column can optionally specify a mount destination inside the
65 chroot.
66 Do not bind-mount /.
67 An Example:
68 BINDMOUNTS="/home /mnt/test /home/joe/repo:/var/repo"
70 BUILDDIR=/build
72 The directory inside the chroot where the build happens. This
73 directory will contain the build products; the source packages
74 will be unpacked in a subdirectory therein contained, named
75 $srcpkg-$ver, with $ver being the upstream part of the version,
76 without epoch and debian revision.
77 Attention! Some directories — such as /tmp — are not safe to use
79 since they can be world-writable, and external users can temper
80 with the build process.
81 BUILDPLACE=/var/cache/pbuilder/build/
83 The default place which the chroot is constructed. pbuilder
84 will use the directory $BUILDPLACE$$. which means, that it will
85 use the directory and the PID to determine the directory to use.
86 This should obtain an unique directory for concurrent runs of
87 pbuilder in one machine. This is not guaranteed to happen on
88 network shared drives, so be aware of this fact when playing
89 with this option on NFS shared beowulf clusters. Change it to
90 something like /var/cache/pbuilder/build/$HOSTNAME/ when doing
91 such a thing.
92 pbuilder clean cleans up this directory.
94 BUILDRESULT=/var/cache/pbuilder/result/
96 Specify the default directory which the build result will be
97 copied over to after the building.
98 Unlike the --buildresult command-line option the path is not
100 canonicalized, so you should specify a full path, not a relative
101 path.
102 EATMYDATA=no
104 Enable or disable the builtin eatmydata support.
105 For this to work the library of the same architecture as the one
106 inside the chroot has to be installed in the host.
107 CCACHEDIR=
109 Specifies where ccache will keep its cached compiler output. If
110 this is specified, ccache will be installed upon pbuilder create
111 or pbuilder update, /usr/lib/ccache will be prepended to the
112 PATH, CCACHEDIR will be bind-mounted in the chroot, and
113 CCACHE_DIR (ccache variable) will be set to CCACHEDIR. Note
114 that files in CCACHEDIR are chowned to BUILDUSERID (1234 by
115 default).
116 ccache is disabled by default.
117 BUILDRESULTUID=
119 BUILDRESULTGID=
121 Set the UID and GID of the files built as result. They probably
122 need to be set to numeric UID values, so that it works the same
123 inside the chroot and outside the chroot.
124 If sudo is used, the values specified by sudo is used. They are
126 SUDO_UID, and SUDO_GID. The default value is 0
127 BUILDSOURCEROOTCMD=fakeroot
129 This option is used on invocation of fakeroot for dpkg-build‐
130 package in pdebuild
131 BUILDUSERID=1234
133 The uid to be used inside chroot. It should ideally not collide
134 with user-id outside the chroot, to avoid user inside chroot
135 having access to processes owned by the user id outside the
136 chroot.
137 BUILDUSERNAME=pbuilder
139 The user name of the user the build will run as. Specifying
140 this will enable the use of fakeroot inside pbuilder.
141 Note that this will require fakeroot to be installed within the
143 chroot, and fakeroot will automatically be installed. And
144 -rfakeroot will be added to DEBBUILDOPTS
145 COMPONENTS=main
147 Specify the default distribution components to use. This option
148 is space-delimited, use quotes when listing multiple components.
149 This option only affects when doing pbuilder create or when
150 --override-config is specified for pbuilder update option.
151 COMPRESSPROG=gzip
153 Program to use for compression of the base.tgz. The default is
154 to use gzip, and any program that can be used to compress data
155 using a pipe can be used.
156 If set to "pigz", compression and decompression is gzip compati‐
158 ble but will use all available CPUs.
159 If set to "cat", there will be no compression at all (so com‐
160 pression/decompression will be a lot faster but takes much more
161 space on the disk).
162 export http_proxy=http://your-proxy:8080/
164 Defines the proxy for http connection.
165 export DEBIAN_BUILDARCH=athlon
167 Uses this variable as DEBIAN_BUILDARCH. This trick can be used
168 for other environmental variables as well.
169 DEBBUILDOPTS=
171 The options given here will be passed on to dpkg-buildpackage.
172 This can be useful e.g. for binary-only builds. The command-line
173 option --debbuildopts will be appended to any contents specified
174 here but may also be used to reset the list of options.
175 The default value is to build source and binary package.
177 DEBOOTSTRAPOPTS=( '--variant=buildd' '--keyring'
179 '/usr/share/keyrings/debian-archive-keyring.gpg' )
180 When this option is set to --variant=buildd pbuilder will invoke
181 $DEBOOTSTRAP with --variant=buildd option, which results in
182 debootstrap creating a minimal chroot for buildd instead of try‐
183 ing to create a minimal installation chroot. --keyring is used
184 to specify a keyring for debootstrap.
185 APTKEYRINGS=()
187 Additional keyrings to use for package verification with apt,
188 not used for debootstrap (use $DEBOOTSTRAPOPTS). Use this to
189 add (local) signed repositories. By default the debian-archive-
190 keyring package inside the chroot is used.
191 Keyrings are copied into /etc/apt/trusted.gpg.d in the chroot.
193 APT supports it since version 0.7.25.1, firstly available in the
194 Debian release codenamed "squeeze" (released on 2011). For
195 older chroots, use a G hook to run apt-key manually.
196 DEBOOTSTRAP=debootstrap
198 Use this option to switch the implementation of debootstrap.
199 Known implementations of debootstrap are cdebootstrap and
200 debootstrap
201 export DEBIAN_FRONTEND=noninteractive
203 Sets interactiveness of pbuilder run. Setting this value to
204 blank will cause the pbuilder run to be interactive. Change
205 this value when noninteractive upgrades do not work.
206 DISTRIBUTION=sid
208 Specify the default distribution to use. This option only
209 affects when doing pbuilder create or when --override-config is
210 specified for pbuilder update option.
211 EXTRAPACKAGES="ccache lintian XXX"
213 Specifies extra packages which the system should install in the
214 chroot on pbuilder create. This is a space-delimited list.
215 Also this is installed on pbuilder update
216 HOOKDIR=/usr/lib/pbuilder/hooks
218 Specifies the default location for the user hooks directory.
219 This is overridden with the option --hookdir.
220 If this is specified, hooks are searched for in the chroot, when
222 running pbuilder. If it is not defined, or is an empty string,
223 hooks are not executed.
224 For details, see pbuilder(8)
226 LOGLEVEL=I
228 Specify how much output you want from pbuilder, valid values are
229 E (errors only), W (errors and warnings), I (errors, warnings
230 and informational) and D (everything including some debug mes‐
231 sages).
232 USECOLORS=auto
234 Specify whether you'd like to see colored output from pbuilder.
235 Valid values are auto (to try to automatically detect whether
236 the terminal supports them), yes (to always use colors), and no
237 (to never use colors).
238 MIRRORSITE=http://www.jp.debian.org/debian
240 Specify the mirror site which contains the main Debian distribu‐
241 tion.
242 Note that you cannot really use file:/ kind of URL, because the
244 location needs to be accessible from within the chroot.
245 OTHERMIRROR=deb http://xxx/xxx/ ./ [| other deb lines... ]
247 The lines which is added to the sources.list, delimited with |
248 Like:
249 deb http://local/mirror sid main|deb file:/usr/local/mirror ./
250 The deb lines here are the ones that will appear at the top of
252 the sources.list inside the chroot. Be sure to follow the syn‐
253 tax rules of sources.list(5). These lines appear at the begin‐
254 ning of the constructed sources file, so this is the place to
255 list your local mirror sites; apt will then use them in prefer‐
256 ence to the ones listed in MIRRORSITE .
257 To make changes on mirror site effective on update --over‐
259 ride-config needs to be specified.
260 PDEBUILD_PBUILDER=pbuilder
262 Specify what pbuilder implementation to use for pdebuild. The
263 currently possible values are pbuilder and cowbuilder
264 PKGNAME_LOGFILE_EXTENSION=_$(dpkg --print-architecture).build
266 The extension of filename used in pkgname-logfile option.
267 PKGNAME_LOGFILE=yes
269 Always run with --pkgname-logfile option, and create a logfile
270 named after the package name.
271 PBUILDERROOTCMD=sudo -E
273 This option is used on invocation of pbuilder build in pdebuild
274 PBUILDERSATISFYDEPENDSCMD=/usr/lib/pbuilder/pbuilder-satisfydepends
276 This option is used by various parts of pbuilder to satisfy
277 (i.e. install) the build-dependencies of a package. These are
278 the available implementations:
279 pbuilder-satisfydepends-apt the newest implementation, which
281 leverage the ability of apt 1.4 to satisfy build dependencies
282 and build conflicts from a .dsc; useful since it's pretty fast
283 and doesn't require the installation of any non-required package
284 in the chroot, nor of dummy packages.
285 pbuilder-satisfydepends-experimental might be useful to pull
287 packages from repositories with a low APT Pin Priority (for
288 example, Debian's experimental or stable-backports).
289 pbuilder-satisfydepends-aptitude will resolve build-dependencies
291 and build-conflicts with aptitude which helps dealing with com‐
292 plex cases but does not support unsigned APT repositories.
293 pbuilder-satisfydepends-gdebi will resolve build-dependencies
295 using gdebi, faster than classic implementation, and does not
296 require installation of a dummy package like the aptitude imple‐
297 mentation.
298 pbuilder-satisfydepnds-classic the "classic" implementation,
300 which was the original implementation used by default until
301 v0.172.
302 The default is now "aptitude".
304 PBUILDERSATISFYDEPENDSOPT=()
306 Array of flags to give to pbuilder-satisfydepends.
307 SOURCE_ONLY_CHANGES=no
310 Specify whether to generate an additional .changes file for a
311 source-only upload, whilst still producing a full .changes file
312 for any binary packages built.
313 ALLOWUNTRUSTED=no
316 Allow untrusted (no key installed) and unsigned repositories.
317 Warning: Enabling this option may allow remote attackers to com‐
318 promise the system. Better use signed repositories and
319 $APTKEYRINGS to add the key(s).
320 APTGETOPT=()
323 Extra flags to give to apt-get.
324 APTITUDEGETOPT=()
327 Extra flags to give to aptitude.
328 DEBDELTA=no
331 Enable use of debdelta to download the needed updated in the
332 chroot, if debdelta is already installed.
333 REMOVEPACKAGES=lilo
336 Specify the packages to be removed on creation of base.tgz Leav‐
337 ing lilo in the chroot is like keeping a timebomb...
338 TIMEOUT_TIME=2h
340 Sets timeout time. Build will be stopped with SIGTERM after the
341 set time.
342 USEDEVFS=no
344 Whether to mount a devfs or not. Has no effect on kFreeBSD, as
345 a devfs (and fdescfs for /dev/fd) is always used.
346 USEDEVPTS=yes
348 Specify yes when it is desired to mount /dev/pts interface. It
349 is usually a good idea, since there are many software which fail
350 miserably when there is no /dev/pts being mounted.
351 USESYSFS=yes
353 Whether to mount a sysfs (linsysfs for kFreeBSD) in /sys or not.
354 Has no effect on GNU/Hurd hosts, where sysfs is not available.
355 It is usually a good idea, since there are several software
356 which require /sys being populated.
357 USENETWORK=no
359 Specify yes when you do not want to disable network access dur‐
360 ing build. Network is not available on a Debian buildd, so you
361 might want to keep the default. Disabling network access cur‐
362 rently only works on Linux.
363 USECGROUP=yes
365 Specify yes to use a cgroup to isolate build processes, so that
366 any stray processes from the build can be cleaned up afterwords.
367 This currently only works on Linux systems running systemd.
368 USESHM=yes
370 Specify yes when it is desired to mount /dev/shm mount point. It
371 is usually a good idea in order to work with software that
372 expects shm to work.
373 /run/shm will be configured as a symbolic link to /dev/shm.
374 This option used to be named USERUNSHM, for compatibility pur‐
375 pose the old name is still supported, and if set it'll override
376 any USESHM.
377 Has no effect on GNU/Hurd hosts due to bugs in /hurd/tmpfs;
378 since /dev is always bind-mounted, the host's /dev/shm will be
379 used.
380 USE_PDEBUILD_INTERNAL=yes
383 When this option is set to yes pdebuild-internal implementation
384 of pdebuild is used.
385 USEPROC=yes
387 Specify yes when it is desired to mount /proc interface. It is
388 usually a good idea, since there are many software which fail
389 miserably when there is no /proc being mounted.
390 ADDITIONAL_BUILDRESULTS=(foo "bar*" "baz\ biz")
392 Array of additional files to copy out of the build area.
393 In case a wildcard is needed (e.g. *.changes) quote it to have
394 the wildcard escaped and not expanded at configuration load
395 time, but instead expanded at run time when the additional build
396 artifacts are exported. Spaces in file names needs to be
397 escaped by using a \ or a wildcard to match the space.
398 CONFDIR=/etc/pbuilder/conf_files
401 pbuilder copies some configuration files (like /etc/hosts or
402 /etc/hostname) from the host system into the chroot. If the
403 directory specified here exists and contains one of the copied
404 files (without the leading /etc) that file will be copied from
405 here instead of the system one.
406 BUILD_HOME=/nonexistent
408 Set the what the HOME environment variable points to during the
409 builds. It defaults to a non-existing directory to prevent
410 builds from writing to HOME, which is reserved to users. If you
411 need a working HOME you can set it to $BUILDDIR instead.
412 BINNMU_MAINTAINER=
414 Set the value of the maintainer name and email in the changelog
415 during binNMU. Such value is then copied to the Changed-By
416 field of the .changes file. Can be set at run time with the
417 --bin-nmu-maintainer command line option.
418
422 Initial coding, and main maintenance is done by Junichi Uekawa
423 <dancer@debian.org>. User hooks code added by Dale Amon <amon@vnl.com>
424 The homepage is available at
426 https://pbuilder-team.pages.debian.net/pbuilder/
427
429 /etc/pbuilderrc, $HOME/.pbuilderrc
430
432 /usr/share/doc/pbuilder/pbuilder-doc.html, cowbuilder(8), pbuilder(8),
433 pdebuild(1)
434Debian 2016 March pbuilderrc(5)