Provided by: ubuntu-dev-tools_0.153_all bug

NAME

       backportpackage - helper to test package backports

SYNOPSIS

       backportpackage [additional options]
              --upload <upload target>
              <source package name or .dsc URL/file>

       backportpackage -h

DESCRIPTION

       backportpackage fetches a package from one distribution release or from
       a specified .dsc path or URL and creates a no-change backport  of  that
       package to one or more Ubuntu releases release, optionally doing a test
       build of the  package  and/or  uploading  the  resulting  backport  for
       testing.

       Unless  a  working  directory  is  specified, the backported package is
       fetched and built in a temporary directory in /tmp,  which  is  removed
       once the script finishes running.

       backportpackage is only recommended for testing backports in a PPA, not
       uploading backports to the Ubuntu archive.

OPTIONS

       -d DEST, --destination=DEST
              Backport the package to the specified Ubuntu  release.  If  this
              option  is  unspecified,  then  backportpackage  defaults to the
              release on which it is currently running.

       -s SOURCE, --source=SOURCE
              Backport the package from the specified release,  which  can  be
              any  release  of your distribution or any of your distribution's
              parent distributions. If neither this option nor  --version  are
              specified,   then   backportpackage   defaults  to  the  current
              development release for your distribution.

       -S SUFFIX, --suffix=SUFFIX
              Add the specified suffix to the version number when backporting.
              backportpackage  will  always append ~ubuntuDESTINATION.1 to the
              original version number, and  if  SUFFIX  is  specified,  it  is
              appended   to   that,   to  get  version  numbers  of  the  form
              ORIGINAL_VERSION~ubuntuDESTINATION.1SUFFIX.  If  the  backported
              package  is  being  uploaded  to  a PPA, then SUFFIX defaults to
              ~ppa1, otherwise the default is blank.

       -b, --build
              Build the package with the specified builder  before  uploading.
              Note  for  cowbuilder(8) and pbuilder(8) users: This assumes the
              common configuration, where the ARCH  and  DIST  environment  is
              read by pbuilderrc(5) to select the correct base image.

       -B BUILDER, --builder=BUILDER
              Use  the  specified  builder to build the package. Supported are
              cowbuilder(8),   cowbuilder-dist(1),   pbuilder(8),    pbuilder-
              dist(1), and sbuild(1).  The default is pbuilder(8).

       -U, --update
              Update the build environment before attempting to build.

       -u UPLOAD, --upload=UPLOAD
              Upload to UPLOAD with dput(1) (after confirmation).

       -k KEYID, --key=KEYID
              Specify the key ID to be used for signing.

       --dont-sign
              Do not sign the upload.

       -y, --yes
              Do  not prompt before uploading to a PPA. For everyone's safety,
              this option is ignored if UPLOAD is ubuntu.

       -v VERSION, --version=VERSION
              If  the  --source  option  is  specified,  then  backportpackage
              verifies that the current version of source package in SOURCE is
              the same as VERSION. Otherwise,  backportpackage  finds  version
              VERSION  of  source  package  in  your distribution's publishing
              history, 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.

       -w WORKDIR, --workdir=WORKDIR
              If  WORKDIR  is  specified,  then  all  files  are   downloaded,
              unpacked,  built  into,  and  otherwise  manipulated in WORKDIR.
              Otherwise, a temporary directory is created,  which  is  deleted
              before backportpackage exits.

       -r, --release-pocket
              Target  the  upload  at  the  release  pocket,  rather  than the
              -backports pocket.  This is required for Launchpad  PPAs,  which
              are  pocket-less  (and  the default, when the upload target is a
              PPA).

       -m MIRROR, --mirror=MIRROR
              Use   the   specified   mirror.    Should   be   in   the   form
              http://archive.ubuntu.com/ubuntu.  If the package isn't found on
              this mirror, backportpackage will use Launchpad.

       -c BUG, --close=BUG
              Include a Launchpad closer for the specified bug  in  the  auto-
              generated  changelog. In the future, this may actually close the
              bug, but currently does not.

       -l INSTANCE, --lpinstance=INSTANCE
              Use  the  specified  instance  of  Launchpad  (e.g.  "staging"),
              instead of the default of "production".

       --no-conf
              Do  not  read  any  configuration  files,  or configuration from
              environment variables.

ENVIRONMENT

       DEBFULLNAME, DEBEMAIL, UBUMAIL
              Used to determine the uploader (if  not  supplied  as  options).
              See ubuntu-dev-tools(5) for details.

       All  of  the  CONFIGURATION  VARIABLES  below  are  also  supported  as
       environment variables.  Variables in the environment take precedence to
       those in configuration files.

CONFIGURATION VARIABLES

       The   following   variables  can  be  set  in  the  environment  or  in
       ubuntu-dev-tools(5)   configuration   files.    In   each   case,   the
       script-specific   variable   takes  precedence  over  the  package-wide
       variable.

       BACKPORTPACKAGE_BUILDER, UBUNTUTOOLS_BUILDER
              The default value for --builder.

       BACKPORTPACKAGE_UPDATE_BUILDER, UBUNTUTOOLS_UPDATE_BUILDER
              The default value for --update.

       BACKPORTPACKAGE_UPLOAD
              The default value for --upload.

       BACKPORTPACKAGE_WORKDIR, UBUNTUTOOLS_WORKDIR
              The default value for --workdir.

       BACKPORTPACKAGE_UBUNTU_MIRROR, UBUNTUTOOLS_UBUNTU_MIRROR
              The default value for --mirror if the specified  SOURCE  release
              is an Ubuntu release.

       BACKPORTPACKAGE_DEBIAN_MIRROR, UBUNTUTOOLS_DEBIAN_MIRROR
              The  default  value for --mirror if the specified SOURCE release
              is a Debian release.

       BACKPORTPACKAGE_LPINSTANCE, UBUNTUTOOLS_LPINSTANCE
              The default value for --lpinstance.

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:

              backportpackage -u ppa:user/ppa znc

       Backport squashfs-tools from Maverick to  both  Karmic  and  Lucid  and
       test-build  both  locally,  leaving  all  build products in the current
       working directory:

              backportpackage -b -s maverick -d karmic -d lucid -w . \
                 squashfs-tools

       Fetch a package from a PPA, backport it to Hardy, then upload  it  back
       to the same PPA:

              backportpackage -d hardy -u ppa:user/ppa \
                 https://launchpad.net/some/file.dsc

SEE ALSO

       ubuntu-dev-tools(5)

AUTHOR

       backportpackage   and   this   manpage  were  written  by  Evan  Broder
       <evan@ebroder.net>

       Both are released under GNU General Public License, version 2.