org.libvirt

Class Network

public class Network extends Object

A network object defined by libvirt.

Field Summary
protected Libvirt	libvirt The libvirt connection from the hypervisor
protected Connect	virConnect The Connect Object that represents the Hypervisor of this Network

Method Summary
void	create() Creates and starts this defined network.
void	destroy() Destroy this network object.
int	free() Frees this network object.
boolean	getAutostart() Provides a boolean value indicating whether this network is configured to be automatically started when the host machine boots.
String	getBridgeName() Provides a bridge interface name to which a domain may connect a network interface in order to join this network.
Connect	getConnect() Provides the connection pointer associated with this network.
String	getName() Gets the public name for this network
int[]	getUUID() Gets the UUID for this network
String	getUUIDString() Gets the UUID for a network as string.
String	getXMLDesc(int flags) Provides an XML description of this network.
int	isActive() Determine if the network is currently running
int	isPersistent() Determine if the network has a persistent configuration which means it will still exist after shutting down
protected void	processError()
void	setAutostart(boolean autostart) Configures this network to be automatically started when the host machine boots.
void	undefine() Undefines this network but does not stop it if it is running

Field Detail

libvirt

protected Libvirt libvirt

The libvirt connection from the hypervisor

virConnect

protected Connect virConnect

The Connect Object that represents the Hypervisor of this Network

Method Detail

create

public void create()

Creates and starts this defined network. If the call succeeds the network moves from the defined to the running networks pools.

Throws: LibvirtException

Destroy this network object. The running instance is shutdown if not down already and all resources used by it are given back to the hypervisor. The object becomes invalid and should not be used thereafter if the call does not return an error. This function may require priviledged access

Throws: LibvirtException

free

public int free()

Frees this network object. The running instance is kept alive. The object becomes invalid and should not be used thereafter if the call does not return an error.

Returns: number of references left (>= 0) for success, -1 for failure.

Throws: LibvirtException