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.