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, and the sync request bug is filed in launchpad.
Alternatively, the sync request can be filed by GPG-signed email (option
--email).
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
(not email submission). 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.
If you have permission to upload the package directly, then you may prefer to
use
syncpackage instead to copy the package using the Launchpad API. At
some future point,
requestsync will be changed to do this
automatically.
requestsync uses launchpadlib authentication to file its requests.
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 testing in LTS cycles, otherwise
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. This is only used if the sync
request is mailed to Launchpad.
- --email
- Use GPG-signed email to file the bug, rather than
launchpadlib.
- -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.
- -C
- Allow changelog to be manually filled in when missing.
requestsync gets Debian changelogs from packages.debian.org, which
isn't in sync with the Debian archive. To request a sync before the
changelog is available, pass this option, and provide the changelog
entries yourself.
- -e
- Use this flag after FeatureFreeze for non-bug fix syncs.
requestsync will subscribe ubuntu-release team instead of
sponsorship team.
- -l INSTANCE,
--lpinstance=INSTANCE
- Use the specified instance of Launchpad (e.g.
"staging"), instead of the default of
"production".
- --no-conf
- Do not read any configuration files, or configuration from
environment variables.
- <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¶
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:
- UBUMAIL, DEBEMAIL
- Specifies which email should be used when sending to
Launchpad.
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¶
- REQUESTSYNC_SMTP_SERVER
- Set which SMTP server to use when sending mail. If
unspecified this defaults to launchpad's SMTP servers (the eventual
destination).
- REQUESTSYNC_SMTP_PORT
- Sets which port of the SMTP server to use. Default is
25.
- REQUESTSYNC_SMTP_USER and
REQUESTSYNC_SMTP_PASS
- Sets the username and password to use when authenticating
to the SMTP server.
- REQUESTSYNC_USE_LPAPI
- Setting this to no is equivalent to running with
--email.
- REQUESTSYNC_LPINSTANCE,
UBUNTUTOOLS_LPINSTANCE
- The default value for --lpinstance.
- REQUESTSYNC_KEYID, UBUNTUTOOLS_KEYID
- The default value for -k.
SEE ALSO¶
rmadison(1),
syncpackage(1),
ubuntu-dev-tools(5)
AUTHOR¶
requestsync and this manual page were written by the Ubuntu MOTU Team.
Both are released under the GNU General Public License, version 2.