Added link to libvirt-qpid on front page, and docs on URI formats for each driver

diff --git a/ChangeLog b/ChangeLog
index e55d862bbb8e8bc592cd932c270715241d84f326..ece493c0bcc167d93cc8f76057b731d7a913b158 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+Tue Jan 27 14:28:16 GMT 2009 Daniel P. Berrange <berrange@redhat.com>
+
+       * docs/index.html.in: Add link to libvirt-qpid & UML driver info
+       * docs/drvopenvz.html.in, docs/drvqemu.html.in, docs/drvtest.html.in,
+       docs/drvuml.html.in docs/drvxen.html.in: Add examples of local and
+       remote URI formats. Also re-generate equiv .html files
+
 Tue Jan 27 13:25:16 +0100 2009 Jim Meyering <meyering@redhat.com>
 
        virterror.c: don't read beyond end of buffer upon OOM

diff --git a/docs/drvopenvz.html b/docs/drvopenvz.html
index aae268974cc492a630872390b75f2a4ad70499a8..6f9170a74b2fa6c54249d6032caa28d7d4709bc6 100644 (file)
--- a/docs/drvopenvz.html
+++ b/docs/drvopenvz.html
@@ -142,6 +142,7 @@
     </p>
         <pre>
     openvz:///system                     (local access)
+    openvz+unix:///system                (local access)
     openvz://example.com/system          (remote access, TLS/x509)
     openvz+tcp://example.com/system      (remote access, SASl/Kerberos)
     openvz+ssh://root@example.com/system (remote access, SSH tunnelled)

diff --git a/docs/drvopenvz.html.in b/docs/drvopenvz.html.in
index e92533676ed3d7f0ffe5bae8030a782913572f14..b2beadb5bca46c315dfb9b9f659df819099ff95a 100644 (file)
--- a/docs/drvopenvz.html.in
+++ b/docs/drvopenvz.html.in
@@ -21,6 +21,7 @@
 
     <pre>
     openvz:///system                     (local access)
+    openvz+unix:///system                (local access)
     openvz://example.com/system          (remote access, TLS/x509)
     openvz+tcp://example.com/system      (remote access, SASl/Kerberos)
     openvz+ssh://root@example.com/system (remote access, SSH tunnelled)

diff --git a/docs/drvqemu.html b/docs/drvqemu.html
index 9384fef4862307390b69d4bf7ba3f2c8b9be57f3..ff8f20dfc272211c94ca2cdf5c9821bb0b29af72 100644 (file)
--- a/docs/drvqemu.html
+++ b/docs/drvqemu.html
@@ -149,6 +149,23 @@
        node. If both are found, then Xen paravirtualized guests can be run using
        the KVM hardware acceleration.
       </li></ul>
+        <h2>Connections to QEMU driver</h2>
+        <p>
+    The libvirt QEMU driver is a multi-instance driver, providing a single
+    system wide privileged driver (the "system" instance), and per-user
+    unprivileged drivers (the "session" instance). The of the driver protocol
+    is "qemu". Some example conection URIs for the libvirt driver are:
+    </p>
+        <pre>
+    qemu:///session                      (local access to per-user instance)
+    qemu+unix:///session                 (local access to per-user instance)
+
+    qemu:///system                       (local access to system instance)
+    qemu+unix:///system                  (local access to system instance)
+    qemu://example.com/system            (remote access, TLS/x509)
+    qemu+tcp://example.com/system        (remote access, SASl/Kerberos)
+    qemu+ssh://root@example.com/system   (remote access, SSH tunnelled)
+    </pre>
         <h2>
           <a name="xmlconfig" id="xmlconfig">Example domain XML config</a>
         </h2>

diff --git a/docs/drvqemu.html.in b/docs/drvqemu.html.in
index e6005622e4c769fdde8971d3479558e49ff51eab..9ec050160ca8a5d01248f5515a8acdd6d8fe41a5 100644 (file)
--- a/docs/drvqemu.html.in
+++ b/docs/drvqemu.html.in
@@ -32,6 +32,26 @@
       </li>
     </ul>
 
+    <h2>Connections to QEMU driver</h2>
+
+    <p>
+    The libvirt QEMU driver is a multi-instance driver, providing a single
+    system wide privileged driver (the "system" instance), and per-user
+    unprivileged drivers (the "session" instance). The of the driver protocol
+    is "qemu". Some example conection URIs for the libvirt driver are:
+    </p>
+
+    <pre>
+    qemu:///session                      (local access to per-user instance)
+    qemu+unix:///session                 (local access to per-user instance)
+
+    qemu:///system                       (local access to system instance)
+    qemu+unix:///system                  (local access to system instance)
+    qemu://example.com/system            (remote access, TLS/x509)
+    qemu+tcp://example.com/system        (remote access, SASl/Kerberos)
+    qemu+ssh://root@example.com/system   (remote access, SSH tunnelled)
+    </pre>
+
     <h2><a name="xmlconfig">Example domain XML config</a></h2>
 
     <h3>QEMU emulated guest on x86_64</h3>

diff --git a/docs/drvtest.html b/docs/drvtest.html
index 01edf3368f3295f742fc5867c1ad1c5dcd1433e5..e5d0d1c7dfb068346a4d6a82cf9456fd82aa468c 100644 (file)
--- a/docs/drvtest.html
+++ b/docs/drvtest.html
@@ -126,6 +126,22 @@
       </div>
       <div id="content">
         <h1>Test "mock" driver</h1>
+        <h2>Connections to Test driver</h2>
+        <p>
+    The libvirt Test driver is a per-process fake hypervisor driver,
+    with a driver name of 'test'. The driver maintains all its state
+    in memory. It can start with a pre-configured default config, or
+    be given a path to a alternate config. Some example conection URIs
+    for the libvirt driver are:
+    </p>
+        <pre>
+    test:///default                     (local access, default config)
+    test:///path/to/driver/config.xml   (local access, custom config)
+    test+unix:///default                (local access, default config, via daemon)
+    test://example.com/default          (remote access, TLS/x509)
+    test+tcp://example.com/default      (remote access, SASl/Kerberos)
+    test+ssh://root@example.com/default (remote access, SSH tunnelled)
+    </pre>
       </div>
     </div>
     <div id="footer">

diff --git a/docs/drvtest.html.in b/docs/drvtest.html.in
index f08dd3b4ef7e13db4f0379612fab583f6a6c3e49..0547fbb2e3e3211c126c5858cf32d85c7a6ff646 100644 (file)
--- a/docs/drvtest.html.in
+++ b/docs/drvtest.html.in
@@ -1,5 +1,25 @@
 <html>
   <body>
     <h1>Test "mock" driver</h1>
+
+    <h2>Connections to Test driver</h2>
+
+    <p>
+    The libvirt Test driver is a per-process fake hypervisor driver,
+    with a driver name of 'test'. The driver maintains all its state
+    in memory. It can start with a pre-configured default config, or
+    be given a path to a alternate config. Some example conection URIs
+    for the libvirt driver are:
+    </p>
+
+    <pre>
+    test:///default                     (local access, default config)
+    test:///path/to/driver/config.xml   (local access, custom config)
+    test+unix:///default                (local access, default config, via daemon)
+    test://example.com/default          (remote access, TLS/x509)
+    test+tcp://example.com/default      (remote access, SASl/Kerberos)
+    test+ssh://root@example.com/default (remote access, SSH tunnelled)
+    </pre>
+
   </body>
 </html>

diff --git a/docs/drvuml.html b/docs/drvuml.html
index 032343c601aa9bf15447cfb809fb6b555ce4896b..74f7b258ffaa9e0ddde5b2300e06651aaa67899a 100644 (file)
--- a/docs/drvuml.html
+++ b/docs/drvuml.html
@@ -146,8 +146,11 @@
     URIs are
     </p>
         <pre>
-    uml:///system                        (local access, system instance)
-    uml:///session                       (local access, session instance)
+    uml:///session                       (local access to per-user instance)
+    uml+unix:///session                  (local access to per-user instance)
+
+    uml:///system                        (local access to system instance)
+    uml+unix:///system                   (local access to system instance)
     uml://example.com/system             (remote access, TLS/x509)
     uml+tcp://example.com/system         (remote access, SASl/Kerberos)
     uml+ssh://root@example.com/system    (remote access, SSH tunnelled)

diff --git a/docs/drvuml.html.in b/docs/drvuml.html.in
index 8f4429a49f12d19dc8d7d3c519c2b5ade4f89c9a..25a417f0f0ad309b27ee89a13f029720ca9cefe0 100644 (file)
--- a/docs/drvuml.html.in
+++ b/docs/drvuml.html.in
@@ -25,8 +25,11 @@
     </p>
 
     <pre>
-    uml:///system                        (local access, system instance)
-    uml:///session                       (local access, session instance)
+    uml:///session                       (local access to per-user instance)
+    uml+unix:///session                  (local access to per-user instance)
+
+    uml:///system                        (local access to system instance)
+    uml+unix:///system                   (local access to system instance)
     uml://example.com/system             (remote access, TLS/x509)
     uml+tcp://example.com/system         (remote access, SASl/Kerberos)
     uml+ssh://root@example.com/system    (remote access, SSH tunnelled)

diff --git a/docs/drvxen.html b/docs/drvxen.html
index 17d4a71e196371567e8cb3e355d71895e0166387..2cabcc7ce42063ddc51ee864e5d37ec481923af0 100644 (file)
--- a/docs/drvxen.html
+++ b/docs/drvxen.html
@@ -159,6 +159,19 @@
        the <code>/etc/xen</code> directory. It is important not to place
        any other non-config files in this directory.
       </li></ul>
+        <h2>Connections to Xen driver</h2>
+        <p>
+    The libvirt Xen driver is a single-instance privileged driver,
+    with a driver name of 'xen'. Some example conection URIs for
+    the libvirt driver are:
+    </p>
+        <pre>
+    xen:///                        (local access, direct)
+    xen+unix:///                   (local access, via daemon)
+    xen://example.com/             (remote access, TLS/x509)
+    xen+tcp://example.com/         (remote access, SASl/Kerberos)
+    xen+ssh://root@example.com/    (remote access, SSH tunnelled)
+    </pre>
         <h2>
           <a name="xmlconfig" id="xmlconfig">Example domain XML config</a>
         </h2>

diff --git a/docs/drvxen.html.in b/docs/drvxen.html.in
index 6853c0a241db2f419cea1f9cf056326ca9e1bc10..3dc36afabb3fab455159325dac68d622e0c4cfd7 100644 (file)
--- a/docs/drvxen.html.in
+++ b/docs/drvxen.html.in
@@ -44,6 +44,23 @@
       </li>
     </ul>
 
+    <h2>Connections to Xen driver</h2>
+
+    <p>
+    The libvirt Xen driver is a single-instance privileged driver,
+    with a driver name of 'xen'. Some example conection URIs for
+    the libvirt driver are:
+    </p>
+
+    <pre>
+    xen:///                        (local access, direct)
+    xen+unix:///                   (local access, via daemon)
+    xen://example.com/             (remote access, TLS/x509)
+    xen+tcp://example.com/         (remote access, SASl/Kerberos)
+    xen+ssh://root@example.com/    (remote access, SSH tunnelled)
+    </pre>
+
+
     <h2><a name="xmlconfig">Example domain XML config</a></h2>
 
     <p>

diff --git a/docs/index.html b/docs/index.html
index 26e594eebc1839a68f0fcedd07bcfdd0594e4a17..2b03eeb46d21504e7a3825ad93b3cff64f607924 100644 (file)
--- a/docs/index.html
+++ b/docs/index.html
@@ -82,6 +82,8 @@
        A set of bindings for common languages
       </li><li>
        A <a href="CIM/">CIM provider</a> for the DMTF virtualization schema
+      </li><li>
+       A <a href="/qpid/">QMF agent</a> for the AMQP/QPid messaging system
       </li></ul>
         <h2>libvirt supports:</h2>
         <ul><li>
@@ -95,11 +97,13 @@
        The <a href="http://lxc.sourceforge.net/">LXC</a> Linux container system
       </li><li>
        The <a href="http://openvz.org/">OpenVZ</a> Linux container system
+      </li><li>
+       The <a href="http://user-mode-linux.sourceforge.net/">User Mode Linux</a> paravirtualized kernel
       </li><li>
        Storage on IDE/SCSI/USB disks, FibreChannel, LVM, iSCSI, NFS and filesystems
       </li></ul>
         <h2>libvirt provides:</h2>
-        <ul><li>Remote management using TLS encryption and x509 certificates</li><li>Remote management authenticating with Kerberos and SASL</li><li>Local access control using PolicyKit</li><li>Zero-conf discovery using Avahi multicast-DNS</li><li>Management of virtual machines, virtual networks and storage</li></ul>
+        <ul><li>Remote management using TLS encryption and x509 certificates</li><li>Remote management authenticating with Kerberos and SASL</li><li>Local access control using PolicyKit</li><li>Zero-conf discovery using Avahi multicast-DNS</li><li>Management of virtual machines, virtual networks and storage</li><li>Portable client API for Linux, Solaris and Windows</li></ul>
         <p class="image">
       <img src="libvirtLogo.png" alt="libvirt Logo" /></p>
       </div>

diff --git a/docs/index.html.in b/docs/index.html.in
index aa0aead6695955725ce1b1fd6b8f85f458ff462a..79d85634f131b1bd1393839d4ee4eae4f56a531f 100644 (file)
--- a/docs/index.html.in
+++ b/docs/index.html.in
@@ -25,6 +25,9 @@
       <li>
        A <a href="CIM/">CIM provider</a> for the DMTF virtualization schema
       </li>
+      <li>
+       A <a href="/qpid/">QMF agent</a> for the AMQP/QPid messaging system
+      </li>
     </ul>
 
     <h2>libvirt supports:</h2>
@@ -46,6 +49,9 @@
       <li>
        The <a href="http://openvz.org/">OpenVZ</a> Linux container system
       </li>
+      <li>
+       The <a href="http://user-mode-linux.sourceforge.net/">User Mode Linux</a> paravirtualized kernel
+      </li>
       <li>
        Storage on IDE/SCSI/USB disks, FibreChannel, LVM, iSCSI, NFS and filesystems
       </li>
@@ -59,6 +65,7 @@
       <li>Local access control using PolicyKit</li>
       <li>Zero-conf discovery using Avahi multicast-DNS</li>
       <li>Management of virtual machines, virtual networks and storage</li>
+      <li>Portable client API for Linux, Solaris and Windows</li>
     </ul>
 
     <p class="image">