dl-ubuntu-test-iso

Langue: en

Autres versions - même langue

Version: 336634 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

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)