diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 503685fe59d42a0496dbe491b018281b35c43ec2..fc32c705498cf25a67b774580b72412c6b1d0683 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -2136,6 +2136,10 @@ <redirdev bus='usb' type='tcp'> <source mode='connect' host='localhost' service='4000'/> </redirdev> + <redirfilter> + <usbdev class='0x08' vendor='0x1234' product='0xbeef' version='2.00' allow='yes'/> + <usbdev allow='no'/> + </redirfilter> </devices> ... @@ -2152,21 +2156,27 @@ tunnel; type='tcp' or type='spicevmc' (which uses the usbredir channel of a SPICE graphics - device) are typical. - + device) are typical.The redirdev element has an optional + sub-element<address> which can tie the + device to a particular controller. Further sub-elements, + such as <source>, may be required according + to the given type, although a <target> sub-element + is not required (since the consumer of the character device is + the hypervisor itself,rather than a device visible in the guest). + +
redirfilter
+
The redirfilter element is used for creating the + filter rule to filter out certain devices from redirection. + It uses sub-element <usbdev>to define each filter rule. + classattribute is the USB Class code, for example, + 0x08 represents mass storage devices. The USB device can be addressed by + vendor / product id using thevendor and product attributes. + version is the bcdDevice value of USB device, such as 1.00, 1.10 and 2.00. + These four attributes are optional and -1 can be used to allow + any value for them. allowattribute is mandatory, + 'yes' means allow, 'no' for deny. +
-

- The redirdev element has an optional sub-element - <address> which can tie the device to a - particular controller. -

-

- Further sub-elements, such as <source>, may - be required according to the given type, although - a <target> sub-element is not required (since - the consumer of the character device is the hypervisor itself, - rather than a device visible in the guest). -

Smartcard devices