1Sys::Virt::Network(3) User Contributed Perl DocumentationSys::Virt::Network(3)
2
3
4

NAME

6       Sys::Virt::Network - Represent & manage a libvirt virtual network
7

DESCRIPTION

9       The "Sys::Virt::Network" module represents a virtual network managed by
10       the virtual machine monitor.
11

METHODS

13       my $uuid = $net->get_uuid()
14           Returns a 16 byte long string containing the raw globally unique
15           identifier (UUID) for the network.
16
17       my $uuid = $net->get_uuid_string()
18           Returns a printable string representation of the raw UUID, in the
19           format 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'.
20
21       my $name = $net->get_name()
22           Returns a string with a locally unique name of the network
23
24       $net->is_active()
25           Returns a true value if the network is currently running
26
27       $net->is_persistent()
28           Returns a true value if the network has a persistent configuration
29           file defined
30
31       my $xml = $net->get_xml_description()
32           Returns an XML document containing a complete description of the
33           network's configuration
34
35       $net->create()
36           Start a network whose configuration was previously defined using
37           the "define_network" method in Sys::Virt.
38
39       $net->undefine()
40           Remove the configuration associated with a network previously
41           defined with the "define_network" method in Sys::Virt. If the
42           network is running, you probably want to use the "shutdown" or
43           "destroy" methods instead.
44
45       $net->destroy()
46           Immediately terminate the machine, and remove it from the virtual
47           machine monitor. The $net handle is invalid after this call
48           completes and should not be used again.
49
50       $net->get_bridge_name()
51           Return the name of the bridge device associated with the virtual
52           network
53
54       $flag = $net->get_autostart();
55           Return a true value if the virtual network is configured to
56           automatically start upon boot. Return false, otherwise
57
58       $net->set_autostart($flag)
59           Set the state of the autostart flag, which determines whether the
60           virtual network will automatically start upon boot of the host OS.
61

AUTHORS

63       Daniel P. Berrange <berrange@redhat.com>
64

66       Copyright (C) 2006 Red Hat Copyright (C) 2006-2007 Daniel P. Berrange
67

LICENSE

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

SEE ALSO

76       Sys::Virt, Sys::Virt::Error, "http://libvirt.org"
77
78
79
80perl v5.12.3                      2010-05-19             Sys::Virt::Network(3)
Impressum