summaryrefslogtreecommitdiff
path: root/tools/virsh.pod
diff options
context:
space:
mode:
authorPeter Krempa <pkrempa@redhat.com>2013-05-28 11:07:33 +0200
committerPeter Krempa <pkrempa@redhat.com>2013-06-03 14:23:02 +0200
commit37772499e050b7c9d3f136d8c2e07b67e8ff26d6 (patch)
tree066166e7bc4646045f044ede186da365615a75f9 /tools/virsh.pod
parentf81c95b31f1c1cc95cb7e52cf8af98cbd624e0c1 (diff)
downloadlibvirt-37772499e050b7c9d3f136d8c2e07b67e8ff26d6.tar.gz
virsh-domain: Add --live, --config, --current logic to cmdAttachDisk
Use the approach established in commit 69ce3ffa8d431e9810607c6e00b7cfcc481b491d to improve this function too.
Diffstat (limited to 'tools/virsh.pod')
-rw-r--r--tools/virsh.pod13
1 files changed, 11 insertions, 2 deletions
diff --git a/tools/virsh.pod b/tools/virsh.pod
index 0837224b33..a7e3a8f09a 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -1846,6 +1846,7 @@ results as some fields may be autogenerated and thus match devices other than
expected.
=item B<attach-disk> I<domain> I<source> I<target>
+[[[I<--live>] [I<--config>] | [I<--current>]] | [I<--persistent>]]
[I<--driver driver>] [I<--subdriver subdriver>] [I<--cache cache>]
[I<--type type>] [I<--mode mode>] [I<--config>] [I<--sourcetype soucetype>]
[I<--serial serial>] [I<--shareable>] [I<--rawio>] [I<--address address>]
@@ -1866,8 +1867,6 @@ alternative to the disk default, although this use only replaces the media
within the existing virtual cdrom or floppy device; consider using
B<update-device> for this usage instead.
I<mode> can specify the two specific mode I<readonly> or I<shareable>.
-I<--config> indicates the changes will affect the next boot of the domain,
-for compatibility purposes, I<--persistent> is alias of I<--config>.
I<sourcetype> can indicate the type of source (block|file)
I<cache> can be one of "default", "none", "writethrough", "writeback",
"directsync" or "unsafe".
@@ -1882,6 +1881,16 @@ address.
If I<--print-xml> is specified, then the XML of the disk that would be attached
is printed instead.
+If I<--live> is specified, affect a running domain.
+If I<--config> is specified, affect the next startup of a persistent domain.
+If I<--current> is specified, affect the current domain state.
+Both I<--live> and I<--config> flags may be given, but I<--current> is
+exclusive. When no flag is specified legacy API is used whose behavior depends
+on the hypervisor driver.
+
+For compatibility purposes, I<--persistent> behaves like I<--config> for
+an offline domain, and like I<--live> I<--config> for a running domain.
+
=item B<attach-interface> I<domain> I<type> I<source>
[I<--target target>] [I<--mac mac>] [I<--script script>] [I<--model model>]
[I<--config>] [I<--inbound average,peak,burst>] [I<--outbound average,peak,burst>]