45
45
to using one or the other consistently as this name may be used in file paths
46
46
and to locate old packages for comparison reporting.
48
It is now also possible to use locally defined names with this option, when
49
used in conjunction with the \fBBASE_DIST\fP option in a configuration file.
50
This permits the maintenance and use of specially configured build chroots,
51
which can source package dependencies from the backports archives or a local
52
repository, or have other unusual configuration options set, without polluting
53
the chroots you use for clean package builds intended for upload to the main
54
repositories. See the description of \fBBASE_DIST\fP below.
49
57
.BI \-\-buildd= host
50
58
Specify the remote host to build on.
59
67
is not passed it is an error for the specified \fB\-\-dist\fP or \fB\-\-arch\fP
60
68
to not have an existing \fBcowbuilder\fR root in the expected location.
70
The \fB\-\-buildd\-user\fP must have permission to create the \fBRESULT_DIR\fP
71
on the build host, or an admin with the necessary permission must first create
72
it and give that user (or some group they are in) write access to it, for this
63
76
.BR \-\-return= [ \fIpath ]
64
77
Copy results of the build to \fIpath\fP. If \fIpath\fP is not specified, then return
76
89
\fBDEBBUILDOPTS\fP in the build host's \fIpbuilderrc\fP.
92
.BI \-\-create\-opts= "'cowbuilder option'"
93
Specify additional arguments to be passed verbatim to \fBcowbuilder\fR when a
94
chroot is first created (using the \fB\-\-create\fP option above). If multiple
95
arguments need to be passed, this option should be specified separately for
98
E.g., \fB\-\-create\-opts "\-\-othermirror" \-\-create\-opts "deb http:// ..."\fP
100
This option will override any \fBCREATE_OPTS\fP specified for a chroot in the
101
cowpoke configuration files.
104
.BI \-\-update\-opts= "'cowbuilder option'"
105
Specify additional arguments to be passed verbatim to \fBcowbuilder\fR if the
106
base of the chroot is updated. If multiple arguments need to be passed, this
107
option should be specified separately for each of them.
109
This option will override any \fBUPDATE_OPTS\fP specified for a chroot in the
110
cowpoke configuration files.
113
.BI \-\-build\-opts= "'cowbuilder option'"
114
Specify additional arguments to be passed verbatim to \fBcowbuilder\fR when
115
a package build is performed. If multiple arguments need to be passed, this
116
option should be specified separately for each of them.
118
This option will override any \fBBUILD_OPTS\fP specified for a chroot in the
119
cowpoke configuration files.
80
123
Display a brief summary of the available options and current configuration.
123
166
be placed. This must be writable by the \fBBUILDD_USER\fP.
126
The filesystem root for all pbuilder COW and result files. Arch and dist
169
The filesystem root for all pbuilder CoW and result files. \fIArch\fP and \fIdist\fP
127
170
specific subdirectories will normally be created under this. The apt cache
128
171
and temporary build directory will also be located under this path.
132
If this option is set, it is expected to contain the gpg key id to pass to
175
If this option is set, it is expected to contain the gpg key ID to pass to
133
176
\fBdebsign\fP(1) if the packages are to be remotely signed. You will be prompted
134
177
to confirm whether you wish to sign the packages after all builds are complete.
135
178
If this option is unset or an empty string, no attempt to sign packages will be
179
made. It may be overridden on an \fIarch\fP and \fIdist\fP specific basis using
181
.IB arch _ dist _SIGN_KEYID
182
option described below.
139
186
If this option is set, it is expected to contain a 'host' specification for
190
241
\fBdebdiff\fP(1), and for upload with \fBdput\fP(1). If this option is not
191
242
specified for some arch and dist combination then it will default to
192
243
.I $PBUILDER_BASE/$arch/$dist/result
196
246
.IB arch _ dist _BASE_PATH
197
The directory where the COW master files are to be found (or created if the
247
The directory where the CoW master files are to be found (or created if the
198
248
\fB\-\-create\fP command line option was passed). If this option is not specified
199
249
for some arch or dist then it will default to
200
250
.I $PBUILDER_BASE/$arch/$dist/base.cow
253
.IB arch _ dist _BASE_DIST
254
The code name to pass as the \fB\-\-distribution\fP option for cowbuilder instead
255
of \fIdist\fP. This is necessary when \fIdist\fP is a locally significant name
256
assigned to some specially configured build chroot, such as 'wheezy_backports',
257
and not the formal suite name of a distro release known to debootstrap. This
258
option cannot be overridden on the command line, since it would rarely, if ever,
259
make any sense to change it for individual invocations of \fBcowpoke\fP. If this
260
option is not specified for an arch and dist combination then it will default to
264
.IB arch _ dist _CREATE_OPTS
265
A bash array containing additional options to pass verbatim to \fBcowbuilder\fP
266
when this chroot is created for the first time (using the \fB\-\-create\fP option).
267
This is useful when options like \fB\-\-othermirror\fP are wanted to create
268
specialised chroot configurations such as 'wheezy_backports'. By default this
269
is unset. All values set in it will be overridden if the \fB\-\-create\-opts\fP
270
option is passed on the command line.
272
Each element in this array corresponds to a single argument (in the ARGV sense)
273
that will be passed to cowbuilder. This ensures that arguments which may contain
274
whitespace or have strange quoting requirements or other special characters will
275
not be mangled before they get to cowbuilder.
277
Bash arrays are initialised using the following form:
279
OPTS=( "arg1" "arg 2" "\-\-option" "value" "\-\-opt=val" "etc. etc." )
282
.IB arch _ dist _UPDATE_OPTS
283
A bash array containing additional options to pass verbatim to \fBcowbuilder\fP
284
each time the base of this chroot is updated. It behaves similarly to the
285
\fBCREATE_OPTS\fP option above, except for acting when the chroot is updated.
288
.IB arch _ dist _BUILD_OPTS
289
A bash array containing additional options to pass verbatim to \fBcowbuilder\fP
290
each time a package build is performed in this chroot. This is useful when you
291
want to use some option like \fB\-\-twice\fP which cowpoke does not directly
292
need to care about. It otherwise behaves similarly to \fBUPDATE_OPTS\fP above
293
except that it acts during the build phase of \fBcowbuilder\fP.
296
.IB arch _ dist _SIGN_KEYID
297
An optional arch and dist specific override for the global SIGN_KEYID option.
300
.IB arch _ dist _UPLOAD_QUEUE
301
An optional arch and dist specific override for the global UPLOAD_QUEUE option.
203
304
.SH CONFIGURATION FILES