You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Enable CONFIG_USB_MON (usbmon) in the OrbStack kernel for USB traffic capture #2800
Is your feature request related to a problem? Please describe.
USB passthrough (orb usb attach) works well for getting devices into containers, but there is no way to capture USB traffic for an attached device from Linux. The OrbStack kernel is built without usbmon: there is no /dev/usbmon* or /sys/kernel/debug/usb/usbmon, usbmon is not in modules.builtin or /lib/modules, and /proc/kallsyms has no usb_mon_* symbols. Because the usbmon hooks live in usbcore (hcd.c) and are only compiled in when CONFIG_USB_MON is set, building usbmon.ko out-of-tree isn't possible either. Users cannot enable this themselves.
Without usbmon, the standard Linux tools for debugging USB devices (tcpdump -i usbmonN, Wireshark, tshark) can't be used on devices passed through to OrbStack. This blocks protocol, driver development, and debugging of anything that talks to a USB device.
Describe the solution you'd like
Build the OrbStack kernel with CONFIG_USB_MON=m (or =y), so that:
modprobe usbmon # if built as a module
tcpdump -i usbmon0 -w capture.pcap
works from a privileged container or machine, the same as on a stock Linux distro. The overhead when unused is negligible: the hooks are a no-op until a reader opens a usbmon device.
Describe alternatives you've considered
Userspace logging (e.g. LIBUSB_DEBUG=4): shows only the transactions of one libusb-based program, not a real bus capture (no kernel-driver traffic, no pcap, no accurate timing).
Capturing on macOS (Wireshark + XHC* interfaces): needs SIP changes on recent macOS.
A separate Linux VM (Lima/UTM/QEMU) with USB passthrough: works, but defeats the point of using OrbStack's USB passthrough.
CONFIG_MODULES=y, CONFIG_DEBUG_FS=y; the USB stack (usbcore, usb_storage, uas) is present.
usbmon would help with every device class the USB passthrough docs list as supported: serial adapters, Android/adb, FIDO keys, network adapters, SDRs, lab instruments.
Activity