NAME¶

Sys::VirtConvert::Config - Manage virt-v2v's configuration file

SYNOPSIS¶

 use Sys::VirtConvert::Config;
 $eh = Sys::VirtConvert::Config->new(@config_paths);
 my $isopath = $config->get_transfer_iso();
 my ($path, $deps) = $config->match_app($g, $root, $name, $arch);
 my ($name, $type) = $config->map_network($oldname, $oldtype);

DESCRIPTION¶

Sys::VirtConvert::Config parses and queries virt-v2v configuration files.

METHODS¶

new(paths)

Create a new Sys::VirtConvert::Config object to operate on the configuration files paths.

get_transfer_iso

Return the path to an iso image containing all software defined in the config file. Returns undef if no transfer iso is required.

get_transfer_path(path)

Return the path to path as accessible by the libguestfs appliance. This function will also ensure that the transfer iso is mounted.

mount_transfer(g)

Mount the transfer iso if it is not already mounted, and return the path where it was mounted.

unmount_transfer(g)

Unmount the transfer iso if it is currently mounted.

match_app

Return a matching app entry from the virt-v2v configuration. The entry is returned as a list containing 2 values. The first contains the path to the application itself. The second contains an arrayref containing the paths of all the app's listed dependencies.

match_capability

Match a capability from the configuration. Returned as a hashref containing dependencies, where each dependency is a hashref containing:

  {capability} ->
    {name} ->       : package name
      {minversion}  : minimum required version
      {ifinstalled} : 1 if the package should be upgraded if necessary, but
                      not installed if it is not already, 0 otherwise
    

Returns undef if the capability was not found.

map_network(oldname, oldtype)

Return a new network name/type for oldname and oldtype from the config. Returns a list of 2 values: (name, type)

set_default_net_mapping(name, type)

Set the default network name and type which will be used if no specific mapping can be found in a config file.

use_profile(name)

Use the profile name defined in the configuration file. Output method and storage will be read from this profile, and any network mappings defined in it will be used in preference to those defined at the top level of the configuration file.

get_method

Return the output method specified in the selected profile.

use_profile must have been called previously.

get_storage

Return the output storage location and a hashref of storage options from the selected profile.

use_profile must have been called previously.

get_storage_opts

Return a hashref of storage options from the selected profile.

use_profile must have been called previously.

list_profiles

Return a list of defined profile names

COPYRIGHT¶

Copyright (C) 2009-2012 Red Hat Inc.

LICENSE¶

Please see the file COPYING.LIB for the full license.

SEE ALSO¶

virt-v2v(1), <http://libguestfs.org/>.