NAME

       pull-pkg - download a package for Debian, Ubuntu, UCA, or a PPA

SYNOPSIS

       pull-pkg [options] <package name> [release|version]

DESCRIPTION

       pull-pkg  downloads  the  specified  version  of <package name>, or the latest version from the specified
       release.  To request a version from a particular pocket say release-pocket (with  a  magic  -release  for
       only the release pocket).  If no pocket is specified, all pockets will be searched except -backports.  If
       no version or release is specified, the latest version in the development release will be downloaded.

       There  are  convenience  scripts  that  set  pull  type  and  distribution   appropriately:   these   are
       pull-lp-source,   pull-lp-debs,  pull-lp-ddebs,  and  pull-lp-udebs,  which  all  pull  Ubuntu  packages;
       pull-debian-source, pull-debian-debs, pull-debian-ddebs, and pull-debian-udebs,  which  all  pull  Debian
       packages; pull-uca-source, pull-uca-debs, pull-uca-ddebs, and pull-uca-udebs, which all pull Ubuntu Cloud
       Archive packages; and pull-ppa-source, pull-ppa-debs, pull-ppa-ddebs, and pull-ppa-udebs, which all  pull
       from  a  specified  Personal  Package Archive on Launchpad.  Each script pulls the file type in its name,
       i.e.  source, debs, ddebs, or udebs.

OPTIONS

       Listed below are the command line options for pull-pkg:

       package name
              This is name of the package to downloaded.  You can use either the source package name, or  binary
              package name.

       version
              This is the version of the package to downloaded.

       release
              This  is  the  release  to  downloaded from.  For debian, you can use either the release name like
              jessie or sid, or you can use the special release names unstable, stable, or testing.  For ubuntu,
              you  can  use either the release name like xenial or the release-pocket like xenial-proposed.  For
              ubuntu cloud archive (uca) you can use either the uca release name like mitaka or the  ubuntu  and
              uca release names like trusty-mitaka.  Defaults to the current development release.

       -h, --help
              Display a help message and exit.

       -v, --verbose
              Be verbose about what is being done.

       -d, --download-only
              Do not extract the source package (applies only to source packages).

       -m MIRROR, --mirror=MIRROR
              Use  the  specified  mirror  server.   Should  be  in the form http://archive.ubuntu.com/ubuntu or
              http://deb.debian.org/debian.  If not specified or if the package is not found  on  the  specified
              mirror,  this will fall back to the default mirror(s) and/or mirror(s) from environment variables,
              and then will fall back to Launchpad or Debian Snapshot.  This can be specified multiple times  to
              try multiple mirrors.

       --no-conf
              Do not use mirrors from the default configuration, or from any environment variables.

       -a ARCH, --arch=ARCH
              Get  binary packages from the ARCH architecture.  Defaults to the local architecture, if it can be
              deteected.

       -p PULL, --pull=PULL
              What to pull: source, debs, ddebs, udebs, or list.  The list action only  lists  all  a  package's
              source and binary files, but does not actually download any.  Defaults to source.

       -D DISTRO, --distro=DISTRO
              Pull  from:  debian,  uca,  ubuntu,  or  a  ppa.   lp  can  be used instead of ubuntu.  Any string
              containing cloud can be used instead of uca.  If pulling from a ppa, you  must  specify  the  PPA.
              Defaults to ubuntu.

       --ppa=ppa:USER/NAME
              Applies only when distro is ppa.  Can be provided either as a value to the --ppa option parameter,
              or as a plain option (like release or version).  When specified as a plain option, the  form  must
              be  ppa:USER/NAME;  when  specified  as a value to the --ppa option parameter, the leading ppa: is
              optional.

ENVIRONMENT

       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.

       UBUNTUTOOLS_UBUNTU_MIRROR
              The default mirror.

       PULL_PKG_UBUNTU_MIRROR
              The default mirror when using the pull-pkg script.

       PULL_[LP|DEBIAN|PPA|UCA]_[SOURCE|DEBS|DDEBS|UDEBS]_MIRROR
              The default mirror when using the associated script.

SEE ALSO

       dget(1), pull-lp-source(1), pull-lp-debs(1), pull-lp-ddebs(1),  pull-lp-udebs(1),  pull-debian-source(1),
       pull-debian-debs(1),  pull-debian-ddebs(1),  pull-debian-udebs(1),  pull-ppa-source(1), pull-ppa-debs(1),
       pull-ppa-ddebs(1),   pull-ppa-udebs(1),    pull-uca-source(1),    pull-uca-debs(1),    pull-uca-ddebs(1),
       pull-uca-udebs(1), pull-debian-debdiff(1), ubuntu-dev-tools(5)

AUTHOR

       pull-pkg  was written by Dan Streetman <ddstreet@canonical.com>, based on the original pull-lp-source; it
       and this manual page were written by Iain Lane <iain@orangesquash.org.uk>.  All are  released  under  the
       GNU General Public License, version 3 or later.