usb-devices(1)

📦
version 020 · 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixos 26.05, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ usb-devices(1) ✨ Linux USB Utilities 💖

💅 NAME

usb-devices — print USB device details 🎀

🧚 SYNOPSIS

usb-devices

🌸 DESCRIPTION

okay so usb-devices is a shell script 🐚 that lets you peek at the USB buses in your system and every device plugged into them 🔌✨

its output is basically a copy of the usb/devices file 📄 which you can normally find under /proc/bus (if usbfs is mounted) or under /sys/kernel/debug (if debugfs is mounted there). the script is mainly for when that file is nowhere to be found 🙈

bestie, the big difference: this script only shows active interfaces (the ones marked with a "*" in the usb/devices file) plus their endpoints 🦋

ngl, sorting can be different and the output format can look different too, so don't be surprised if it doesn't match the file exactly 💀

👑 RETURN VALUE

if sysfs is not mounted, you get a non-zero exit code 😭 so no sysfs, no vibes.

🎀 FILES

  • /sys/bus/usb/devices/usb*
    • this is the part of the sysfs tree the script walks through to put together everything it prints 🌈
  • /proc/bus/usb/devices
    • where the usb/devices file normally lives on Linux kernels before 2.6.31, if usbfs is mounted 🍓
  • /sys/kernel/debug/usb/devices
    • where the usb/devices file normally lives on Linux kernel 2.6.31 and later, if debugfs is mounted 💜

🦋 SEE ALSO

lsusb(8), usbview(8). go check those out, they're iconic 🔥

🫶 AUTHORS

Greg Kroah-Hartman <greg@kroah.com>

Randy Dunlap <rdunlap@xenotime.net>

Frans Pop <elendil@planet.nl>

bestie, this page is from usbutils 💖 dated 23 June 2009 📅 and it's a usb-devices(1) page, so you're all set 🌸 love you, mwah! 😘✨

📦 where this page comes from