Chris Nehren > VirtualBox-Manage-0.0.0 > VirtualBox::Manage

Download:
VirtualBox-Manage-0.0.0.tar.gz

Annotate this POD

View/Report Bugs
Source  

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.

syntax highlighting: