libvirt/docs/schemas/storagevol.rng

<!-- A Relax NG schema for the libvirt storage volume XML format -->
<grammar xmlns="http://relaxng.org/ns/structure/1.0"
    datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
  <start>
    <ref name='vol'/>
  </start>

  <include href='storageencryption.rng'/>


  <define name='vol'>
    <element name='volume'>
      <element name='name'>
	<ref name='name'/>
      </element>
      <optional>
	<element name='key'>
	  <text/>
	</element>
      </optional>
      <ref name='source'/>
      <ref name='sizing'/>
      <ref name='target'/>
      <optional>
	<ref name='backingStore'/>
      </optional>
    </element>
  </define>

  <define name='sizing'>
    <optional>
      <element name='capacity'>
        <optional>
	  <attribute name='unit'>
	    <ref name='unit'/>
	  </attribute>
        </optional>
	<ref name='uint'/>
      </element>
    </optional>
    <optional>
      <element name='allocation'>
	<ref name='uint'/>
      </element>
    </optional>
  </define>

  <define name='permissions'>
    <optional>
      <element name='permissions'>
	<element name='mode'>
	  <ref name='uint'/>
	</element>
	<element name='owner'>
	  <ref name='uint'/>
	</element>
	<element name='group'>
	  <ref name='uint'/>
	</element>
	<optional>
	  <element name='label'>
	    <text/>
	</element>
	</optional>
      </element>
    </optional>
  </define>

  <define name='target'>
    <element name='target'>
      <optional>
	<element name='path'>
	  <ref name='path'/>
	</element>
      </optional>
      <ref name='format'/>
      <ref name='permissions'/>
      <optional>
        <ref name='encryption'/>
      </optional>
    </element>
  </define>

  <define name='backingStore'>
    <element name='backingStore'>
      <element name='path'>
	<ref name='path'/>
      </element>
      <ref name='format'/>
      <ref name='permissions'/>
    </element>
  </define>


  <define name='source'>
    <element name='source'>
      <zeroOrMore>
	<ref name='sourcedev'/>
      </zeroOrMore>
    </element>
  </define>

  <define name='sourcedev'>
    <element name='device'>
      <attribute name='path'>
	<ref name='path'/>
      </attribute>
      <choice>
	<empty/>
	<ref name='devextents'/>
      </choice>
    </element>
  </define>

  <define name='devextents'>
    <oneOrMore>
      <element name='extent'>
	<attribute name='start'>
	  <ref name='uint'/>
	</attribute>
	<attribute name='end'>
	  <ref name='uint'/>
	</attribute>
      </element>
    </oneOrMore>
  </define>

  <define name='formatdev'>
    <choice>
      <value>none</value>
      <value>auto</value>
      <value>ext2</value>
      <value>ext3</value>
      <value>ext4</value>
      <value>ufs</value>
      <value>iso9660</value>
      <value>udf</value>
      <value>gfs</value>
      <value>gfs2</value>
      <value>vfat</value>
      <value>hfs+</value>
      <value>xfs</value>
    </choice>

  </define>


  <define name='formatfile'>
    <choice>
      <value>raw</value>
      <value>dir</value>
      <value>bochs</value>
      <value>cloop</value>
      <value>cow</value>
      <value>dmg</value>
      <value>iso</value>
      <value>qcow</value>
      <value>qcow2</value>
      <value>vmdk</value>
      <value>vpc</value>
    </choice>
  </define>

  <define name='format'>
    <optional>
      <element name='format'>
	<attribute name='type'>
	  <choice>
	    <ref name='formatfile'/>
	    <ref name='formatdev'/>
	  </choice>
	</attribute>
      </element>
    </optional>
  </define>

  <define name='name'>
    <data type='string'>
      <param name="pattern">[a-zA-Z0-9_\+\-\.]+</param>
    </data>
  </define>

  <define name='uint'>
    <data type='string'>
      <param name="pattern">[0-9]+</param>
    </data>
  </define>

  <define name='path'>
    <data type='string'>
      <param name="pattern">/[a-zA-Z0-9_\+\-\./%]+</param>
    </data>
  </define>

  <define name='unit'>
    <data type='string'>
      <param name="pattern">[kKmMgGtTpPyYzZ]</param>
    </data>
  </define>

  <define name="UUID">
    <choice>
      <data type="string">
        <param name="pattern">[a-fA-F0-9]{32}</param>
      </data>
      <data type="string">
        <param name="pattern">[a-fA-F0-9]{8}\-([a-fA-F0-9]{4}\-){3}[a-fA-F0-9]{12}</param>
      </data>
    </choice>
  </define>

</grammar>