mirror of
https://git.launchpad.net/ubuntu-dev-tools
synced 2025-03-13 08:01:09 +00:00
109 lines
4.0 KiB
Groff
109 lines
4.0 KiB
Groff
.TH BACKPORTPACKAGE "1" "December 2010" "ubuntu-dev-tools"
|
|
.SH NAME
|
|
backportpackage \- helper to test package backports
|
|
.SH SYNOPSIS
|
|
.TP
|
|
.B backportpackage \fR[\fIadditional options\fR]
|
|
\-\-upload <\fIupload target\fR>
|
|
.br
|
|
<\fIsource package name or .dsc URL/file\fR>
|
|
.PP
|
|
.B backportpackage \-h
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-d \fIDEST\fR, \-\-destination=\fIDEST\fR
|
|
\fBRequired\fR. Backport the package to the specified Ubuntu
|
|
release. If this option is unspecified, then \fBbackportpackage\fR
|
|
defaults to the release on which it is currently running.
|
|
.TP
|
|
.B \-s \fISOURCE\fR, \-\-source=\fISOURCE\fR
|
|
Backport the package from the specified Ubuntu release. If neither
|
|
this option nor \fB\-\-version\fR are specified, then
|
|
\fBbackportpackage\fR defaults to the current Ubuntu development
|
|
release.
|
|
.TP
|
|
.B \-b, \-\-build
|
|
Build the package with the specified builder before uploading. Note
|
|
for \fBpbuilder\fR(8) users: This assumes the common configuration,
|
|
where the \fBDIST\fR environment is read by \fBpbuilderrc\fR(5) to
|
|
select the correct base image.
|
|
.TP
|
|
.B \-B \fIBUILDER\fR, \fB\-\-builder\fR=\fIBUILDER
|
|
Use the specified builder to build the package. Supported are
|
|
\fBpbuilder\fR(8) and \fBsbuild\fR(1). This overrides
|
|
\fBUBUNTUTOOLS_BUILDER\fR. The default is \fBpbuilder\fR(8).
|
|
.TP
|
|
.B \-U, \-\-update
|
|
Update the builder environment before attempting to build.
|
|
.TP
|
|
.B \-u \fIUPLOAD\fR, \-\-upload=\fIUPLOAD\fR
|
|
Upload to \fIUPLOAD\fR with \fBdput\fR(1) (after confirmation).
|
|
.TP
|
|
.B \-v \fIVERSION\fR, \-\-version=\fIVERSION\fR
|
|
If the \fB\-\-source\fR option is specified, then
|
|
\fBbackportpackage\fR verifies that the current version of \fIsource
|
|
package\fR in \fISOURCE\fR is the same as \fIVERSION\fR. Otherwise,
|
|
\fBbackportpackage\fR finds version \fIVERSION\fR of \fIsource
|
|
package\fR, regardless of the release in which it was published (or if
|
|
that version is still current). This option is ignored if a .dsc URL
|
|
or path is passed in instead of a source package name.
|
|
.TP
|
|
.B \-w \fIWORKDIR\fR, \-\-workdir=\fIWORKDIR\fR
|
|
If \fIWORKDIR\fR is specified, then all files are downloaded,
|
|
unpacked, built into, and otherwise manipulated in
|
|
\fIWORKDIR\fR. Otherwise, a temporary directory is created, which is
|
|
deleted before \fIbackportpackage\fR exits.
|
|
.TP
|
|
.B \-l \fIINSTANCE\fR, \-\-launchpad=\fIINSTANCE\fR
|
|
Use the specified instance of Launchpad (e.g. "staging"), instead of
|
|
the default of "production".
|
|
.SH DESCRIPTION
|
|
\fBbackportpackage\fR fetches a package from one Ubuntu release or
|
|
from a specified .dsc path or URL and creates a no-change backport of
|
|
that package to a previous release, optionally doing a test build of
|
|
the package and/or uploading the resulting backport for testing.
|
|
.PP
|
|
Unless a working directory is specified, the backported package is
|
|
fetched and built in a temporary directory in \fB/tmp\fR, which is
|
|
removed once the script finishes running.
|
|
.PP
|
|
\fBbackportpackage\fR is only recommended for testing backports in a
|
|
PPA, not uploading backports to the Ubuntu archive.
|
|
.SH ENVIRONMENT
|
|
.TP
|
|
.B UBUNTUTOOLS_BUILDER
|
|
The default builder for Ubuntu development tools that support it
|
|
(including \fBbackportpackage\fR). Supported are \fBpbuilder\fR(8) and
|
|
\fBsbuild\fR(1). If unset and not provided on the command line,
|
|
\fBpbuilder\fR(8) is used.
|
|
.SH EXAMPLES
|
|
Test-build in your PPA a backport of znc from the current development
|
|
release to your workstation's release, deleting the build products
|
|
afterwards:
|
|
.IP
|
|
.nf
|
|
.B backportpackage -u ppa:\fIuser\fR/\fIppa\fB znc
|
|
.fi
|
|
.PP
|
|
Backport squashfs-tools from Maverick to both Karmic and Lucid and
|
|
test-build both locally, leaving all build products in the current
|
|
working directory:
|
|
.IP
|
|
.nf
|
|
.B backportpackage -b -s maverick -d karmic -d lucid -w . \\\\
|
|
.B " "squashfs-tools
|
|
.fi
|
|
.PP
|
|
Fetch a package from a PPA, backport it to Hardy, then upload it back
|
|
to the same PPA:
|
|
.IP
|
|
.nf
|
|
.B backportpackage -d hardy -u ppa:\fIuser\fR/\fIppa\fR \\\\
|
|
.B " "https://launchpad.net/\fIsome/file.dsc\fR
|
|
.fi
|
|
.SH AUTHOR
|
|
\fBbackportpackage\fR and this manpage were written by Evan Broder
|
|
<evan@ebroder.net>
|
|
.PP
|
|
Both are released under GNU General Public License, version 2.
|