pdebuild(1)

1pdebuild(1)                        pbuilder                        pdebuild(1)
2
3
4

NAME

6       pdebuild - pbuilder way of doing debuild
7

SYNOPSIS

9       pdebuild [pdebuild options] -- [pbuilder options]
10

DESCRIPTION

12       A convenience program for pbuilder which invokes pbuilder after obtain‐
13       ing appropriate root privilege in a Debian source directory.  One  must
14       be inside the source tree containing the debian directory.
15
16       By   default,   build   log   file   is  stored  in  ../<package>_<ver‐
17       sion>_<arch>.build.
18
19
20

PDEBUILD OPTIONS

22       The options have the form --option  name  which  modify  the  operation
23       semantics as explained below.  They are applied from left to right, and
24       when options conflict, the option that appear later take precedence.
25
26
27       --buildsourceroot [fakeroot]
28              The  command  used  to  gain   root   privilege   for   invoking
29              debian/rules clean
30
31
32       --pbuilderroot [sudo -E]
33              The command used to gain root privilege for invoking pbuilder.
34
35
36       --pbuildersatisfydepends [/usr/lib/pbuilder/pbuilder-satisfydepends]
37              The command used to satisfy (i.e. install) build-dependencies.
38
39
40       --architecture
41
42              Set  architecture.   This  is currently required when it doesn't
43              match the host architecture.
44
45
46       --auto-debsign
47
48              Invoke debsign at the end of pdebuild process.
49
50
51       --debsign-k [key-id]
52              Pass -k option to debsign to specify which key-id to sign with.
53
54
55       --buildresult [Directory for build results]
56
57              The place where the build result is stored.
58
59              Note that for pdebuild, buildresult needs to be specified  as  a
60              pdebuild option on the command-line, not as a pbuilder option.
61
62              Note  that  the default value for buildresult is what is defined
63              for pbuilder, which is /var/cache/pbuilder/result and not ..
64
65
66       --configfile [Extra config file to use]
67
68              The configuration file is used, and passed on to pbuilder.
69
70
71       --debbuildopts [options to pass to dpkg-buildpackage]
72
73              The space-delimited list of options are  passed  to  dpkg-build‐
74              package.   This option appends to pbuilder option --debbuildopts
75              and may also be used to reset the list of options by passing the
76              empty string.
77
78              Multiple options are delimited with spaces.
79
80              Note  that for pdebuild, dpkg-source is used to build the source
81              package which is given to pbuilder. This option has no effect on
82              the  arguments  used to build this source package, but will con‐
83              trol whether the clean target is run first  as  usual,  and  any
84              options for dpkg-genchanges will be passed on.
85
86
87       --use-pdebuild-internal
88              Uses  a  different implementation of pdebuild, which calls clean
89              and build inside the chroot, using bind-mounts.
90
91              pdebuild-internal tries to run  debian/rules  clean  inside  the
92              chroot.  To do so, the working directory is passed on inside the
93              chroot, in the form of bind-mounting and debuild is run.
94
95              This option will not protect the working directory and its  par‐
96              ent directories from the build scripts.
97
98
99       --logfile [file to log]
100              Specifies  the  build logfile to create.  The messages generated
101              during execution will be written to the file, as well  as  stan‐
102              dard output.
103
104
105       --pbuilder [pbuilder]
106              Specifies which command to invoke as pbuilder.
107
108
109       --help
110
111              Show a brief help message.
112
113
114       -- [pbuilder options]
115
116              After the -- symbol, an arbitrary number of pbuilder options can
117              be specified.  See pbuilder(8) for a full list of options.
118
119
120              There is an exception that --buildresult needs to  be  specified
121              as a pdebuild option before the -- in order to be effective.
122
123

FILES

125       /etc/pbuilderrc
126              The configuration file for pbuilder, used in pdebuild.
127
128
129       /usr/share/pbuilder/pbuilderrc
130              The default configuration file for pbuilder, used in pdebuild.
131
132
133       ${HOME}/.pbuilderrc
134              Configuration file for pbuilder, used in pdebuild.  It overrides
135              /etc/pbuilderrc
136
137
138

EXAMPLES

140       pdebuild
141
142              $ pwd
143              /home/dancer/DEBIAN/cowdancer/cowdancer
144              $ ls debian/rules
145              debian/rules
146              $ pdebuild
147              dh clean
148                 dh_testdir
149                 dh_auto_clean
150                 dh_autoreconf_clean
151                 dh_clean
152                   .
153                   .
154                   .
155              dpkg-source: info: using source format '3.0 (native)'
156              dpkg-source: info: building cowdancer in cowdancer_0.84.tar.xz
157              dpkg-source: info: building cowdancer in cowdancer_0.84.dsc
158                   .
159                   .
160                   .
161
162

BUGS

164       pdebuild will accept all options that pbuilder accepts as pdebuild  op‐
165       tion.   However, unless the option is documented in the manual page, it
166       may be ignored.
167
168

AUTHOR

170       Initial  coding  and  main  maintenance  is  done  by  Junichi   Uekawa
171       <dancer@debian.org>.
172
173       The homepage is http://pbuilder.alioth.debian.org
174
175