Provided by: pbuilder_0.208ubuntu1_all bug

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.

       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

SEE ALSO

       /usr/share/doc/pbuilder/pbuilder-doc.html,  cowbuilder(8), pbuilder(8),
       pdebuild(1)