summaryrefslogtreecommitdiffstats
path: root/docs/system
diff options
context:
space:
mode:
authorGerd Hoffmann2022-07-11 11:44:37 +0200
committerGerd Hoffmann2022-07-19 14:36:42 +0200
commit04fcb215b8e61042ecd592f4920fe96faf3de36b (patch)
tree9229b5c36d79836357df03ab422be7552d64e52e /docs/system
parentusb: document guest-reset and guest-reset-all (diff)
downloadqemu-04fcb215b8e61042ecd592f4920fe96faf3de36b.tar.gz
qemu-04fcb215b8e61042ecd592f4920fe96faf3de36b.tar.xz
qemu-04fcb215b8e61042ecd592f4920fe96faf3de36b.zip
usb: document pcap (aka usb traffic capture)
Signed-off-by: Gerd Hoffmann <kraxel@redhat.com> Message-Id: <20220711094437.3995927-3-kraxel@redhat.com> Signed-off-by: Gerd Hoffmann <kraxel@redhat.com>
Diffstat (limited to 'docs/system')
-rw-r--r--docs/system/devices/usb.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/system/devices/usb.rst b/docs/system/devices/usb.rst
index 18e7c8b4d7..f39a88f080 100644
--- a/docs/system/devices/usb.rst
+++ b/docs/system/devices/usb.rst
@@ -382,3 +382,15 @@ What works best pretty much depends on the behavior of the specific
usb device at hand, so it's a trial-and-error game. If the default
doesn't work, try another option and see whenever the situation
improves.
+
+record usb transfers
+^^^^^^^^^^^^^^^^^^^^
+
+All usb devices have support for recording the usb traffic. This can
+be enabled using the ``pcap=<file>`` property, for example:
+
+``-device usb-mouse,pcap=mouse.pcap``
+
+The pcap files are compatible with the linux kernels usbmon. Many
+tools, including ``wireshark``, can decode and inspect these trace
+files.