usbreset(1)

✨ usbreset — the glow-up your sad little USB device needed ✨

okay so bestie, this is usbreset, a utility from the Linux USB Utilities crew, and it's here to do exactly one thing: send a USB port reset to a USB device. that's the whole vibe. no cap.

---

🌸 SYNOPSIS 🌸

usbreset [ device ]

like... give it a device and it resets it. or don't. we'll get to that 💅

---

💖 DESCRIPTION 💖

usbreset is a utility that performs resets on USB devices. it's particularly useful when a USB device is being unresponsive or acting erratic — you know the type, main character energy but for all the wrong reasons 😭. when your device is ghosting you, this is how you make it reply.

the USB device you wanna reset can be specified in one of three formats — well, technically four ways are listed, and we are NOT gatekeeping any of them:

• VVVV:PPPP — reset by vendor and product IDs. the classic. the moment.
• BBB/DDD — reset by bus and device number. bus first, device second, slash between. slay.
• SN:SERIAL — reset by serial number. prefix SN: included, don't forget it 🎀
• Product — reset by product name. yes, literally just the name. iconic.

and when you run it with no arguments at all? it gives you usage information and a list of connected USB devices, including their:

• vendor and product IDs
• bus and device numbers
• product names

so it's lowkey a lil' vibes check on everything plugged in 🦋

---

⭐ RETURN VALUE ⭐

if the device you asked for isn't found, you get a non-zero exit code. that's it, that's the whole rule. no device, no success, periodt.

---

🔥 EXAMPLES 🔥

reset device with vendor ID 1234 and product ID 5678:

usbreset 1234:5678

reset device 002 on bus 001:

usbreset 001/002

reset device with serial number ABCDEF0:

usbreset SN:ABCDEF0

reset device named USB2.0 Hub:

usbreset "USB2.0 Hub"

note the quotes on that last one bestie — "USB2.0 Hub" has a space in it, and the shell will absolutely split that on you if you don't wrap it. protect the name 💅

---

🌈 SEE ALSO 🌈

lsusb(8) — go look at your devices before you go resetting them, iykyk 🫶

---

👑 AUTHOR 👑

Alan Stern <stern@rowland.harvard.edu> — the legend, the blueprint, the moment 💜

---

okay and for the cute sign-off: this whole thing comes to you from usbutils, dated 04 January 2024. that's the source, that's the version, that's the date, we stan a documented release 🎀✨ bye bestie, go reset something 🦋