pdebuild(1)

NAME

   pdebuild - pbuilder way of doing debuild

SYNOPSIS

   pdebuild [pdebuild options] -- [pbuilder options]

DESCRIPTION

   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 OPTIONS

   The options have the form --option  name  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  dpkg-
          buildpackage

   --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 [Directory for build results]

          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 [Extra config file to use]

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

   --debbuildopts [options to pass to dpkg-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, debbuildopts needs to be specified as a
          pdebuild option in the command-line, not as a pbuilder option.

   --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 [file to log]
          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.

   -- [pbuilder options]

          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 and --debbuildopts need
          to be specified as pdebuild options before the -- in order to be
          effective.

FILES

   /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

EXAMPLES

   pdebuild

          $ pwd
          /home/dancer/DEBIAN/cowdancer/cowdancer
          $ ls debian/rules
          debian/rules
          $ pdebuild
          W: /home/dancer/.pbuilderrc does not exist
          dpkg-buildpackage: source package is cowdancer
          dpkg-buildpackage: source version is 0.26
          dpkg-buildpackage: source changed by Junichi Uekawa <dancer@debian.org>
          dpkg-buildpackage: source version without epoch 0.26
           fakeroot debian/rules clean
          dh_testdir
          dh_testroot
          rm -f build-stamp configure-stamp
          /usr/bin/make clean
          make[1]: Entering directory `/home/dancer/DEBIAN/cowdancer/cowdancer'
          rm -f *~ *.o *.lo libcowdancer.so cow-shell cowbuilder
          make[1]: Leaving directory `/home/dancer/DEBIAN/cowdancer/cowdancer'
          dh_clean
           dpkg-source -b cowdancer
          dpkg-source: warning: source directory `./cowdancer' is not <sourcepackage>-<upstreamversion> `cowdancer-0.26'
          dpkg-source: building cowdancer in cowdancer_0.26.tar.gz
               .
               .
               .

BUGS

   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.

AUTHOR

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

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

SEE ALSO

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

---

Free and Open Source Software