VirtualBox::Manage -- an API for managing VirtualBox VMs
This documentation refers to VirtualBox::Manage version 0.0.0.
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"; }
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.
Read-only attribute denoting the XML configuration file for VirtualBox.
Hashref representing a collection of machines. Keys are machine names, values are VirtualBox::Machine objects.
The prefix under which VirtualBox is installed, with the trailing directory separator.
Reads the configuration file passed into the constructor and instantiates the machine objects listed therein.
If interested in tracking the development of this package, check out its Gitorious page: http://gitorious.org/projects/virtualbox_manage
Christopher Nehren <apeiron@cpan.org>
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.
To install VirtualBox::Manage, copy and paste the appropriate command in to your terminal.
cpanm
cpanm VirtualBox::Manage
CPAN shell
perl -MCPAN -e shell install VirtualBox::Manage
For more information on module installation, please visit the detailed CPAN module installation guide.