aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorHendrik Schwartke <hendrik@os-t.de>2012-07-25 09:43:37 +0200
committerEric Blake <eblake@redhat.com>2012-08-02 17:14:17 -0600
commit7383c1d762c50c83832a8d11b48d75e5cad0042a (patch)
tree80b951133c79a4c9898c1f9c460dbe9218458720 /docs
parentUpdate xml schemas according to libvirt source (diff)
downloadlibvirt-7383c1d762c50c83832a8d11b48d75e5cad0042a.tar.gz
libvirt-7383c1d762c50c83832a8d11b48d75e5cad0042a.tar.bz2
libvirt-7383c1d762c50c83832a8d11b48d75e5cad0042a.zip
Added timestamps to storage volumes
The access, birth, modification and change times are added to storage volumes and corresponding xml representations. This shows up in the XML in this format: <timestamps> <atime>1341933637.027319099</atime> <mtime>1341933637.027319099</mtime> </timestamps> Signed-off-by: Eric Blake <eblake@redhat.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/formatstorage.html.in18
-rw-r--r--docs/schemas/storagevol.rng36
2 files changed, 54 insertions, 0 deletions
diff --git a/docs/formatstorage.html.in b/docs/formatstorage.html.in
index d0e4319c5..9f93db810 100644
--- a/docs/formatstorage.html.in
+++ b/docs/formatstorage.html.in
@@ -141,6 +141,11 @@
&lt;mode&gt;0744&lt;/mode&gt;
&lt;label&gt;virt_image_t&lt;/label&gt;
&lt;/permissions&gt;
+ &lt;timestamps&gt;
+ &lt;atime&gt;1341933637.273190990&lt;/atime&gt;
+ &lt;mtime&gt;1341930622.047245868&lt;/mtime&gt;
+ &lt;ctime&gt;1341930622.047245868&lt;/ctime&gt;
+ &lt;/timestamps&gt;
&lt;encryption type='...'&gt;
...
&lt;/encryption&gt;
@@ -172,6 +177,19 @@
contains the MAC (eg SELinux) label string.
<span class="since">Since 0.4.1</span>
</dd>
+ <dt><code>timestamps</code></dt>
+ <dd>Provides timing information about the volume. Up to four
+ sub-elements are present,
+ where <code>atime</code>, <code>btime</code>, <code>ctime</code>
+ and <code>mtime</code> hold the access, birth, change and
+ modification time of the volume, where known. The used time
+ format is &lt;seconds&gt;.&lt;nanoseconds&gt; since the
+ beginning of the epoch (1 Jan 1970). If nanosecond resolution
+ is 0 or otherwise unsupported by the host OS or filesystem,
+ then the nanoseconds part is omitted. This is a readonly
+ attribute and is ignored when creating a volume.
+ <span class="since">Since 0.10.0</span>
+ </dd>
<dt><code>encryption</code></dt>
<dd>If present, specifies how the volume is encrypted. See
the <a href="formatstorageencryption.html">Storage Encryption</a> page
diff --git a/docs/schemas/storagevol.rng b/docs/schemas/storagevol.rng
index 0b9933d56..8335b616f 100644
--- a/docs/schemas/storagevol.rng
+++ b/docs/schemas/storagevol.rng
@@ -63,6 +63,41 @@
</optional>
</define>
+ <define name='timestamps'>
+ <optional>
+ <element name='timestamps'>
+ <interleave>
+ <optional>
+ <element name='atime'>
+ <ref name='timestamp'/>
+ </element>
+ </optional>
+ <optional>
+ <element name='btime'>
+ <ref name='timestamp'/>
+ </element>
+ </optional>
+ <optional>
+ <element name='ctime'>
+ <ref name='timestamp'/>
+ </element>
+ </optional>
+ <optional>
+ <element name='mtime'>
+ <ref name='timestamp'/>
+ </element>
+ </optional>
+ </interleave>
+ </element>
+ </optional>
+ </define>
+
+ <define name='timestamp'>
+ <data type='string'>
+ <param name="pattern">[0-9]+(\.[0-9]{0,9})?</param>
+ </data>
+ </define>
+
<define name='target'>
<element name='target'>
<optional>
@@ -72,6 +107,7 @@
</optional>
<ref name='format'/>
<ref name='permissions'/>
+ <ref name='timestamps'/>
<optional>
<ref name='encryption'/>
</optional>