1
.\" Title: pbuilder-dist
2
.\" Author: Siegfried-Angel Gevatter Pujals
3
.\" Contact details: siggi.gevatter@gmail.com
5
.TH PBUILDER\-DIST 1 "August 16, 2007"
1
.TH PBUILDER\-DIST 1 "January 10, 2008" "ubuntu-dev-tools"
8
pbuilder\-dist \- multi-distribution pbuilder wrapper
4
pbuilder\-dist, cowbuilder\-dist \- multi-distribution pbuilder/cowbuilder wrapper
11
\fBpbuilder\-dist\fP \fIdistribution\fR [\fBi386\fP|\fBamd64\fP] [\fBmainonly\fP|\fBallcomp\fP]
12
[\fBwithlog\fP|\fBnolog\fP] \fIoperation\fR [\fI...\fR]
7
\fBpbuilder\-dist\fP \fIdistribution\fR [\fBi386\fP|\fBamd64\fP] [\fBmainonly\fP]
8
\fIoperation\fR [\fI...\fR]
10
\fBcowbuilder\-dist\fP \fIdistribution\fR [\fBi386\fP|\fBamd64\fP] [\fBmainonly\fP]
11
\fIoperation\fR [\fI...\fR]
15
14
\fBpbuilder\-dist\fP is a wrapper that makes it easy to use pbuilder with many different
16
15
versions of Ubuntu and/or Debian.
18
17
It is common to symlink this script in order to give it many names in the form of
19
18
\fBpbuilder\-\fIdistribution\fP\fR (\fBpbuilder\-\fIdistribution\fR\-\fIarchitecture\fP\fR on amd64
20
19
systems), like for example \fBpbuilder\-feisty\fP, \fBpbuilder\-sid\fP, \fBpbuilder\-gutsy\-i386\fP, etc.
21
The same applies to \fBcowbuilder\-dist\fP, which uses cowbuilder. The main
22
difference between both is that pbuilder compresses the created chroot as a
23
a tarball, thus using less disc space but needing to uncompress (and possibly
24
compress) its contents again on each run, and cowbuilder doesn't do this.
23
There are many arguments listed on the synopsis.
24
Each of them, if used, has to be used exactly in the same order as it
27
There are many arguments listed on the synopsis; each of them, if used, has to be used exactly in
28
the same order as it appears there.
26
29
In case you renamed the script to \fBpbuilder\-\fIdistribution\fP\fR, do not
27
30
use the \fBdistribution\fP parameter; same with \fBi386\fP / \fBamd64\fP if
28
31
the name also contains \-\fIarchitecture\fR.
35
38
This is optional; default is \fBamd64\fP.
36
39
If \fBi386\fP is specified, an i386 environment will be used.
38
\fBmainonly\fP / \fBallcomp\fP
39
This is optional; default is \fBallcomp\fP.
40
42
If you specify \fBmainonly\fP, only packages from the main (in Debian) or
41
main and restricted (in Ubuntu) components will be used.
42
With the latter one, all official components will be enabled.
43
This only has effect when creating a new environment.
45
\fBwithlog\fP / \fBnolog\fP
46
This is optional; default is \fBnolog\fP.
47
When \fBwithlog\fP is used, \fBpbuilder\fP will save the output produced by
48
the current action in a dot-file called \fB.lastlog\fP in its base directory
49
(see the FILES section).
50
If this file already exists, it will be overwritten.
43
main and restricted (in Ubuntu) components will be used. By default, all
44
official components are enabled. This only has effect when creating a new
53
Replace this with the action you want \fBpbuilder\fP to do (create, update, build, clean, login
48
Replace this with the action you want \fBpbuilder\fP to do (create, update,
49
build, clean, login or execute).
50
If you don't specify any action, but the next argument is a .dsc file, it
51
will assume that it should build.
55
52
Check its manpage for more details.
59
56
Replace this with other parameters, if needed.
60
57
For example, if \fBbuild\fP is the option, you will need to also specify
63
The default value of all optional parameters (except the architecture) can be changed by
64
editing the first lines of the script.
58
a .dsc file. As a special feature, if you specify a .dsc file you can
59
skip the \fBbuild\fP option and this script will automatically assume that
60
building is the action you want to do.
62
You may also specify \fB--debug-echo\fP so that the \fBpbuilder\fP/
63
\fBcowbuilder\fP command which would normally be executed is just printed
64
on the standard output instead. This is useful for debugging
68
69
pbuilder\-dist gutsy create
80
81
pbuilder\-etch i386 update
81
82
Updates an existing i386-architecture Debian Etch environment on an amd64 system.
84
By default, \fBpbuilder\-dist\fP will store all the files it generates in \fB~/pbuilder/\fP.
85
This can be changed by modifying the BASE_DIR value on the top of the script
86
to any other directory you want.
87
If it doesn't exist, it will be created on the run.
84
cowbuilder-experimental create
85
Creates a \fBcowbuilder\fP environment for Debian Experimental.
87
.SH FILES AND ENVIRONMENT VARIABLES
88
By default, \fBpbuilder\-dist\fP will store all the files it generates in
89
\fB~/pbuilder/\fP. This can be changed by setting the $PBUILDFOLDER global
90
variable. If the directory doesn't exist, it will be created on the run.
92
A file with the log of the last operation, called last_operation.log, will be
93
saved in the results subdirectory of each build environment.
95
The default authentication method is \fBsudo\fP. You can change this by
96
setting the $PBUILDAUTH variable.
90
There are no known bugs at the moment.
91
If you experience any problem with this script contact me on
92
siggi.gevatter@gmail.com.
99
If you experience any problem with this script contact me on rainct@ubuntu.com
100
or file a bug at https://bugs.launchpad.net/ubuntu/+source/ubuntu-dev-tools.
93
102
Please ensure first that the problem is really this script and not an issue
103
with \fBpbuilder\fP or \fBcowbuilder\fP themselves.
106
\fBpbuilder\fR, \fBpbuilderrc\fR, \fBcowbuilder\fR
97
\fBpbuilder\-dist\fP was originally written by Jamin W. Collins <jcollins@asgardsrealm.net> and
98
Jordan Mantha <mantha@ubuntu.com>.
100
On August 2007 it was mostly rewritten, and extended, by Siegfried-Angel Gevatter Pujals
101
<siggi.gevatter@gmail.com>.
104
\fBpbuilder\fR, \fBpbuilderrc\fR
107
This manual page was written by Siegfried-Angel Gevatter Pujals (RainCT)
108
<siggi.gevatter@gmail.com> for YOU.
109
Permission is granted to copy, distribute and/or modify this document
110
under the terms of the GNU General Public License,
111
Version 2 or any later version published by the Free Software Foundation.
113
On Debian based systems, the complete text of the GNU General Public
114
License can be found in \fB/usr/share/common\-licenses/GPL\fP.
109
\fBpbuilder\-dist\fP was written by Siegfried-A. Gevatter <rainct@ubuntu.com>
110
and includes patches by Iain Lane <iain@orangesquash.org.uk>. This manual page
111
has been written by Siegfried-A. Gevatter <rainct@ubuntu.com>.
113
\fBpbuilder\-dist\fP is released under the GNU General Public License, version
added
removed
doc/pbuilder-dist.1
