Product SiteDocumentation Site

2.62. net-info

Displays basic information for a virtual network.
Usage
net-info --network network-identifier
Options
Table 2.8. Options
Name Required? Description
--network network-identifier
required
The name or UUID of the virtual network to display information for.
The word "--network" itself is optional.

Availability
Available from libvirt 0.8.6 onwards
Platform or Hypervisor specific notes
None yet
Examples
virsh # net-info default
Name            default
UUID            1c42888c-82c9-4dda-bc9c-4387962a0c0e
Active:         yes
Persistent:     yes
Autostart:      yes
Bridge: virbr0
Displays basic information for the virtual network named "default".
If the host server is running Linux, then the Bridge field gives the name of the Linux network bridge being for the virtual network.
virsh # net-info --network default
Name            default
UUID            1c42888c-82c9-4dda-bc9c-4387962a0c0e
Active:         yes
Persistent:     yes
Autostart:      yes
Bridge:         virbr0
Same as the above example.
Example in context
We begin with an existing virtual network, running on the host:
virsh # net-list --all
Name                 State      Autostart
-----------------------------------------
default              active     yes
The virtual network "default" is active and enabled for automatic starting.
We use the net-info command to display further details:
# net-info default
Name            default
UUID            1c42888c-82c9-4dda-bc9c-4387962a0c0e
Active:         yes
Persistent:     yes
Autostart:      yes
Bridge:         virbr0
Some of the same information can also be retrieved using the net-dumpxml command, then looking through the output:
virsh # net-dumpxml default
<network>
  <name>default</name>
  <uuid>1c42888c-82c9-4dda-bc9c-4387962a0c0e</uuid>
  <forward mode='nat'/>
  <bridge name='virbr0' stp='on' delay='0' />
  <ip address='192.168.122.1' netmask='255.255.255.0'>
    <dhcp>
      <range start='192.168.122.2' end='192.168.122.254' />
    </dhcp>
  </ip>
</network>
See also
  • net-dumpxml - Outputs the XML configuration for a virtual network, to stdout
  • net-list - Lists the virtual networks libvirt is aware of