Man Linux: Main Page and Category List


       dl-ubuntu-test-iso - downloads ISOs for testing


       dl-ubuntu-test-iso [OPTIONS]


       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

       The  script  should  honor  http_proxy  settings, with the exception of
       rsync if the rsync mechanism is used.


       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.

              Similar to --no-act, but echos the actual rsync commands, as you
              might expect,  this  is  useful  for  debugging  the  script  or

       -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

       --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.

              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.

              This  option  tells the script to skip the hash comparison check
              against the MD5SUMS file that is normally done by default.

              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

       --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

              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.

              By  default,  the  script will query 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"

              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)


       dl-ubuntu-test-iso was written by Dave Morlay <>, and
       then rewritten by Lars Wirzenius <>  and  Steve  Beattie

       This  is  released  under  the terms of the GNU General Public License,
       version 3.


       rsync(1), zsync(1)