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


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


         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


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


         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:



         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.


         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.



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


       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.


         Read the configuration file specified.


         Parse the arguments specified upon the command line.


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