[PATCH] doc: Better documentation about the usbdevice=['host:bus.addr'] format

[PATCH] doc: Better documentation about the usbdevice=['host:bus.addr'] format

[Anthony PERARD]

Signed-off-by: Anthony PERARD <anthony.perard@citrix.com>
---
 docs/man/xl.cfg.pod.5 | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/man/xl.cfg.pod.5 b/docs/man/xl.cfg.pod.5
index 9941395..9c0b438 100644
--- a/docs/man/xl.cfg.pod.5
+++ b/docs/man/xl.cfg.pod.5
@@ -1251,6 +1251,10 @@ Host devices can also be passed through in this way, by specifying
 host:USBID, where USBID is of the form xxxx:yyyy.  The USBID can
 typically be found by using lsusb or usb-devices.
 
+If you wish to use the "host:bus.addr" format, remove any leading '0' from the
+bus and addr. For example, for the USB device on bus 008 dev 002, you will
+write "host:8.2".
+
 The form usbdevice=DEVICE is also accepted for backwards compatibility.
 
 More valid options can be found in the "usbdevice" section of the qemu
-- 
Anthony PERARD

Re: [PATCH] doc: Better documentation about the usbdevice=['host:bus.addr'] format

[Ian Campbell]

On Tue, 2014-01-28 at 16:03 +0000, Anthony PERARD wrote:
> Signed-off-by: Anthony PERARD <anthony.perard@citrix.com>
> ---
>  docs/man/xl.cfg.pod.5 | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/docs/man/xl.cfg.pod.5 b/docs/man/xl.cfg.pod.5
> index 9941395..9c0b438 100644
> --- a/docs/man/xl.cfg.pod.5
> +++ b/docs/man/xl.cfg.pod.5
> @@ -1251,6 +1251,10 @@ Host devices can also be passed through in this way, by specifying
>  host:USBID, where USBID is of the form xxxx:yyyy.  The USBID can
>  typically be found by using lsusb or usb-devices.
>  
> +If you wish to use the "host:bus.addr" format, remove any leading '0' from the
> +bus and addr. For example, for the USB device on bus 008 dev 002, you will
> +write "host:8.2".

I tweaked this to "you should write...", then acked + applied.

Thanks.

Re: [PATCH] doc: Better documentation about the usbdevice=['host:bus.addr'] format

[Ian Campbell]

graft 15 <1390924983-4864-1-git-send-email-anthony.perard@citrix.com>
thanks

On Tue, 2014-02-04 at 15:52 +0000, Ian Campbell wrote:
> On Tue, 2014-01-28 at 16:03 +0000, Anthony PERARD wrote:
> > Signed-off-by: Anthony PERARD <anthony.perard@citrix.com>
> > ---
> >  docs/man/xl.cfg.pod.5 | 4 ++++
> >  1 file changed, 4 insertions(+)
> > 
> > diff --git a/docs/man/xl.cfg.pod.5 b/docs/man/xl.cfg.pod.5
> > index 9941395..9c0b438 100644
> > --- a/docs/man/xl.cfg.pod.5
> > +++ b/docs/man/xl.cfg.pod.5
> > @@ -1251,6 +1251,10 @@ Host devices can also be passed through in this way, by specifying
> >  host:USBID, where USBID is of the form xxxx:yyyy.  The USBID can
> >  typically be found by using lsusb or usb-devices.
> >  
> > +If you wish to use the "host:bus.addr" format, remove any leading '0' from the
> > +bus and addr. For example, for the USB device on bus 008 dev 002, you will
> > +write "host:8.2".
> 
> I tweaked this to "you should write...", then acked + applied.

There is an associated bug but I think it should remain open until the
underlying issue is fixed, rather than just documented as suggested
here.

If you think this issue should be closed please send email to xen-devel
+ bcc xen@bugs.xenproject.org which begins:
        close 15
        thanks
(unindented)

Ian.

Processed: Re: [PATCH] doc: Better documentation about the usbdevice=['host:bus.addr'] format

[xen]

Processing commands for xen@bugs.xenproject.org:

> graft 15 <1390924983-4864-1-git-send-email-anthony.perard@citrix.com>
Graft `<1390924983-4864-1-git-send-email-anthony.perard@citrix.com>' onto #15
> thanks
Finished processing.

Modified/created Bugs:
 - 15: http://bugs.xenproject.org/xen/bug/15

---
Xen Hypervisor Bug Tracker
See http://wiki.xen.org/wiki/Reporting_Bugs_against_Xen for information on reporting bugs
Contact xen-bugs-owner@bugs.xenproject.org with any infrastructure issues