NAME
requestsync - helper to file sync requests for Ubuntu
SYNOPSIS
requestsync [-d distro] [-nse] [-k keyid] <source package> [target
release] [base version]
requestsync --lp [-nse] <source package> <target release> [base
version]
requestsync -h
DESCRIPTION
requestsync 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 --lp). requestsync falls back to mail the sync request
if submitting using the launchpadlib module fails.
requestsync checks if you have the permissions to request the sync from
the archive administrators directly by checking if you have upload
permissions for that package through package set permissions or
component permissions. If you don't have upload permissions, the script
will subscribe the necessary team with approval rights to the bug
report for you.
This check is only performed if requestsync is allowed to use the LP
API (option --lp). In the other case requestsync relies on that you
answer the question about upload permissions honestly to determine if a
team with approval rights is to be subscribed to the bug.
requestsync uses launchpadlib authentication to file its requests.
Please see manage-credentials(1) for more information.
OPTIONS
Listed below are the command line options for requestsync:
-h Display a help message and exit.
-d Specifies which Debian distribution a package should be synced
from. Default is unstable.
-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.
-k <keyid>
Specifies your GPG key. Can also be set with the line `export
GPGKEY=<keyid>' in your shell's configuration (for example:
$HOME/.bashrc). This is only used if the sync request is mailed
to Launchpad.
--lp Use the launchpadlib Python module (packaged as
python-launchpadlib) to file the sync request in Launchpad.
-s Specifies that you require sponsorship. You need this option if
you don't have upload permissions for that package. This
disables the upload permissions check described above.
-e Use this flag after FeatureFreeze for non-bug fix syncs.
requestsync will subscribe ubuntu-release team instead of
sponsorship team.
<source package>
This is the source package that you would like to be synced from
Debian.
<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.
[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.
ENVIRONMENT VARIABLES
requestsync uses the following variables which should be set in your
shell's configuration by adding export VARIABLE= lines, where VARIABLE
is one of the following:
GPGKEY Specifies your GnuPG key ID.
DEBEMAIL
Specifies which email should be used when sending to Launchpad.
DEBSMTP
Set which SMTP server to use when sending mail. If unspecified
this defaults to fiordland.ubuntu.com.
DEBSMTP_PORT
Sets which port of the SMTP server to use. Default is 25.
DEBSMTP_USER and DEBSMTP_PASS
Sets the username and password to use when authenticating to the
SMTP server.
SEE ALSO
rmadison(1)
AUTHOR
requestsync and this manual page were written by the Ubuntu MOTU Team.
Both are released under the GNU General Public License, version 2.