← Back to branch summary

~ubuntu-branches/ubuntu/maverick/libvirt/maverick

« back to all changes in this revision

Viewing changes to docs/formatstorage.html.in

  • Committer: Bazaar Package Importer
  • Author(s): Soren Hansen
  • Date: 2009-02-11 01:01:42 UTC
  • mto: (3.4.1 sid) (1.2.1 upstream) (0.2.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 34.
  • Revision ID: james.westby@ubuntu.com-20090211010142-wk9mgtbw8bmp3zcb
Tags: upstream-0.6.0
Import upstream version 0.6.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/formatstorage.html.in
234
234
        ...
235
235
        <target>
236
236
          <path>/var/lib/virt/images/sparse.img</path>
 
237
          <format>qcow2</format>
237
238
          <permissions>
238
239
            <owner>0744</owner>
239
240
            <group>0744</group>
240
241
            <mode>0744</mode>
241
242
            <label>virt_image_t</label>
242
243
          </permissions>
243
 
        </target>
244
 
      &lt;/volume&gt;</pre>
 
244
        &lt;/target&gt;</pre>
245
245
 
246
246
    <dl>
247
247
      <dt><code>path</code></dt>
271
271
      </dd>
272
272
    </dl>
273
273
 
 
274
    <h3><a name="StorageVolBacking">Backing store elements</a></h3>
 
275
 
 
276
    <p>
 
277
      A single <code>backingStore</code> element is contained within the top level
 
278
      <code>volume</code> element. This tag is used to describe the optional copy
 
279
      on write, backing store for the storage volume. It can contain the following
 
280
      child elements:
 
281
    </p>
 
282
 
 
283
    <pre>
 
284
        ...
 
285
        &lt;backingStore&gt;
 
286
          &lt;path&gt;/var/lib/virt/images/master.img&lt;/path&gt;
 
287
          &lt;format&gt;raw&lt;/format&gt;
 
288
          &lt;permissions&gt;
 
289
            &lt;owner&gt;0744&lt;/owner&gt;
 
290
            &lt;group&gt;0744&lt;/group&gt;
 
291
            &lt;mode&gt;0744&lt;/mode&gt;
 
292
            &lt;label&gt;virt_image_t&lt;/label&gt;
 
293
          &lt;/permissions&gt;
 
294
        &lt;/backingStore&gt;
 
295
      &lt;/volume&gt;</pre>
 
296
 
 
297
    <dl>
 
298
      <dt><code>path</code></dt>
 
299
      <dd>Provides the location at which the backing store can be accessed on
 
300
        the local filesystem, as an absolute path. If omitted, there is no
 
301
        backing store for this volume.
 
302
        <span class="since">Since 0.6.0</span></dd>
 
303
      <dt><code>format</code></dt>
 
304
      <dd>Provides information about the pool specific backing store format.
 
305
        For disk pools it will provide the partition type. For filesystem
 
306
        or directory pools it will provide the file format type, eg cow,
 
307
        qcow, vmdk, raw. Consult the pool-specific docs for the list of valid
 
308
        values. Most file formats require a backing store of the same format,
 
309
        however, the qcow2 format allows a different backing store format.
 
310
        <span class="since">Since 0.6.0</span></dd>
 
311
      <dt><code>permissions</code></dt>
 
312
      <dd>Provides information about the permissions of the backing file.
 
313
        It contains 4 child elements. The
 
314
        <code>mode</code> element contains the octal permission set. The
 
315
        <code>owner</code> element contains the numeric user ID. The <code>group</code>
 
316
        element contains the numeric group ID. The <code>label</code> element
 
317
        contains the MAC (eg SELinux) label string.
 
318
        <span class="since">Since 0.6.0</span>
 
319
      </dd>
 
320
    </dl>
 
321
 
274
322
    <h2><a name="examples">Example configuration</a></h2>
275
323
 
276
324
    <p>