|
 |
898951 |
From 715a29642aaedc6b19b451677cb02658d5924b7f Mon Sep 17 00:00:00 2001
|
|
|
898951 |
Message-Id: <715a29642aaedc6b19b451677cb02658d5924b7f@dist-git>
|
|
|
898951 |
From: Peter Krempa <pkrempa@redhat.com>
|
|
|
898951 |
Date: Wed, 28 Jan 2015 10:33:39 +0100
|
|
|
898951 |
Subject: [PATCH] man: virsh: Add man page for "virsh metadata"
|
|
|
898951 |
|
|
|
898951 |
https://bugzilla.redhat.com/show_bug.cgi?id=1184929
|
|
|
898951 |
|
|
|
898951 |
Patch adding the command forgot to add the man page entry.
|
|
|
898951 |
|
|
|
898951 |
Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1130379
|
|
|
898951 |
(cherry picked from commit 992318cbee83dc381c44acfdfdecfb2607279e25)
|
|
|
898951 |
|
|
|
898951 |
Signed-off-by: Jiri Denemark <jdenemar@redhat.com>
|
|
|
898951 |
---
|
|
|
898951 |
tools/virsh.pod | 30 ++++++++++++++++++++++++++++++
|
|
|
898951 |
1 file changed, 30 insertions(+)
|
|
|
898951 |
|
|
|
898951 |
diff --git a/tools/virsh.pod b/tools/virsh.pod
|
|
|
898951 |
index f1b09d9..c3ae204 100644
|
|
|
898951 |
--- a/tools/virsh.pod
|
|
|
898951 |
+++ b/tools/virsh.pod
|
|
|
898951 |
@@ -1073,6 +1073,36 @@ I<--total> for only the total stats, I<start> for only the per-cpu
|
|
|
898951 |
stats of the CPUs from I<start>, I<count> for only I<count> CPUs'
|
|
|
898951 |
stats.
|
|
|
898951 |
|
|
|
898951 |
+=item B<metadata> I<domain> [[I<--live>] [I<--config>] | [I<--current>]]
|
|
|
898951 |
+[I<--edit>] [I<uri>] [I<key>] [I<set>] [I<--remove>]
|
|
|
898951 |
+
|
|
|
898951 |
+Show or modify custom XML metadata of a domain. The metadata is a user
|
|
|
898951 |
+defined XML that allows to store arbitrary XML data in the domain definition.
|
|
|
898951 |
+Multiple separate custom metadata pieces can be stored in the domain XML.
|
|
|
898951 |
+The pieces are identified by a private XML namespace provided via the
|
|
|
898951 |
+I<uri> argument.
|
|
|
898951 |
+
|
|
|
898951 |
+Flags I<--live> or I<--config> select whether this command works on live
|
|
|
898951 |
+or persistent definitions of the domain. If both I<--live> and I<--config>
|
|
|
898951 |
+are specified, the I<--config> option takes precedence on getting the current
|
|
|
898951 |
+description and both live configuration and config are updated while setting
|
|
|
898951 |
+the description. I<--current> is exclusive and implied if none of these was
|
|
|
898951 |
+specified.
|
|
|
898951 |
+
|
|
|
898951 |
+Flag I<--remove> specifies that the metadata element specified by the I<uri>
|
|
|
898951 |
+argument should be removed rather than updated.
|
|
|
898951 |
+
|
|
|
898951 |
+Flag I<--edit> specifies that an editor with the metadata identified by the
|
|
|
898951 |
+I<uri> argument should be opened and the contents saved back afterwards.
|
|
|
898951 |
+Otherwise the new contents can be provided via the I<set> argument.
|
|
|
898951 |
+
|
|
|
898951 |
+When setting metadata via I<--edit> or I<set> the I<key> argument must be
|
|
|
898951 |
+specified and is used to prefix the custom elements to bind them
|
|
|
898951 |
+to the private namespace.
|
|
|
898951 |
+
|
|
|
898951 |
+If neither of I<--edit> and I<set> are specified the XML metadata corresponding
|
|
|
898951 |
+to the I<uri> namespace is displayed instead of being modified.
|
|
|
898951 |
+
|
|
|
898951 |
=item B<migrate> [I<--live>] [I<--offline>] [I<--direct>] [I<--p2p> [I<--tunnelled>]]
|
|
|
898951 |
[I<--persistent>] [I<--undefinesource>] [I<--suspend>] [I<--copy-storage-all>]
|
|
|
898951 |
[I<--copy-storage-inc>] [I<--change-protection>] [I<--unsafe>] [I<--verbose>]
|
|
|
898951 |
--
|
|
|
898951 |
2.2.2
|
|
|
898951 |
|