From 72523d7bc2db31d70617b8953fe7614aa6abc4f8 Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Mon, 13 Oct 2008 15:25:38 +0000 Subject: [PATCH] Documentation for NIC model selection. * docs/formatdomain.html.in, docs/formatdomain.html: Add the documentation for NIC model selection. --- ChangeLog | 6 ++++++ docs/formatdomain.html | 31 +++++++++++++++++++++++++++++++ docs/formatdomain.html.in | 32 ++++++++++++++++++++++++++++++++ 3 files changed, 69 insertions(+) diff --git a/ChangeLog b/ChangeLog index c02429ba0b..44240efbeb 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +Mon Oct 13 16:24:00 BST 2008 Richard W.M. Jones + + Documentation for NIC model selection. + * docs/formatdomain.html.in, docs/formatdomain.html: Add the + documentation for NIC model selection. + Mon Oct 13 16:22:00 BST 2008 Richard W.M. Jones Build failure fixed. diff --git a/docs/formatdomain.html b/docs/formatdomain.html index 7b39c8fe56..05e056c57b 100644 --- a/docs/formatdomain.html +++ b/docs/formatdomain.html @@ -155,6 +155,8 @@ Multicast tunnel
  • TCP tunnel +
  • + Setting the NIC model
  • Input devices @@ -648,6 +650,35 @@ <source address='192.168.0.1' port='5558'/> </interface> ... +
    + Setting the NIC model +
    + 
    +      ...
+      <interface type='network'>
+        <source network='default'/>
+        <target dev='vnet1'/>
+        <model type='ne2k_pci'/>
+      </interface>
+      ...
    +

    + For hypervisors which support this, you can set the model of + emulated network interface card. +

    +

    + The values for type aren't defined specifically by + libvirt, but by what the underlying hypervisor supports (if + any). For QEMU and KVM you can get a list of supported models + with these commands: +

    + 
    +qemu -net nic,model=? /dev/null
+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 +

    Input devices

    diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 28b432f394..2482f4bf8a 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -581,6 +581,38 @@ </interface> ... +
    Setting the NIC model
    + + 
    +      ...
+      <interface type='network'>
+        <source network='default'/>
+        <target dev='vnet1'/>
+        <model type='ne2k_pci'/>
+      </interface>
+      ...
    + +

    + For hypervisors which support this, you can set the model of + emulated network interface card. +

    + +

    + The values for type aren't defined specifically by + libvirt, but by what the underlying hypervisor supports (if + any). For QEMU and KVM you can get a list of supported models + with these commands: +

    + +
    +qemu -net nic,model=? /dev/null
+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 +

    Input devices