mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2025-02-22 11:22:23 +00:00
Document overriding domain interface target
* docs/formatdomain.html.in: document that vnet and vif are reserved names and will be ignored if manually specified.
This commit is contained in:
parent
c7e1cfc9f4
commit
eb81396863
@ -484,7 +484,8 @@
|
||||
of the box which does NAT'ing to the default route and has an IP range of
|
||||
<code>192.168.22.0/255.255.255.0</code>. Each guest will have an
|
||||
associated tun device created with a name of vnetN, which can also be
|
||||
overridden with the <target> element.
|
||||
overridden with the <target> element (see
|
||||
<a href="#elementsNICSTargetOverride">overriding the target element</a>).
|
||||
</p>
|
||||
|
||||
<pre>
|
||||
@ -514,10 +515,11 @@
|
||||
there is a bridge device on the host which has one or more of the hosts
|
||||
physical NICs enslaved. The guest VM will have an associated tun device
|
||||
created with a name of vnetN, which can also be overridden with the
|
||||
<target> element. The tun device will be enslaved to the bridge.
|
||||
The IP range / network configuration is whatever is used on the LAN. This
|
||||
provides the guest VM full incoming & outgoing net access just like a
|
||||
physical machine.
|
||||
<target> element (see
|
||||
<a href="#elementsNICSTargetOverride">overriding the target element</a>).
|
||||
The tun device will be enslaved to the bridge. The IP range / network
|
||||
configuration is whatever is used on the LAN. This provides the guest VM
|
||||
full incoming & outgoing net access just like a physical machine.
|
||||
</p>
|
||||
|
||||
<pre>
|
||||
@ -652,6 +654,25 @@ qemu-kvm -net nic,model=? /dev/null
|
||||
ne2k_isa i82551 i82557b i82559er ne2k_pci pcnet rtl8139 e1000 virtio
|
||||
</p>
|
||||
|
||||
<h5><a name="elementsNICSTargetOverride">Overriding the target element</a></h5>
|
||||
|
||||
<pre>
|
||||
...
|
||||
<interface type='network'>
|
||||
<source network='default'/>
|
||||
<b><target dev='vnet1'/></b>
|
||||
</interface>
|
||||
...</pre>
|
||||
|
||||
<p>
|
||||
If no target is specified, certain hypervisors will automatically
|
||||
generate a name for the created tun device. This name can be manually
|
||||
specifed, however the name <i>must not start with either 'vnet' or
|
||||
'vif'</i>, which are prefixes reserved by libvirt and certain
|
||||
hypervisors. Manually specified targets using these prefixes will be
|
||||
ignored.
|
||||
</p>
|
||||
|
||||
<h4><a name="elementsInput">Input devices</a></h4>
|
||||
|
||||
<p>
|
||||
|
Loading…
x
Reference in New Issue
Block a user