VirtualBox

source: vbox/trunk/doc/manual/en_US/dita/topics/usbtrafficcapturing.dita@ 105388

Last change on this file since 105388 was 105335, checked in by vboxsync, 8 months ago

FE/Qt: bugref:10705. Merging r6149 from doc team's repo.

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

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette