1pdebuild(1) pbuilder pdebuild(1)
2
3
4
6 pdebuild - pbuilder way of doing debuild
7
9 pdebuild [pdebuild options] -- [pbuilder options]
10
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
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
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
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
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
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
177 /usr/share/doc/pbuilder/pbuilder-doc.html, pbuilder(8), pbuilderrc(5)
178
179
180
181
182
183Debian 2006 May 24 pdebuild(1)