NAME
dl-ubuntu-test-iso - downloads ISOs for testing
SYNOPSIS
dl-ubuntu-test-iso [OPTIONS]
DESCRIPTION
dl-ubuntu-test-iso is a small script to download Ubuntu (+ Kubuntu,
Xubuntu, etc) ISO images for testing purposes. It may or may not be
useful to people outside the QA team. It is _NOT_ meant for downloading
released ISO images. If you don’t participate in testing, you shouldn’t
run this script.
The script uses rsync, which means that the second time you run it, it
only downloads the changes to each ISO.
The ISO image files will be put into ~/iso (an "iso" directory in your
home directory).
You can put a configuration file (~/.dl-ubuntu-test-iso) and set some
variables to limit what will be downloaded.
* ARCHS: what architectures to download
* FLAVORS: what flavors of Ubuntu? Ubuntu itself, Kubuntu, etc
* VARIANTS: for each flavor, what variants? desktop (= live cd)?
alternate cd?
* OPTS: options for rsync
You can get sample configuration files at
/usr/share/doc/ubuntu-qa-tools/examples/
The script should honor http_proxy settings, with the exception of
rsync if the rsync mechanism is used.
OPTIONS
Listed below are the command line options for dl-ubuntu-test-iso:
-h or --help
Display a help message and exit.
-n or --no-act
Do everything, except don’t actually run rsync. You can use this
to test configuration settings, etc.
--debug
Similar to --no-act, but echos the actual rsync commands, as you
might expect, this is useful for debugging the script or
configurations
-P Run rsync with the -P option, to get progress reporting.
--only <flavor> or --flavor <flavor>
Only download a specific flavor of Ubuntu. Only the last --only
option applies. (You can also set FLAVORS in the configuration
file.) --only should probably be considered deprecated.
--exclude <flavor>
Do not download a specific flavor of Ubuntu. You can use this
option multiple times, and none of the specified flavors will be
downloaded. (You can also set EXCLUDE in the configuration
file.)
--release release
Only download a specific release target of Ubuntu. Only the last
--release option applies. (You can also set RELEASES in the
configuration file.) "hardy" is the earliest release target
--variant variant
Only download a specific variant of Ubuntu (e.g. dekstop,
alternate, server, dvd). The --variant option can be given
multiple times to specify than one variant.
--arch arch
Only download a specific architecture of Ubuntu (e.g. i386,
amd64). The --arch option can be given multiple times to request
more than one arch.
--bwlimit=KBPS
This option allows you to specify a maximum transfer rate in
kilobytes per second; equivalent to adding the same argument to
the OPTS variable to be passed on to rsync(1). Note that zsync
does not support bandwidth limiting.
--no-verify
This option tells the script to skip the hash comparison check
against the MD5SUMS file that is normally done by default.
--no-zsync
By default, the script will attempt to use zsync if it is
available as it uses fewer resources on the cdimage server.
However, because it does not do rate-limiting and has other
limitations, using only rsync may be preferred.
--isoroot directory
The local path underneath which the downloaded isos should be
stored. The default is ${HOME}/iso.
--config config
Specify an alternate location for the config file; the default
is ${HOME}/.dl-ubuntu-test-iso.
--host hostname
The mirror to pull the cdimages from. The default is
cdimages.ubuntu.com.
--user username
If http_auth is used on the cdimage server, specify the username
with the --user argument. You can also set USERNAME in the
config file.
--pass password
If http_auth is used on the cdimage server, specify the password
with the --pass argument. You can also set PASSWORD in the
config file; note however that zsync does not support reading
from a configuration file and thus any specified password will
appear on zsync’s command line and be visible in process
listings.
--mirror
If set, the script will attempt to mimic the layout of the
cdimage server. This is useful for republishing the isos in an
alternate mirror.
--no-release-check
By default, the script will query launchpad.net to see if the
development version of ubuntu has changed (e.g. lucid ->
maverick) and attempt to take the change into account. Adding
this argument disables the check.
--build builddate
Tell the script to downoad a specific build date rather than the
current iso; default is "current"
--versions
Report the version information contained within all of the isos
in the ${HOME}/iso/ subdirectories, including the build number.
(requires the isoinfo binary to be installed)
AUTHORS
dl-ubuntu-test-iso was written by Dave Morlay <davmor2@ubuntu.com>, and
then rewritten by Lars Wirzenius <lars@ubuntu.com> and Steve Beattie
<sbeattie@ubuntu.com>
This is released under the terms of the GNU General Public License,
version 3.
SEE ALSO
rsync(1), zsync(1)