mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-12-22 17:34:18 +03:00
docs: Rewrite documentation for network device models
Since libvirt now tries to interpret network device models (unless an unknow model is used) the documentation didn't make a good job specifying what is supported. Rewrite the docs to explicitly list the models which we do parse. Signed-off-by: Peter Krempa <pkrempa@redhat.com> Reviewed-by: Jonathon Jongsma <jjongsma@redhat.com>
This commit is contained in:
parent
c09f84cb9c
commit
450493e0dd
@ -5598,23 +5598,26 @@ Setting the NIC model
|
|||||||
...
|
...
|
||||||
|
|
||||||
For hypervisors which support this, you can set the model of emulated network
|
For hypervisors which support this, you can set the model of emulated network
|
||||||
interface card.
|
interface card via the ``model`` element.
|
||||||
|
|
||||||
The values for ``type`` aren't defined specifically by libvirt, but by what the
|
While libvirt accepts any value as the ``type`` and passes it to the
|
||||||
underlying hypervisor supports (if any). For QEMU and KVM you can get a list of
|
hypervisor to preserve compatibility, most devices nowadays have additional
|
||||||
supported models with these commands:
|
handling and address allocation which may not work properly unless the model
|
||||||
|
is known by libvirt.
|
||||||
|
|
||||||
|
Libvirt supports natively the following network device models:
|
||||||
|
``virtio``, ``virtio-transitional`` (:since:`Since 5.2.0`),
|
||||||
|
``virtio-non-transitional`` (:since:`Since 5.2.0`), ``e1000``, ``e1000e``,
|
||||||
|
``igb`` (:since:`Since 9.3.0`), ``rtl8139``, ``netfront``,
|
||||||
|
``usb-net`` (:since:`Since 10.3.0`), ``spapr-vlan``, ``lan9118``, ``scm91c111``,
|
||||||
|
``vlance``, ``vmxnet``, ``vmxnet2``, ``vmxnet3``, ``Am79C970A``, ``Am79C973``,
|
||||||
|
``82540EM``, ``82545EM``, ``82543GC``.
|
||||||
|
|
||||||
|
For QEMU you can get a list of supported models with this command:
|
||||||
|
|
||||||
::
|
::
|
||||||
|
|
||||||
qemu -net nic,model=? /dev/null
|
qemu-system-x86_64 -net nic,model=?
|
||||||
qemu-kvm -net nic,model=? /dev/null
|
|
||||||
|
|
||||||
Typical values for QEMU and KVM include: ne2k_isa i82551 i82557b i82559er
|
|
||||||
ne2k_pci pcnet rtl8139 e1000 virtio. :since:`Since 5.2.0`,
|
|
||||||
``virtio-transitional`` and ``virtio-non-transitional`` values are supported.
|
|
||||||
See `Virtio transitional devices`_ for more details.
|
|
||||||
:since:`Since 9.3.0` igb is also supported.
|
|
||||||
:since:`Since 10.3.0` usb-net is supported.
|
|
||||||
|
|
||||||
Setting NIC driver-specific options
|
Setting NIC driver-specific options
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
Loading…
Reference in New Issue
Block a user