Bug#565573: qemu-kvm: manpage doesn't mention "-incoming"

[Michael Tokarev]

tags 565573 + pending
tags 565573 - patch
thanks

17.01.2010 07:53, Leo 'costela' Antunes wrote:

Package: qemu-kvm
Version: 0.11.1-2
Severity: minor

Hi,

The current manpage for qemu doesn't mention the "-incoming" switch,
used for live migrations.
Upstream seems to not have included it in their online documentation either.

Small patch included for consideration! :)


Thank you Leo for the patch.  This is not how things should be done:
the manpage is generated from another set of files, so that the
-help option and the manpage will show the same information.
Take a look at qemu-options.hx file in the source tree -- there
are _many_ options which aren't documented (that's all the
options which has empty "STEXI..ETEXI" sections in that file).
-incoming is one of them.

I'll add the -incoming description to qemu-options.hx for the
next upload, which will close this bugreport, but the documentation
is still far from complete...

(Tagging as -patch since the patch is to the wrong file ;)

Thanks!

/mjt



--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Bug#565573: qemu-kvm: manpage doesn't mention "-incoming"

[Leo 'costela' Antunes]

Package: qemu-kvm
Version: 0.11.1-2
Severity: minor

Hi,

The current manpage for qemu doesn't mention the "-incoming" switch,
used for live migrations.
Upstream seems to not have included it in their online documentation either.

Small patch included for consideration! :)


Cheers

-- 
Leo "costela" Antunes
[insert a witty retort here]

--- old/kvm.1	2010-01-17 05:42:15.0 +0100
+++ new/kvm.1	2010-01-17 05:50:58.0 +0100
@@ -1266,6 +1266,9 @@
 .IP "\fB\-S\fR" 4
 .IX Item "-S"
 Do not start \s-1CPU\s0 at startup (you must type 'c' in the monitor).
+.IP "\fB\-incoming\fR \fIproto:ip:port\fR" 4
+.IX Item "-incoming"
+Do not start \s-1CPU\s0 at startup, instead wait for migration from another host. Migrations must be started in the origin host with the monitor command \fBmigrate [-d]\fR \fIproto:ip:port\fR.
 .IP "\fB\-gdb\fR \fIdev\fR" 4
 .IX Item "-gdb dev"
 Wait for gdb connection on device \fIdev\fR. Typical