On 01/04/2013 10:25 PM, Guannan Ren wrote:
Add an optional 'type' attribute to <target> element of
serial port
device. There are two choices for its value, 'isa-serial' and
'usb-serial'. For backward compatibility, when attribute 'type' is
missing the 'isa-serial' will be chosen as before.
Libvirt XML sample
<serial type='pty'>
<target type='usb-serial' port='0'/>
<address type='usb' bus='0' port='1'/>
</serial>
qemu commandline:
qemu ${other_vm_args} \
-chardev pty,id=charserial0 \
-device usb-serial,chardev=charserial0,id=serial0,bus=usb.0,port=1
+++ b/docs/formatdomain.html.in
@@ -3677,7 +3677,14 @@ qemu-kvm -net nic,model=? /dev/null
<p>
<code>target</code> can have a <code>port</code>
attribute, which
specifies the port number. Ports are numbered starting from 0. There are
- usually 0, 1 or 2 serial ports.
+ usually 0, 1 or 2 serial ports. There is also an optional
+ <code>type</code> attribute <span class="since">since
1.0.2</span>
+ which has two choices for its value, one is< code>isa-serial</code>,
+ the other is <code>usb-serial</code>. If <code>type</code>
is missing,
+ <code>isa-serial</code> will be used by default. For
<code>usb-serial</code>
+ an optional sub-element <code><address></code> with
+ <code>type='usb'</code>which can tie the device to a
particular controller,
This renders as:
sub-element <address> with type='usb'which can tie
You are missing a space, and it also sounds funny, so I suggest:
s/which / /
@@ -994,6 +1001,8 @@ struct _virDomainChrSourceDef {
/* A complete character device, both host and domain views. */
struct _virDomainChrDef {
int deviceType;
+
+ bool targetTypeAttr;
We still haven't answered the question of whether it is better to update
all tests to add an output of explicit type='isa-serial' even when
omitted on input (and this bool is not needed), or whether your approach
of doing output only when present on input makes more sense. If the
former, then we need a v3 that touches all affected tests; if the
latter, then ACK to this patch with the doc fix.
--
Eric Blake eblake redhat com +1-919-301-3266
Libvirt virtualization library
http://libvirt.org