Provided by: xen-tools_0.8.5-1_all bug

NAME

       xen-list-images - List all the created and configured Xen images.

SYNOPSIS

         xen-list-image [options]

         Help Options:
          --help     Show this scripts help information.
          --manual   Read this scripts manual.
          --version  Show the version number and exit.

         General Options:
          --dir      Specify where the output images are located.

         Testing options:
          --test     List an image even if there is no configuration file in /etc/xen

OPTIONS

       --dir Specify the output directory where images were saved.
       --help Show the scripts help information.
       --manual Read the manual.
       --test This flag causes an image to be listed even if the configuration
       file in /etc/xen doesn’t exist.  It is soley used for the test script.
       --version Show the version number and exit.

DESCRIPTION

         xen-list-images is a simple script which will display all the
        images which have been created in a given directory.

         The script follows the same pattern as the other scripts, it
        assumes that all images are stored beneath a prefix directory
        in a layout such as this:

          $dir/domains/vm01.my.flat/
          $dir/domains/vm01.my.flat/disk.img
          $dir/domains/vm01.my.flat/swap.img

          $dir/domains/vm02.my.flat/
          $dir/domains/vm02.my.flat/disk.img
          $dir/domains/vm02.my.flat/swap.img

         For each subdirectory found beneath $dir/domains the image will
        be tested if:

          1.  The disk.img file exists.
          2.  The swap.img file exists.
          3.  A configuration file /etc/xen/$name.cfg exists.

         If these conditions are met the name will be output, along with
        networking information.

       NOTES

         If the script is run by a non-root user the networking information
        will not be displayed.  This is because a non-user may not mount
        the disk images to read the configuration.

         If you wish to see the networking details you must execute this
        script as root.

AUTHOR

        Steve
        --
        http://www.steve.org.uk/

        $Id: xen-list-images,v 1.13 2006/01/07 23:23:12 steve Exp $

LICENSE

       Copyright (c) 2005 by Steve Kemp.  All rights reserved.

       This module is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.  The LICENSE file contains the
       full text of the license.

       readConfigurationFile

         Read the configuration file specified.

       parseCommandLineArguments

         Parse the arguments specified upon the command line.

       showNetworkingDetails

         Mount the given disk image and read the networking details from it.