Skip to content

Enable CONFIG_USB_MON (usbmon) in the OrbStack kernel for USB traffic capture #2800

Open

Description

@yagop

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.

Additional context

  • OrbStack 2.2.5 (bf842321), kernel 7.2.12-orbstack-00394-gbecdd6130068
  • 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.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions