mirror of
https://git.launchpad.net/ubuntu-dev-tools
synced 2025-03-13 16:11:15 +00:00
fdb2e2d4d6
pull-debian-source: Change default release to pull from to 'testing' and also update the manpage about it
113 lines
4.0 KiB
Groff
113 lines
4.0 KiB
Groff
.TH REQUESTSYNC "1" "19 January 2008" "ubuntu-dev-tools"
|
|
.SH NAME
|
|
requestsync \- helper to file sync requests for Ubuntu
|
|
.SH SYNOPSIS
|
|
.B requestsync\fR [\fB\-d distro\fR] [\fB\-nse\fR] [\fB\-k \fIkeyid\fR] <\fBsource package\fR> [\fBtarget release\fR] [\fIbase version\fR]
|
|
.br
|
|
.B requestsync \-\-lp\fR [\fB\-nse\fR] <\fBsource package\fR> <\fBtarget release\fR> [\fIbase version\fR]
|
|
.br
|
|
.B requestsync \-h
|
|
.SH DESCRIPTION
|
|
\fBrequestsync\fR looks at the versions of <source package> in Debian and
|
|
Ubuntu and prompts for an explanation of why the Ubuntu changes (if there
|
|
are any) should be dropped.
|
|
The changelog entry is then downloaded from packages.debian.org.
|
|
If the sync request is being filed per email (default), a prompt for your
|
|
GPG passphrase follows so that it can sign the mail and send it off to
|
|
Launchpad.
|
|
Alternatively a sync request can be filed directly using the launchpadlib
|
|
Python module (option \fB\-\-lp\fR).
|
|
\fBrequestsync\fR falls back to mail the sync request if submitting using
|
|
the launchpadlib module fails.
|
|
|
|
.PP
|
|
\fBrequestsync\fR checks if you have the permissions to request the sync from
|
|
the archive administrators directly by checking if you are a member of the
|
|
\fI~ubuntu\-dev\fR team (for universe/multiverse syncs) or a member of the
|
|
\fI~ubuntu\-core\-dev\fR team (for main/restricted syncs) on Launchpad.
|
|
If you are not a member of the appropriate team, the script will subscribe
|
|
the necessary team with approval rights to the bug report for you.
|
|
|
|
.PP
|
|
\fBrequestsync\fR uses launchpadlib authentication to file its requests. Please
|
|
see manage-credentials(1) for more information.
|
|
|
|
.SH OPTIONS
|
|
Listed below are the command line options for requestsync:
|
|
.TP
|
|
.B \-h
|
|
Display a help message and exit.
|
|
.TP
|
|
.B \-d
|
|
Specifies which Debian distribution a package should be synced from.
|
|
Default is \fItesting\fR.
|
|
.TP
|
|
.B \-n
|
|
Specifies that the package is a new package, and requestsync should not
|
|
attempt to look it up in Ubuntu since it will not exist.
|
|
.TP
|
|
.B \-k \fI<keyid>\fR
|
|
Specifies your GPG key.
|
|
Can also be set with the line `\fIexport GPGKEY=<keyid>\fR' in your shell's
|
|
configuration (for example: \fI$HOME/.bashrc\fR).
|
|
This is only used if the sync request is mailed to Launchpad.
|
|
.TP
|
|
.B \-\-lp
|
|
Use the launchpadlib Python module (packaged as python\-launchpadlib) to
|
|
file the sync request in Launchpad.
|
|
.TP
|
|
.B \-s
|
|
Specifies that you require sponsorship.
|
|
You need this option if you are not a member of ubuntu-dev for universe or
|
|
multiverse, or ubuntu-core-dev for main or restricted. This shall disable the
|
|
Launchpad team membership checking described above.
|
|
.TP
|
|
.B \-e
|
|
Use this flag after FeatureFreeze for non-bug fix syncs. \fBrequestsync\fR will
|
|
subscribe ubuntu-release team (for main/restricted packages) or motu-release
|
|
team (for universe/multiverse packages) instead of sponsorship team.
|
|
.TP
|
|
.B <source package>
|
|
This is the source package that you would like to be synced from Debian.
|
|
.TP
|
|
.B <target release>
|
|
This is the release that you would like the source package to be synced
|
|
into.
|
|
This should always be the latest development release of Ubuntu.
|
|
.TP
|
|
.B [base version]
|
|
In some cases, the base version (where the Ubuntu package started differing
|
|
from the Debian package) cannot be automatically determined.
|
|
Specify this option in this case.
|
|
|
|
.SH ENVIRONMENT VARIABLES
|
|
\fBrequestsync\fR uses the following variables which should be set in your
|
|
shell's configuration by adding \fIexport VARIABLE=\fR lines, where VARIABLE is
|
|
one of the following:
|
|
|
|
.TP
|
|
.B GPGKEY
|
|
Specifies your GnuPG key ID.
|
|
.TP
|
|
.B DEBEMAIL
|
|
Specifies which email should be used when sending to Launchpad.
|
|
.TP
|
|
.B DEBSMTP
|
|
Set which SMTP server to use when sending mail.
|
|
If unspecified this defaults to fiordland.ubuntu.com.
|
|
.TP
|
|
.B DEBSMTP_PORT
|
|
Sets which port of the SMTP server to use. Default is 25.
|
|
.TP
|
|
.B DEBSMTP_USER and DEBSMTP_PASS
|
|
Sets the username and password to use when authenticating to the SMTP server.
|
|
|
|
.SH SEE ALSO
|
|
.BR rmadison (1)
|
|
|
|
.SH AUTHOR
|
|
.B requestsync
|
|
and this manual page were written by the Ubuntu MOTU Team.
|
|
.PP
|
|
Both are released under the GNU General Public License, version 2.
|