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)