mirror of
https://git.launchpad.net/ubuntu-dev-tools
synced 2025-03-13 08:01:09 +00:00
90 lines
3.1 KiB
Groff
90 lines
3.1 KiB
Groff
.\" Copyright (C) 2010-2011, Stefano Rivera <stefanor@ubuntu.com>
|
|
.\"
|
|
.\" Permission to use, copy, modify, and/or distribute this software for any
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
|
.\" copyright notice and this permission notice appear in all copies.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
|
|
.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
.\" AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
|
|
.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
|
.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
|
|
.\" OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
.\" PERFORMANCE OF THIS SOFTWARE.
|
|
.TH PULL\-DEBIAN\-SOURCE "1" "22 January 2011" "ubuntu\-dev\-tools"
|
|
|
|
.SH NAME
|
|
pull\-debian\-source \- download and extract a source package from Debian
|
|
|
|
.SH SYNOPSIS
|
|
.B pull\-debian\-source \fR[\fIoptions\fR] <\fIsource package\fR>
|
|
[\fIrelease\fR|\fIversion\fR]
|
|
|
|
.SH DESCRIPTION
|
|
\fBpull\-debian\-source\fR downloads and extracts the specified
|
|
\fIversion\fR of \fIsource package\fR, or the latest version in the
|
|
specified Debian \fIrelease\fR.
|
|
.P
|
|
\fBpull\-debian\-source\fR will try the preferred mirror, default
|
|
mirror, security mirror, and fall back to \fBLaunchpad\fR or
|
|
\fBsnapshot.debian.org\fR, in search of the requested version.
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.I source package
|
|
The source package to download from Debian.
|
|
.TP
|
|
.I release
|
|
The release to download the source package from. Defaults to
|
|
\fBunstable\fR.
|
|
.TP
|
|
.I version
|
|
The specific version of the package to download.
|
|
.TP
|
|
.BR \-d ", " \-\-download\-only
|
|
Do not extract the source package.
|
|
.TP
|
|
.B \-m \fIDEBIAN_MIRROR\fR, \fB\-\-mirror\fR=\fIDEBIAN_MIRROR\fR
|
|
Use the specified mirror.
|
|
Should be in the form \fBhttp://ftp.debian.org/debian\fR.
|
|
If the package isn't found on this mirror, \fBpull\-debian\-source\fR
|
|
will fall back to the default mirror.
|
|
.TP
|
|
.B \-s \fIDEBSEC_MIRROR\fR, \fB\-\-security\-mirror\fR=\fIDEBSEC_MIRROR\fR
|
|
Use the specified mirror.
|
|
Should be in the form \fBhttp://security.debian.org\fR.
|
|
If the package isn't found on this mirror, \fBpull\-debian\-source\fR
|
|
will fall back to the default mirror.
|
|
.TP
|
|
.B \-\-no\-conf
|
|
Do not read any configuration files, or configuration from environment
|
|
variables.
|
|
.TP
|
|
.BR \-h ", " \-\-help
|
|
Display the usage instructions and exit.
|
|
|
|
.SH ENVIRONMENT
|
|
All of the \fBCONFIGURATION VARIABLES\fR below are also supported as
|
|
environment variables.
|
|
Variables in the environment take precedence to those in configuration
|
|
files.
|
|
|
|
.SH CONFIGURATION VARIABLES
|
|
The following variables can be set in the environment or in
|
|
.BR ubuntu\-dev\-tools (5)
|
|
configuration files.
|
|
In each case, the script\-specific variable takes precedence over the
|
|
package\-wide variable.
|
|
.TP
|
|
.BR PULL_DEBIAN_SOURCE_DEBIAN_MIRROR ", " UBUNTUTOOLS_DEBIAN_MIRROR
|
|
The default value for \fB\-\-mirror\fR.
|
|
.TP
|
|
.BR PULL_DEBIAN_SOURCE_DEBSEC_MIRROR ", " UBUNTUTOOLS_DEBSEC_MIRROR
|
|
The default value for \fB\-\-security\-mirror\fR.
|
|
|
|
.SH SEE ALSO
|
|
.BR dget (1),
|
|
.BR pull\-debian\-debdiff (1),
|
|
.BR pull\-lp\-source (1),
|
|
.BR ubuntu\-dev\-tools (5)
|