1pbuilderrc(5)                      pbuilder                      pbuilderrc(5)
2
3
4

NAME

6       pbuilderrc - configuration files for personal package builder
7

DESCRIPTION

9       /etc/pbuilderrc  contains  default  values used in the pbuilder program
10       invocation.
11
12       The file itself is sourced by a shell script, so it  is  required  that
13       the file conforms to shell script conventions.
14
15       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
20

FORMAT

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
27       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
31              It  is  advised  to  set  this to no if you are using user-mode-
32              linux.
33
34       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
40
41       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  ch‐
44              root, defaults to the
45               system one.  The supported values are the ones debootstrap sup‐
46              ports.
47
48
49       AUTOCLEANAPTCACHE=yes
50              Always run with --autocleanaptcache option.
51
52       AUTO_DEBSIGN=yes
53              When this value is set to yes, pdebuild will invoke debsign com‐
54              mand after building.
55
56       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
61       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 ch‐
65              root.
66              Do not bind-mount /.
67              An Example:
68
69              BINDMOUNTS="/home /mnt/test /home/joe/repo:/var/repo"
70
71       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 $sr‐
75              cpkg-$ver,  with  $ver  being  the upstream part of the version,
76              without epoch and debian revision.
77
78              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
82       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
93              pbuilder clean cleans up this directory.
94
95       BUILDRESULT=/var/cache/pbuilder/result/
96              Specify the default directory which the  build  result  will  be
97              copied over to after the building.
98
99              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
103       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
108       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 de‐
115              fault).
116              ccache is disabled by default.
117
118       BUILDRESULTUID=
119
120       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
125              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
128       BUILDSOURCEROOTCMD=fakeroot
129              This  option  is  used on invocation of fakeroot for dpkg-build‐
130              package in pdebuild
131
132       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  ch‐
136              root.
137
138       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
142              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
146       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
152       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
157              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
163       export http_proxy=http://your-proxy:8080/
164              Defines the proxy for http connection.
165
166       export DEBIAN_BUILDARCH=athlon
167              Uses this variable as DEBIAN_BUILDARCH.  This trick can be  used
168              for other environmental variables as well.
169
170       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
176              The default value is to build source and binary package.
177
178       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  de‐
182              bootstrap creating a minimal chroot for buildd instead of trying
183              to create a minimal installation chroot.  --keyring is  used  to
184              specify a keyring for debootstrap.
185
186       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
192              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
197       DEBOOTSTRAP=debootstrap
198              Use  this  option  to  switch the implementation of debootstrap.
199              Known implementations of debootstrap are  cdebootstrap  and  de‐
200              bootstrap
201
202       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
207       DISTRIBUTION=sid
208              Specify  the  default distribution to use.  This option only af‐
209              fects when doing pbuilder create or  when  --override-config  is
210              specified for pbuilder update option.
211
212       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
217       HOOKDIR=/usr/lib/pbuilder/hooks
218              Specifies  the  default  location  for the user hooks directory.
219              This is overridden with the option --hookdir.
220
221              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
225              For details, see pbuilder(8)
226
227       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
233       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
239       MIRRORSITE=http://www.jp.debian.org/debian
240              Specify the mirror site which contains the main Debian distribu‐
241              tion.
242
243              Note  that you cannot really use file:/ kind of URL, because the
244              location needs to be accessible from within the chroot.
245
246       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
251              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
258              To make changes on  mirror  site  effective  on  update  --over‐
259              ride-config needs to be specified.
260
261       PDEBUILD_PBUILDER=pbuilder
262              Specify  what  pbuilder implementation to use for pdebuild.  The
263              currently possible values are pbuilder and cowbuilder
264
265       PKGNAME_LOGFILE_EXTENSION=_$(dpkg --print-architecture).build
266              The extension of filename used in pkgname-logfile option.
267
268       PKGNAME_LOGFILE=yes
269              Always run with --pkgname-logfile option, and create  a  logfile
270              named after the package name.
271
272       PBUILDERROOTCMD=sudo -E
273              This option is used on invocation of pbuilder build in pdebuild
274
275       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
280              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
286              pbuilder-satisfydepends-experimental  might  be  useful  to pull
287              packages from repositories with a low APT Pin Priority (for  ex‐
288              ample, Debian's experimental or stable-backports).
289
290              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
294              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
299              pbuilder-satisfydepnds-classic  the  "classic"   implementation,
300              which  was  the  original  implementation  used by default until
301              v0.172.
302
303              The default is now "aptitude".
304
305       PBUILDERSATISFYDEPENDSOPT=()
306              Array of flags to give to pbuilder-satisfydepends.
307
308
309       SOURCE_ONLY_CHANGES=yes
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
314
315       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  $AP‐
319              TKEYRINGS to add the key(s).
320
321
322       APTGETOPT=()
323              Extra flags to give to apt-get.
324
325
326       APTITUDEGETOPT=()
327              Extra flags to give to aptitude.
328
329
330       DEBDELTA=no
331              Enable use of debdelta to download the needed updated in the ch‐
332              root, if debdelta is already installed.
333
334
335       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
339       TIMEOUT_TIME=2h
340              Sets timeout time.  Build will be stopped with SIGTERM after the
341              set time.
342
343       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
347       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
352       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
358       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
364       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
369       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  ex‐
372              pects 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
381
382       USE_PDEBUILD_INTERNAL=yes
383              When  this option is set to yes pdebuild-internal implementation
384              of pdebuild is used.
385
386       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
391       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 es‐
397              caped by using a \ or a wildcard to match the space.
398
399
400       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 di‐
403              rectory 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
407       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
413       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
419
420

AUTHOR

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
425       The            homepage            is            available           at
426       https://pbuilder-team.pages.debian.net/pbuilder/
427

FILES

429       /etc/pbuilderrc, $HOME/.pbuilderrc
430

SEE ALSO

432       /usr/share/doc/pbuilder/pbuilder-doc.html, cowbuilder(8),  pbuilder(8),
433       pdebuild(1)
434
435
436
437
438
439
440Debian                            2016 March                     pbuilderrc(5)
Impressum