* docs/ChangeLog.awk docs/ChangeLog.xsl: Changelog handling from

  libxml2 adapted to libvir
* docs/* docs/html/libxml-libvir.html: regenerated
Daniel

diff --git a/ChangeLog b/ChangeLog
index 78b5e68d984e894bc31b68ab7f61f6a1957d0d06..b5a2966242abc97a3bb33d78430285a768c0129c 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+Wed Dec  7 13:55:04 CET 2005 Daniel Veillard <veillard@redhat.com>
+
+       * docs/ChangeLog.awk docs/ChangeLog.xsl: Changelog handling from
+         libxml2 adapted to libvir
+       * docs/* docs/html/libxml-libvir.html: regenerated
+
 Wed Dec  7 11:58:20 CET 2005 Daniel Veillard <veillard@redhat.com>
 
        * docs/* docs/html/*: more work on the docs generation

diff --git a/docs/APIchunk0.html b/docs/APIchunk0.html
index fbeeb160ff5a9f0c906c21f5b11baa50af4dee06..bf526c237350ba07c29b41fd7792e78d490b33f6 100644 (file)
--- a/docs/APIchunk0.html
+++ b/docs/APIchunk0.html
@@ -89,6 +89,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 </dd><dt>case</dt><dd><a href="html/libvir-libvir.html#virConnectClose">virConnectClose</a><br />
 <a href="html/libvir-libvir.html#virConnectGetVersion">virConnectGetVersion</a><br />
 <a href="html/libvir-libvir.html#virConnectListDomains">virConnectListDomains</a><br />
+<a href="html/libvir-libvir.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
 <a href="html/libvir-libvir.html#virConnectOpen">virConnectOpen</a><br />
 <a href="html/libvir-libvir.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a><br />
 <a href="html/libvir-libvir.html#virDomainCreateLinux">virDomainCreateLinux</a><br />
@@ -111,6 +112,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <a href="html/libvir-libvir.html#virConnectClose">virConnectClose</a><br />
 <a href="html/libvir-libvir.html#virConnectGetVersion">virConnectGetVersion</a><br />
 <a href="html/libvir-libvir.html#virConnectListDomains">virConnectListDomains</a><br />
+<a href="html/libvir-libvir.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
 <a href="html/libvir-libvir.html#virConnectOpen">virConnectOpen</a><br />
 <a href="html/libvir-libvir.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a><br />
 <a href="html/libvir-libvir.html#virDomainCreateLinux">virDomainCreateLinux</a><br />
@@ -125,6 +127,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 </dd></dl><h2>Letter e:</h2><dl><dt>error</dt><dd><a href="html/libvir-libvir.html#virConnectClose">virConnectClose</a><br />
 <a href="html/libvir-libvir.html#virConnectGetVersion">virConnectGetVersion</a><br />
 <a href="html/libvir-libvir.html#virConnectListDomains">virConnectListDomains</a><br />
+<a href="html/libvir-libvir.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
 <a href="html/libvir-libvir.html#virConnectOpen">virConnectOpen</a><br />
 <a href="html/libvir-libvir.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a><br />
 <a href="html/libvir-libvir.html#virDomainGetID">virDomainGetID</a><br />
@@ -150,6 +153,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <a href="html/libvir-libvir.html#virDomainGetName">virDomainGetName</a><br />
 <a href="html/libvir-libvir.html#virDomainLookupByName">virDomainLookupByName</a><br />
 </dd><dt>found</dt><dd><a href="html/libvir-libvir.html#virConnectListDomains">virConnectListDomains</a><br />
+<a href="html/libvir-libvir.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
 </dd><dt>from</dt><dd><a href="html/libvir-libvir.html#_virDomainInfo">_virDomainInfo</a><br />
 <a href="html/libvir-libvir.html#virDomainResume">virDomainResume</a><br />
 </dd><dt>frozen</dt><dd><a href="html/libvir-libvir.html#virDomainResume">virDomainResume</a><br />
@@ -171,6 +175,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <a href="html/libvir-libvir.html#virConnectClose">virConnectClose</a><br />
 <a href="html/libvir-libvir.html#virConnectGetVersion">virConnectGetVersion</a><br />
 <a href="html/libvir-libvir.html#virConnectListDomains">virConnectListDomains</a><br />
+<a href="html/libvir-libvir.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
 <a href="html/libvir-libvir.html#virConnectOpen">virConnectOpen</a><br />
 <a href="html/libvir-libvir.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a><br />
 <a href="html/libvir-libvir.html#virDomainCreateLinux">virDomainCreateLinux</a><br />

diff --git a/docs/APIchunk1.html b/docs/APIchunk1.html
index 9c90119a02c13dd0571ab8d3068ae0954bb1e073..4d2abbdafc03d8890c902ce9779b044043cb372e 100644 (file)
--- a/docs/APIchunk1.html
+++ b/docs/APIchunk1.html
@@ -21,6 +21,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <a href="html/libvir-libvir.html#virDomainDestroy">virDomainDestroy</a><br />
 <a href="html/libvir-libvir.html#virDomainGetName">virDomainGetName</a><br />
 </dd><dt>number</dt><dd><a href="html/libvir-libvir.html#virConnectListDomains">virConnectListDomains</a><br />
+<a href="html/libvir-libvir.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
 <a href="html/libvir-libvir.html#virDomainGetID">virDomainGetID</a><br />
 <a href="html/libvir-libvir.html#virDomainLookupByID">virDomainLookupByID</a><br />
 </dd></dl><h2>Letter o:</h2><dl><dt>object</dt><dd><a href="html/libvir-libvir.html#virDomainCreateLinux">virDomainCreateLinux</a><br />
@@ -52,6 +53,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 </dd><dt>pointer</dt><dd><a href="html/libvir-libvir.html#virConnectClose">virConnectClose</a><br />
 <a href="html/libvir-libvir.html#virConnectGetVersion">virConnectGetVersion</a><br />
 <a href="html/libvir-libvir.html#virConnectListDomains">virConnectListDomains</a><br />
+<a href="html/libvir-libvir.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
 <a href="html/libvir-libvir.html#virConnectOpen">virConnectOpen</a><br />
 <a href="html/libvir-libvir.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a><br />
 <a href="html/libvir-libvir.html#virDomainCreateLinux">virDomainCreateLinux</a><br />

diff --git a/docs/APIfiles.html b/docs/APIfiles.html
index dcad8609bb0b18d3c8fb2c6a66253fb6e4cc6106..0bc368a1348835bcf97b238c4df18aa07729b41c 100644 (file)
--- a/docs/APIfiles.html
+++ b/docs/APIfiles.html
@@ -19,6 +19,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <a href="html/libvir-libvir.html#virConnectClose">virConnectClose</a><br />
 <a href="html/libvir-libvir.html#virConnectGetVersion">virConnectGetVersion</a><br />
 <a href="html/libvir-libvir.html#virConnectListDomains">virConnectListDomains</a><br />
+<a href="html/libvir-libvir.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
 <a href="html/libvir-libvir.html#virConnectOpen">virConnectOpen</a><br />
 <a href="html/libvir-libvir.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a><br />
 <a href="html/libvir-libvir.html#virConnectPtr">virConnectPtr</a><br />

diff --git a/docs/APIfunctions.html b/docs/APIfunctions.html
index 3a2189441c215807fe317891bb1e9f6b7f058bf3..ed7252e05d49ec3271436bdac637d6645d1db436 100644 (file)
--- a/docs/APIfunctions.html
+++ b/docs/APIfunctions.html
@@ -14,6 +14,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 </p><h2>Type virConnectPtr:</h2><p><a href="html/libvir-libvir.html#virConnectClose">virConnectClose</a><br />
 <a href="html/libvir-libvir.html#virConnectGetVersion">virConnectGetVersion</a><br />
 <a href="html/libvir-libvir.html#virConnectListDomains">virConnectListDomains</a><br />
+<a href="html/libvir-libvir.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
 <a href="html/libvir-libvir.html#virDomainCreateLinux">virDomainCreateLinux</a><br />
 <a href="html/libvir-libvir.html#virDomainLookupByID">virDomainLookupByID</a><br />
 <a href="html/libvir-libvir.html#virDomainLookupByName">virDomainLookupByName</a><br />

diff --git a/docs/APIsymbols.html b/docs/APIsymbols.html
index aba7ac8a2d4bbcba2840c805be8607e5c9ad2193..83a5bed89e46e44c46821b65b4ae9e33b951ca43 100644 (file)
--- a/docs/APIsymbols.html
+++ b/docs/APIsymbols.html
@@ -19,6 +19,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <a href="html/libvir-libvir.html#virConnectClose">virConnectClose</a><br />
 <a href="html/libvir-libvir.html#virConnectGetVersion">virConnectGetVersion</a><br />
 <a href="html/libvir-libvir.html#virConnectListDomains">virConnectListDomains</a><br />
+<a href="html/libvir-libvir.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
 <a href="html/libvir-libvir.html#virConnectOpen">virConnectOpen</a><br />
 <a href="html/libvir-libvir.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a><br />
 <a href="html/libvir-libvir.html#virConnectPtr">virConnectPtr</a><br />

diff --git a/docs/ChangeLog.awk b/docs/ChangeLog.awk
new file mode 100755 (executable)
index 0000000..eb0db03
--- /dev/null
+++ b/docs/ChangeLog.awk
@@ -0,0 +1,49 @@
+#!/bin/awk -f
+function translate(str) {
+    while (sub(/&/, "#amp;", str) == 1);
+    while (sub(/#amp;/, "\\&", str) == 1); # fun isn't it ?
+    while (sub(/</, "\\&lt;", str) == 1);
+    while (sub(/>/, "\\&gt;", str) == 1);
+    sub(/[0-9][0-9][0-9][0-9][0-9]+/, "<bug number='&'/>", str)
+    return(str)
+}
+BEGIN         { 
+               nb_entry = 0
+                in_entry = 0
+                in_item = 0
+               print "<?xml version='1.0' encoding='ISO-8859-1'?>"
+               print "<log>"
+             }
+END           {
+                if (in_item == 1)  printf("%s</item>\n", translate(item))
+                if (in_entry == 1) print "  </entry>"
+                print "</log>"
+             }
+/^[ \t]*$/    { next }
+/^[A-Za-z0-9]/ { 
+                match($0, "\(.*\) \([A-Z]+\) \([0-9][0-9][0-9][0-9]\) \(.*\) <\(.*\)>", loge)
+                if (in_item == 1)  printf("%s</item>\n", translate(item))
+                if (in_entry == 1) print "  </entry>"
+               nb_entry = nb_entry + 1
+               if (nb_entry > 50) {
+                   in_entry = 0
+                   in_item = 0
+                   exit
+               }
+                in_entry = 1
+                in_item = 0
+               printf("  <entry date='%s' timezone='%s' year='%s'\n         who='%s' email='%s'>\n", loge[1], loge[2], loge[3], loge[4], loge[5])
+             }
+/^[ \t]*\*/   {
+                if (in_item == 1)  printf("%s</item>\n", translate(item))
+                in_item = 1
+               printf("    <item>")
+                match($0, "[ \t]*. *\(.*\)", loge)
+               item = loge[1]
+              }
+/^[ \t]*[a-zA-Z0-9\#]/    { 
+                if (in_item == 1) {
+                   match($0, "[ \t]*\(.*\)[ \t]*", loge)
+                   item = sprintf("%s %s",  item, loge[1])
+               }
+              }

diff --git a/docs/ChangeLog.xsl b/docs/ChangeLog.xsl
new file mode 100644 (file)
index 0000000..f58122f
--- /dev/null
+++ b/docs/ChangeLog.xsl
@@ -0,0 +1,109 @@
+<?xml version="1.0"?>
+<!-- this stylesheet builds the ChangeLog.html -->
+<xsl:stylesheet version="1.0"
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+  <!-- Import the rest of the site stylesheets -->
+  <xsl:import href="site.xsl"/>
+
+  <!-- Generate XHTML-1.0 transitional -->
+  <xsl:output method="xml" encoding="ISO-8859-1" indent="yes"
+      doctype-public="-//W3C//DTD XHTML 1.0 Transitional//EN"
+      doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"/>
+
+  <xsl:param name="module">libvir</xsl:param>
+
+  <!-- The table of content for the HTML page -->
+  <xsl:variable name="menu_name">API Menu</xsl:variable>
+  <xsl:variable name="develtoc">
+    <form action="../search.php"
+          enctype="application/x-www-form-urlencoded" method="get">
+      <input name="query" type="text" size="20" value=""/>
+      <input name="submit" type="submit" value="Search ..."/>
+    </form>
+    <ul><!-- style="margin-left: -1em" -->
+      <li><a style="font-weight:bold"
+             href="{$href_base}index.html">Main Menu</a></li>
+      <li><a style="font-weight:bold" 
+             href="{$href_base}html/index.html">Modules Index</a></li>
+      <li><a style="font-weight:bold"
+             href="index.html">API Menu</a></li>
+    </ul>
+  </xsl:variable>
+
+  <xsl:template match="bug">
+    <a href="https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id={@number}">
+    <xsl:value-of select="@number"/></a>
+  </xsl:template>
+  
+  <xsl:template match="item">
+    <li><xsl:apply-templates/></li>
+  </xsl:template>
+
+  <xsl:template match="entry">
+    
+    <p>
+    <b><xsl:value-of select="@who"/></b>
+       <xsl:text> </xsl:text>
+       <xsl:value-of select="@date"/>
+       <xsl:text> </xsl:text>
+       <xsl:value-of select="@timezone"/>
+    <ul>
+      <xsl:apply-templates select="item"/>
+    </ul>
+    </p>
+  </xsl:template>
+
+  <xsl:template match="log">
+    <xsl:variable name="title">ChangeLog last entries of <xsl:value-of select="$module"/></xsl:variable>
+      <html>
+        <head>
+        <xsl:call-template name="style"/>
+       <xsl:element name="title">
+         <xsl:value-of select="$title"/>
+       </xsl:element>
+        </head>
+        <body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000">
+          <xsl:call-template name="titlebox">
+           <xsl:with-param name="title" select="$title"/>
+         </xsl:call-template>
+          <table border="0" cellpadding="4" cellspacing="0" width="100%" align="center">
+            <tr>
+              <td bgcolor="#8b7765">
+                <table border="0" cellspacing="0" cellpadding="2" width="100%">
+                  <tr>
+                    <td valign="top" width="200" bgcolor="#8b7765">
+                      <xsl:call-template name="develtoc"/>
+                    </td>
+                    <td valign="top" bgcolor="#8b7765">
+                      <table border="0" cellspacing="0" cellpadding="1" width="100%">
+                        <tr>
+                          <td>
+                            <table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000">
+                              <tr>
+                                <td>
+                                  <table border="0" cellpadding="3" cellspacing="1" width="100%">
+                                    <tr>
+                                      <td bgcolor="#fffacd">
+                                       <xsl:apply-templates select="entry"/>
+                                       <p><a href="{$href_base}bugs.html">Daniel Veillard</a></p>
+                                      </td>
+                                    </tr>
+                                  </table>
+                                </td>
+                              </tr>
+                            </table>
+                          </td>
+                        </tr>
+                      </table>
+                    </td>
+                  </tr>
+                </table>
+              </td>
+            </tr>
+          </table>
+        </body>
+      </html>
+  </xsl:template>
+
+</xsl:stylesheet>

diff --git a/docs/html/libxml-libvir.html b/docs/html/libxml-libvir.html
index 18634cdccf85cf27b2f4f0fc820fe8c77d2a8750..21c732c48671cf306dffe592fcd854933a6498a4 100644 (file)
--- a/docs/html/libxml-libvir.html
+++ b/docs/html/libxml-libvir.html
@@ -23,6 +23,7 @@ The content of this structure is not made public by the API.
 </pre><pre class="programlisting">int  <a href="#virConnectClose">virConnectClose</a>                  (<a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a> conn)</pre>
 <pre class="programlisting">unsigned long      <a href="#virConnectGetVersion">virConnectGetVersion</a>        (<a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a> conn)</pre>
 <pre class="programlisting">int        <a href="#virConnectListDomains">virConnectListDomains</a>              (<a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a> conn, <br />                                       int * ids, <br />                                       int maxids)</pre>
+<pre class="programlisting">int        <a href="#virConnectNumOfDomains">virConnectNumOfDomains</a>            (<a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a> conn)</pre>
 <pre class="programlisting"><a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a>       <a href="#virConnectOpen">virConnectOpen</a>            (const char * name)</pre>
 <pre class="programlisting"><a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a>       <a href="#virConnectOpenReadOnly">virConnectOpenReadOnly</a>    (const char * name)</pre>
 <pre class="programlisting"><a href="libxml-libvir.html#virDomainPtr">virDomainPtr</a> <a href="#virDomainCreateLinux">virDomainCreateLinux</a>        (<a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a> conn, <br />                                       const char * kernel_path, <br />                                        const char * initrd_path, <br />                                        const char * cmdline, <br />                                    unsigned long memory, <br />                                    unsigned int flags)</pre>
@@ -70,7 +71,9 @@ The content of this structure is not made public by the API.
 </pre><p>Get the version level of the Hypervisor running.</p>
 <div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case of error or major * 10,000 + minor * 100 + rev otherwise</td></tr></tbody></table></div><h3><a name="virConnectListDomains" id="virConnectListDomains"></a>Function: virConnectListDomains</h3><pre class="programlisting">int      virConnectListDomains           (<a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a> conn, <br />                                       int * ids, <br />                                       int maxids)<br />
 </pre><p>Collect the list of active domains, and store their ID in @maxids</p>
-<div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>ids</tt></i>:</span></td><td>array to collect the list of IDs of active domains</td></tr><tr><td><span class="term"><i><tt>maxids</tt></i>:</span></td><td>size of @ids</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of domain found or -1 in case of error</td></tr></tbody></table></div><h3><a name="virConnectOpen" id="virConnectOpen"></a>Function: virConnectOpen</h3><pre class="programlisting"><a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a> virConnectOpen          (const char * name)<br />
+<div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>ids</tt></i>:</span></td><td>array to collect the list of IDs of active domains</td></tr><tr><td><span class="term"><i><tt>maxids</tt></i>:</span></td><td>size of @ids</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of domain found or -1 in case of error</td></tr></tbody></table></div><h3><a name="virConnectNumOfDomains" id="virConnectNumOfDomains"></a>Function: virConnectNumOfDomains</h3><pre class="programlisting">int  virConnectNumOfDomains          (<a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a> conn)<br />
+</pre><p></p>
+<div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of domain found or -1 in case of error</td></tr></tbody></table></div><h3><a name="virConnectOpen" id="virConnectOpen"></a>Function: virConnectOpen</h3><pre class="programlisting"><a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a>    virConnectOpen          (const char * name)<br />
 </pre><p>This function should be called first to get a connection to the Hypervisor and xen store</p>
 <div class="variablelist"><table border="0"><col align="left" /><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>optional argument currently unused, pass NULL</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the hypervisor connection or NULL in case of error</td></tr></tbody></table></div><h3><a name="virConnectOpenReadOnly" id="virConnectOpenReadOnly"></a>Function: virConnectOpenReadOnly</h3><pre class="programlisting"><a href="libxml-libvir.html#virConnectPtr">virConnectPtr</a>     virConnectOpenReadOnly  (const char * name)<br />
 </pre><p>This function should be called first to get a read-only connection to the xen store. The set of APIs usable are then restricted.</p>

diff --git a/docs/libvir-api.xml b/docs/libvir-api.xml
index d507f0113312a2d33523fb7841d5c06eb61cccf9..e91f167308f1af29eae0c0d1301a3165c67c45f5 100644 (file)
--- a/docs/libvir-api.xml
+++ b/docs/libvir-api.xml
@@ -23,13 +23,14 @@
      <exports symbol='_virDomainInfo' type='struct'/>
      <exports symbol='virDomainGetID' type='function'/>
      <exports symbol='virDomainGetInfo' type='function'/>
-     <exports symbol='virDomainCreateLinux' type='function'/>
+     <exports symbol='virConnectListDomains' type='function'/>
      <exports symbol='virConnectOpen' type='function'/>
      <exports symbol='virDomainDestroy' type='function'/>
      <exports symbol='virDomainLookupByID' type='function'/>
      <exports symbol='virDomainLookupByName' type='function'/>
-     <exports symbol='virConnectListDomains' type='function'/>
+     <exports symbol='virDomainCreateLinux' type='function'/>
      <exports symbol='virConnectClose' type='function'/>
+     <exports symbol='virConnectNumOfDomains' type='function'/>
      <exports symbol='virDomainResume' type='function'/>
      <exports symbol='virDomainSetMaxMemory' type='function'/>
      <exports symbol='virDomainSuspend' type='function'/>
@@ -90,6 +91,11 @@
       <arg name='ids' type='int *' info='array to collect the list of IDs of active domains'/>
       <arg name='maxids' type='int' info='size of @ids'/>
     </function>
+    <function name='virConnectNumOfDomains' file='libvir' module='libvir'>
+      <info></info>
+      <return type='int' info='the number of domain found or -1 in case of error'/>
+      <arg name='conn' type='virConnectPtr' info='pointer to the hypervisor connection'/>
+    </function>
     <function name='virConnectOpen' file='libvir' module='libvir'>
       <info>This function should be called first to get a connection to the Hypervisor and xen store</info>
       <return type='virConnectPtr' info='a pointer to the hypervisor connection or NULL in case of error'/>

diff --git a/docs/libvir-refs.xml b/docs/libvir-refs.xml
index 6cc8786c7da2881eba5896118cf68dc949244def..60852eaf06855e482b3c17aa40501c40e5c73998 100644 (file)
--- a/docs/libvir-refs.xml
+++ b/docs/libvir-refs.xml
@@ -13,6 +13,7 @@
     <reference name='virConnectClose' href='html/libvir-libvir.html#virConnectClose'/>
     <reference name='virConnectGetVersion' href='html/libvir-libvir.html#virConnectGetVersion'/>
     <reference name='virConnectListDomains' href='html/libvir-libvir.html#virConnectListDomains'/>
+    <reference name='virConnectNumOfDomains' href='html/libvir-libvir.html#virConnectNumOfDomains'/>
     <reference name='virConnectOpen' href='html/libvir-libvir.html#virConnectOpen'/>
     <reference name='virConnectOpenReadOnly' href='html/libvir-libvir.html#virConnectOpenReadOnly'/>
     <reference name='virConnectPtr' href='html/libvir-libvir.html#virConnectPtr'/>
@@ -52,6 +53,7 @@
       <ref name='virConnectClose'/>
       <ref name='virConnectGetVersion'/>
       <ref name='virConnectListDomains'/>
+      <ref name='virConnectNumOfDomains'/>
       <ref name='virConnectOpen'/>
       <ref name='virConnectOpenReadOnly'/>
       <ref name='virConnectPtr'/>
@@ -107,6 +109,7 @@
       <ref name='virConnectClose'/>
       <ref name='virConnectGetVersion'/>
       <ref name='virConnectListDomains'/>
+      <ref name='virConnectNumOfDomains'/>
       <ref name='virDomainCreateLinux'/>
       <ref name='virDomainLookupByID'/>
       <ref name='virDomainLookupByName'/>
@@ -139,6 +142,7 @@
       <ref name='virConnectClose'/>
       <ref name='virConnectGetVersion'/>
       <ref name='virConnectListDomains'/>
+      <ref name='virConnectNumOfDomains'/>
       <ref name='virConnectOpen'/>
       <ref name='virConnectOpenReadOnly'/>
       <ref name='virConnectPtr'/>
@@ -369,6 +373,7 @@
           <ref name='virConnectClose'/>
           <ref name='virConnectGetVersion'/>
           <ref name='virConnectListDomains'/>
+          <ref name='virConnectNumOfDomains'/>
           <ref name='virConnectOpen'/>
           <ref name='virConnectOpenReadOnly'/>
           <ref name='virDomainCreateLinux'/>
@@ -405,6 +410,7 @@
           <ref name='virConnectClose'/>
           <ref name='virConnectGetVersion'/>
           <ref name='virConnectListDomains'/>
+          <ref name='virConnectNumOfDomains'/>
           <ref name='virConnectOpen'/>
           <ref name='virConnectOpenReadOnly'/>
           <ref name='virDomainCreateLinux'/>
@@ -433,6 +439,7 @@
           <ref name='virConnectClose'/>
           <ref name='virConnectGetVersion'/>
           <ref name='virConnectListDomains'/>
+          <ref name='virConnectNumOfDomains'/>
           <ref name='virConnectOpen'/>
           <ref name='virConnectOpenReadOnly'/>
           <ref name='virDomainGetID'/>
@@ -476,6 +483,7 @@
         </word>
         <word name='found'>
           <ref name='virConnectListDomains'/>
+          <ref name='virConnectNumOfDomains'/>
         </word>
         <word name='from'>
           <ref name='_virDomainInfo'/>
@@ -519,6 +527,7 @@
           <ref name='virConnectClose'/>
           <ref name='virConnectGetVersion'/>
           <ref name='virConnectListDomains'/>
+          <ref name='virConnectNumOfDomains'/>
           <ref name='virConnectOpen'/>
           <ref name='virConnectOpenReadOnly'/>
           <ref name='virDomainCreateLinux'/>
@@ -639,6 +648,7 @@
         </word>
         <word name='number'>
           <ref name='virConnectListDomains'/>
+          <ref name='virConnectNumOfDomains'/>
           <ref name='virDomainGetID'/>
           <ref name='virDomainLookupByID'/>
         </word>
@@ -698,6 +708,7 @@
           <ref name='virConnectClose'/>
           <ref name='virConnectGetVersion'/>
           <ref name='virConnectListDomains'/>
+          <ref name='virConnectNumOfDomains'/>
           <ref name='virConnectOpen'/>
           <ref name='virConnectOpenReadOnly'/>
           <ref name='virDomainCreateLinux'/>