2013-05-03 14:25:37 +00:00
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
2008-04-23 17:08:31 +00:00
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
|
|
|
<body>
|
2016-11-08 11:35:20 +00:00
|
|
|
<h1>XML Format</h1>
|
2008-04-23 17:08:31 +00:00
|
|
|
|
|
|
|
|
|
2016-11-08 11:35:20 +00:00
|
|
|
<p>
|
|
|
|
|
Objects in the libvirt API are configured using XML documents to allow
|
|
|
|
|
for ease of extension in future releases. Each XML document has an
|
|
|
|
|
associated Relax-NG schema that can be used to validate documents
|
|
|
|
|
prior to usage.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="formatdomain.html" shape="rect">Domains</a></li>
|
|
|
|
|
<li><a href="formatnetwork.html" shape="rect">Networks</a></li>
|
|
|
|
|
<li><a href="formatnwfilter.html" shape="rect">Network filtering</a></li>
|
|
|
|
|
<li><a href="formatstorage.html" shape="rect">Storage</a></li>
|
|
|
|
|
<li><a href="formatstorageencryption.html" shape="rect">Storage encryption</a></li>
|
|
|
|
|
<li><a href="formatcaps.html" shape="rect">Capabilities</a></li>
|
|
|
|
|
<li><a href="formatdomaincaps.html" shape="rect">Domain capabilities</a></li>
|
|
|
|
|
<li><a href="formatnode.html" shape="rect">Node devices</a></li>
|
|
|
|
|
<li><a href="formatsecret.html" shape="rect">Secrets</a></li>
|
|
|
|
|
<li><a href="formatsnapshot.html" shape="rect">Snapshots</a></li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<h2>Command line validation</h2>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
The <code>virt-xml-validate</code> tool provides a simple command line
|
|
|
|
|
for validating XML documents prior to giving them to libvirt. It uses
|
|
|
|
|
the locally instaled RNG schema documents. It will auto-detect which
|
|
|
|
|
schema to use for validation based on the name of the top level element
|
|
|
|
|
in the input document. Thus it merely requires the XML document filename
|
|
|
|
|
to be passed on the command line
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<pre>
|
2016-11-11 22:40:27 +00:00
|
|
|
$ virt-xml-validate /path/to/XML/file</pre>
|
2008-04-23 17:08:31 +00:00
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
