pdebuild - pbuilder way of doing debuild

       Initial coding and main maintenance is done by Junichi Uekawa <dancer@debian.org>.

       The homepage is http://pbuilder.alioth.debian.org

       pdebuild will accept all options that pbuilder accepts as pdebuild option.  However, unless the option is
       documented in the manual page, it may be ignored.

       A convenience program for pbuilder which invokes pbuilder after obtaining appropriate root privilege in a
       Debian source directory.  One must be inside the source tree containing the debian directory.

       By default, build log file is stored in ../<package>_<version>_<arch>.build.

pdebuild

              $ pwd
              /home/dancer/DEBIAN/cowdancer/cowdancer
              $ ls debian/rules
              debian/rules
              $ pdebuild
              dh clean
                 dh_testdir
                 dh_auto_clean
                 dh_autoreconf_clean
                 dh_clean
                   .
                   .
                   .
              dpkg-source: info: using source format '3.0 (native)'
              dpkg-source: info: building cowdancer in cowdancer_0.84.tar.xz
              dpkg-source: info: building cowdancer in cowdancer_0.84.dsc
                   .
                   .
                   .

/etc/pbuilderrc
              The configuration file for pbuilder, used in pdebuild.

       /usr/share/pbuilder/pbuilderrc
              The default configuration file for pbuilder, used in pdebuild.

       ${HOME}/.pbuilderrc
              Configuration file for pbuilder, used in pdebuild.  It overrides /etc/pbuilderrc

       pdebuild - pbuilder way of doing debuild

       The  options  have  the form --optionname which modify the operation semantics as explained below.  They
       are applied from left to right, and when options conflict, the option that appear later take precedence.

       --buildsourceroot[fakeroot]
              The command used to gain root privilege for invoking debian/rulesclean--pbuilderroot[sudo-E]
              The command used to gain root privilege for invoking pbuilder.

       --pbuildersatisfydepends[/usr/lib/pbuilder/pbuilder-satisfydepends]
              The command used to satisfy (i.e. install) build-dependencies.

       --architecture

              Set architecture.  This is currently required when it doesn't match the host architecture.

       --auto-debsign

              Invoke debsign at the end of pdebuild process.

       --debsign-k[key-id]
              Pass -k option to debsign to specify which key-id to sign with.

       --buildresult[Directoryforbuildresults]

              The place where the build result is stored.

              Note that for pdebuild, buildresult needs to be specified as a pdebuild  option  on  the  command-
              line, not as a pbuilder option.

              Note  that  the  default  value  for  buildresult  is  what  is  defined  for  pbuilder,  which is
              /var/cache/pbuilder/result and not ..--configfile[Extraconfigfiletouse]

              The configuration file is used, and passed on to pbuilder.

       --debbuildopts[optionstopasstodpkg-buildpackage]

              The space-delimited list of options are passed  to  dpkg-buildpackage.   This  option  appends  to
              pbuilder  option  --debbuildopts  and may also be used to reset the list of options by passing the
              empty string.

              Multiple options are delimited with spaces.

              Note that for pdebuild, dpkg-source is used  to  build  the  source  package  which  is  given  to
              pbuilder.  This  option has no effect on the arguments used to build this source package, but will
              control whether the clean target is run first as usual, and any options for  dpkg-genchanges  will
              be passed on.

       --use-pdebuild-internal
              Uses  a different implementation of pdebuild, which calls clean and build inside the chroot, using
              bind-mounts.

              pdebuild-internal tries to run debian/rules clean inside  the  chroot.   To  do  so,  the  working
              directory is passed on inside the chroot, in the form of bind-mounting and debuild is run.

              This  option  will  not  protect  the  working directory and its parent directories from the build
              scripts.

       --logfile[filetolog]
              Specifies the build logfile to create.  The messages generated during execution will be written to
              the file, as well as standard output.

       --pbuilder[pbuilder]
              Specifies which command to invoke as pbuilder.

       --help

              Show a brief help message.

       --[pbuilderoptions]

              After the -- symbol, an arbitrary number of pbuilder options can be  specified.   See  pbuilder(8)
              for a full list of options.

              There  is an exception that --buildresult needs to be specified as a pdebuild option before the --
              in order to be effective.

/usr/share/doc/pbuilder/pbuilder-doc.html, pbuilder(8), pbuilderrc(5)

Debian                                             2006 May 24                                       pdebuild(1)

pdebuild[pdebuildoptions]--[pbuilderoptions]