Documentation for NIC model selection.

	* docs/formatdomain.html.in, docs/formatdomain.html: Add the
	documentation for NIC model selection.

diff --git a/ChangeLog b/ChangeLog
index c02429ba0bb5c78be2d84538a0f7d71419b02970..44240efbeb9ae7252fa9ae6c2da0d49c9ddd2c8f 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+Mon Oct 13 16:24:00 BST 2008 Richard W.M. Jones <rjones@redhat.com>
+
+       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 <rjones@redhat.com>
 
        Build failure fixed.

diff --git a/docs/formatdomain.html b/docs/formatdomain.html
index 7b39c8fe5699814bbc062595f8f065c3125902cc..05e056c57b9284d1c42d864fdd27ddfee05a16a2 100644 (file)
--- a/docs/formatdomain.html
+++ b/docs/formatdomain.html
@@ -155,6 +155,8 @@
                         <a href="#elementsNICSMulticast">Multicast tunnel</a>
                       </li><li>
                         <a href="#elementsNICSTCP">TCP tunnel</a>
+                      </li><li>
+                        <a href="#elementsNICSModel">Setting the NIC model</a>
                       </li></ul>
                   </li><li>
                     <a href="#elementsInput">Input devices</a>
@@ -648,6 +650,35 @@
       &lt;source address='192.168.0.1' port='5558'/&gt;
       &lt;/interface&gt;
       ...</pre>
+        <h5>
+          <a name="elementsNICSModel" id="elementsNICSModel">Setting the NIC model</a>
+        </h5>
+        <pre>
+      ...
+      &lt;interface type='network'&gt;
+        &lt;source network='default'/&gt;
+        &lt;target dev='vnet1'/&gt;
+        <b>&lt;model type='ne2k_pci'/&gt;</b>
+      &lt;/interface&gt;
+      ...</pre>
+        <p>
+      For hypervisors which support this, you can set the model of
+      emulated network interface card.
+    </p>
+        <p>
+      The values for <code>type</code> 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:
+    </p>
+        <pre>
+qemu -net nic,model=? /dev/null
+qemu-kvm -net nic,model=? /dev/null
+</pre>
+        <p>
+      Typical values for QEMU and KVM include:
+      ne2k_isa i82551 i82557b i82559er ne2k_pci pcnet rtl8139 e1000 virtio
+    </p>
         <h4>
           <a name="elementsInput" id="elementsInput">Input devices</a>
         </h4>

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 28b432f39422f494c8a3b94e4284a3464ee5cd12..2482f4bf8ae43a5099304f3b061383c6e8307afb 100644 (file)
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -581,6 +581,38 @@
       </interface>
       ...</pre>
 
+    <h5><a name="elementsNICSModel">Setting the NIC model</a></h5>
+
+    <pre>
+      ...
+      &lt;interface type='network'&gt;
+        &lt;source network='default'/&gt;
+        &lt;target dev='vnet1'/&gt;
+        <b>&lt;model type='ne2k_pci'/&gt;</b>
+      &lt;/interface&gt;
+      ...</pre>
+
+    <p>
+      For hypervisors which support this, you can set the model of
+      emulated network interface card.
+    </p>
+
+    <p>
+      The values for <code>type</code> 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:
+    </p>
+
+<pre>
+qemu -net nic,model=? /dev/null
+qemu-kvm -net nic,model=? /dev/null
+</pre>
+
+    <p>
+      Typical values for QEMU and KVM include:
+      ne2k_isa i82551 i82557b i82559er ne2k_pci pcnet rtl8139 e1000 virtio
+    </p>
 
     <h4><a name="elementsInput">Input devices</a></h4>