usb_reset_device(9)

🌸 NAME 🌸

Okay bestie, welcome to usb_reset_device(9) from the Kernel API Manual 💖. This is the function that warns interface drivers and performs a USB port reset — no cap, that's literally the name vibe. It's giving main-character reset energy ✨.

✨ SYNOPSIS ✨

int usb_reset_device (struct usb_device *udev );

🎀 ARGUMENTS 🎀

• udev — the device to reset (not in NOTATTACHED state). That state name matters, bestie, don't skip it 💅.

🦋 DESCRIPTION 🦋

So here's the tea ☕: usb_reset_device warns all drivers bound to registered interfaces — using their pre_reset method — then performs the port reset, and then lets the drivers know that the reset is over by using their post_reset method. The way it's a whole little driver warning → port reset → driver debrief routine? Obsessed 🫶.

🔥 RETURN 🔥

The return value is the same as for usb_reset_and_verify_device. BUT — and this is the plot twist 😭 — if a reset is already in progress, the routine returns -EINPROGRESS.

When does that happen? For instance, if a driver doesn't have pre_reset or post_reset callbacks, and while being unbound or re-bound during the ongoing reset its disconnect or probe routine tries to perform a second, nested reset. Nested reset? In this economy? Anyway, -EINPROGRESS is the answer, fr fr.

💅 NOTE 💅

The caller must own the device lock. Periodt. 🔒

For example, it's safe to use this from a driver probe routine after downloading new firmware. For calls that might not occur during probe, drivers should lock the device using usb_lock_device_for_reset.

If an interface is currently being probed or disconnected, we assume its driver knows how to handle resets. For all other interfaces, if the driver doesn't have pre_reset and post_reset methods then we attempt to unbind it and rebind afterward. Lowkey a whole unbind-and-rebind situation, but make it USB 🫶.

🌈 SEE ALSO 🌈

• Kernel file ./drivers/usb/core/hub.c
• usb_hub_set_port_power(9)
• usb_hub_clear_tt_buffer(9)
• usb_remove_device(9)
• usb_set_device_state(9)
• usb_disconnect(9)
• usb_enumerate_device_otg(9)
• usb_enumerate_device(9)
• usb_new_device(9)
• usb_deauthorize_device(9)
• get_port_ssp_rate(9)
• usb_root_hub_lost_power(9)
• hub_hc_release_resources(9)
• usb_reset_and_verify_device(9)
• usb_queue_reset_device(9)
• usb_hub_find_child(9)
• usb_get_hub_port_acpi_handle(9)

---

Cute sign-off: source/version is ./drivers/usb/core, dated October 2026 — stay reset-ready, bestie 💖🎀✨