Provided by: pbuilder_0.145ubuntu4_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

       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.

       EXTRAPACKAGES=gcc3.0-athlon-builder
              Specifies  extra packages which the system should install in the
              chroot on pbuilder create.  Also this is installed  on  pbuilder
              build

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

       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.

       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.

       NONUSMIRRORSITE=http://www.jp.debian.org/debian-non-US
              Specify the mirror site which contains non-US distribution.

       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 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 and NONUSMIRRORSITE
              .

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

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

       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.

       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.

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

              This  option  is  not  effective  for  pdebuild   command.   Use
              --buildresult option instead.

       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.

       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.

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

       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.1

       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.

       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  overrides  any  contents specified here.
              The default value is to build source and binary package.

       BUILDSOURCEROOTCMD=fakeroot

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

       PBUILDERROOTCMD=sudo

              This option is used on invocation of pbuilder build 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

       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.

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

       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.

       USEDEVFS=no
              Whether to use DEVFS or not.

       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

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

       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 /

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

       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.

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

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://www.netfort.gr.jp/~dancer/software/pbuilder.html

FILES

       /etc/pbuilderrc, ${HOME}/.pbuilderrc

SEE ALSO

       pbuilder (8), pdebuild (1)