NAME

Sys::Virt::Interface - Represent & manage a libvirt host network interface

DESCRIPTION

The Sys::Virt::Interface module represents a host network interface allowing configuration of IP addresses, bonding, vlans and bridges.

METHODS

my $name = $iface->get_name(): Returns a string with a locally unique name of the network
$iface->is_active(): Returns a true value if the interface is currently running
my $name = $iface->get_mac(): Returns a string with the hardware MAC address of the interface
my $xml = $iface->get_xml_description(): Returns an XML document containing a complete description of the network's configuration
$iface->create(): Start a network whose configuration was previously defined using the define_network method in Sys::Virt.
$iface->undefine(): Remove the configuration associated with a network previously defined with the define_network method in Sys::Virt. If the network is running, you probably want to use the shutdown or destroy methods instead.
$iface->destroy(): Immediately terminate the machine, and remove it from the virtual machine monitor. The $iface handle is invalid after this call completes and should not be used again.

AUTHORS

Daniel P. Berrange <berrange@redhat.com>

COPYRIGHT

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of either the GNU General Public License as published by the Free Software Foundation (either version 2 of the License, or at your option any later version), or, the Artistic License, as specified in the Perl README file.