NAME

VirtualBox::Manage -- an API for managing VirtualBox VMs

VERSION

This documentation refers to VirtualBox::Manage version 0.0.0.

SYNOPSIS

use VirtualBox::Manage;
use Moose::Autobox;
my $vb = VirtualBox::Manage->new(config => 'VirtualBox.xml', prefix => '/usr/local/bin');
for my $vm ( $vb->machines->keys ) {
    print $vm->name, "\n";
}

DESCRIPTION

VirtualBox::Manage provides a Perl interface to the VirtualBox virtualization software. Currently very little is supported, but this will be changing in the future. The aim is to provide a full programmatic interface to the VirtualBox commandline tools for the purpose of automating virtual machine management.

ATTRIBUTES

config

Read-only attribute denoting the XML configuration file for VirtualBox.

machines

Hashref representing a collection of machines. Keys are machine names, values are VirtualBox::Machine objects.

prefix

The prefix under which VirtualBox is installed, with the trailing directory separator.

METHODS

read_config

Reads the configuration file passed into the constructor and instantiates the machine objects listed therein.

DEVELOPMENT

If interested in tracking the development of this package, check out its Gitorious page: http://gitorious.org/projects/virtualbox_manage

AUTHOR

Christopher Nehren <apeiron@cpan.org>

LICENSE AND COPYRIGHT

Copyright (c) 2008 Christopher Nehren (<apeiron@cpan.org>). All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic and perlgpl.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.