1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="usbtrafficcapturing">
<title>Capturing USB Traffic for Selected Devices</title>
<body>
<p>You can capture USB traffic for single USB devices or on the root hub level, which captures the traffic of all
USB devices attached to the root hub. <ph conkeyref="vbox-conkeyref-phrases/product-name"/> stores the traffic in
a format which is compatible with Wireshark. To capture the traffic of a specific USB device it must be attached
to the VM with <userinput>VBoxManage</userinput> using the following command: </p>
<pre xml:space="preserve">VBoxManage controlvm <varname>VM-name</varname> usbattach <varname>device uuid</varname>|<varname>address</varname> --capturefile <varname>filename</varname>
</pre>
<p>In order to enable capturing on the root hub use the following command while the VM is not running: </p>
<pre xml:space="preserve">VBoxManage setextradata <varname>VM-name</varname> \
VBoxInternal/Devices/usb-ehci/0/LUN#0/Config/CaptureFilename <varname>filename</varname>
</pre>
<p>The command above enables capturing on the root hub attached to the EHCI controller. To enable it for the OHCI or
XHCI controller replace <codeph>usb-ehci</codeph> with <codeph>usb-ohci</codeph> or <codeph>usb-xhci</codeph>,
respectively. </p>
</body>
</topic>
|
