mirror of
https://git.launchpad.net/ubuntu-dev-tools
synced 2025-03-13 16:11:15 +00:00
105 lines
4.1 KiB
Groff
105 lines
4.1 KiB
Groff
.TH PBUILDER\-DIST 1 "August 16, 2007" "ubuntu-dev-tools"
|
|
|
|
.SH NAME
|
|
pbuilder\-dist \- multi-distribution pbuilder wrapper
|
|
|
|
.SH SYNOPSIS
|
|
\fBpbuilder\-dist\fP \fIdistribution\fR [\fBi386\fP|\fBamd64\fP] [\fBmainonly\fP|\fBallcomp\fP]
|
|
[\fBwithlog\fP|\fBnolog\fP] \fIoperation\fR [\fI...\fR]
|
|
|
|
.SH DESCRIPTION
|
|
\fBpbuilder\-dist\fP is a wrapper that makes it easy to use pbuilder with many different
|
|
versions of Ubuntu and/or Debian.
|
|
.PP
|
|
It is common to symlink this script in order to give it many names in the form of
|
|
\fBpbuilder\-\fIdistribution\fP\fR (\fBpbuilder\-\fIdistribution\fR\-\fIarchitecture\fP\fR on amd64
|
|
systems), like for example \fBpbuilder\-feisty\fP, \fBpbuilder\-sid\fP, \fBpbuilder\-gutsy\-i386\fP, etc.
|
|
|
|
.SH USAGE
|
|
There are many arguments listed on the synopsis; each of them, if used, has to be used exactly in
|
|
the same order as it appears there.
|
|
In case you renamed the script to \fBpbuilder\-\fIdistribution\fP\fR, do not
|
|
use the \fBdistribution\fP parameter; same with \fBi386\fP / \fBamd64\fP if
|
|
the name also contains \-\fIarchitecture\fR.
|
|
.TP
|
|
\fBdistribution\fP
|
|
Replace this with the codename of the version of Ubuntu or Debian you want to use.
|
|
.TP
|
|
\fBi386\fP / \fBamd64\fP
|
|
Only available on amd64 systems.
|
|
This is optional; default is \fBamd64\fP.
|
|
If \fBi386\fP is specified, an i386 environment will be used.
|
|
.TP
|
|
\fBmainonly\fP / \fBallcomp\fP
|
|
This is optional; default is \fBallcomp\fP.
|
|
If you specify \fBmainonly\fP, only packages from the main (in Debian) or
|
|
main and restricted (in Ubuntu) components will be used.
|
|
With the latter one, all official components will be enabled.
|
|
This only has effect when creating a new environment.
|
|
.TP
|
|
\fBwithlog\fP / \fBnolog\fP
|
|
This is optional; default is \fBnolog\fP.
|
|
When \fBwithlog\fP is used, \fBpbuilder\fP will save the output produced by
|
|
the current action in a dot-file called \fB.lastlog\fP in its base directory
|
|
(see the FILES section).
|
|
If this file already exists, it will be overwritten.
|
|
.TP
|
|
\fBoperation\fP
|
|
Replace this with the action you want \fBpbuilder\fP to do (create, update, build, clean, login
|
|
or execute). If you don't specify any action, but the next argument is a .dsc file, it will
|
|
assume that it should build.
|
|
Check its manpage for more details.
|
|
.TP
|
|
\fB[...]\fP
|
|
.br
|
|
Replace this with other parameters, if needed.
|
|
For example, if \fBbuild\fP is the option, you will need to also specify
|
|
a .dsc file.
|
|
.PP
|
|
The default value of all optional parameters (except the architecture) can be changed by
|
|
editing the first lines of the script. You can also change the base directory using the
|
|
global variable $PBUILDFOLDER.
|
|
.PP
|
|
|
|
.SH EXAMPLES
|
|
.TP
|
|
pbuilder\-dist gutsy create
|
|
Creates a \fBpbuilder\fP environment for Ubuntu Gutsy, with all components enabled.
|
|
.TP
|
|
pbuilder\-sid mainonly create
|
|
Creates a \fBpbuilder\fP environment for Debian Sid, with only the main component.
|
|
.TP
|
|
pbuilder\-feisty build ./sample_1.0\-0ubuntu1.dsc
|
|
Builds the specified package on an already existing Ubuntu Feisty environment.
|
|
.TP
|
|
pbuilder\-dist feisty withlog build ./sample_1.0\-0ubuntu1.dsc
|
|
Same as above, but stores \fBpbuilder\fP's output on a file.
|
|
.TP
|
|
pbuilder\-etch i386 update
|
|
Updates an existing i386-architecture Debian Etch environment on an amd64 system.
|
|
|
|
.SH FILES
|
|
By default, \fBpbuilder\-dist\fP will store all the files it generates in \fB~/pbuilder/\fP.
|
|
This can be changed by modifying the BASE_DIR value on the top of the script
|
|
to any other directory you want, or by using the $PBUILDFOLDER global variable.
|
|
If it doesn't exist, it will be created on the run.
|
|
|
|
.SH BUGS
|
|
There are no known bugs at the moment.
|
|
If you experience any problem with this script contact me on
|
|
rainct@ubuntu.com.
|
|
Please ensure first that the problem is really this script and not an issue
|
|
with \fBpbuilder\fP.
|
|
|
|
.SH SEE ALSO
|
|
\fBpbuilder\fR, \fBpbuilderrc\fR
|
|
|
|
.SH AUTHORS
|
|
\fBpbuilder\-dist\fP was originally written by Jamin W. Collins
|
|
<jcollins@asgardsrealm.net> and Jordan Mantha <mantha@ubuntu.com>. On August
|
|
2007 it was mostly rewritten, and extended, by Siegfried-Angel Gevatter Pujals
|
|
<rainct@ubuntu.com>.
|
|
.BB
|
|
\fBpbuilder\-dist\fP is released under the GNU General Public License, version
|
|
2 or later.
|