usb_reset_configuration(9)

🌸 NAME 🌸

okay so bestie, this is usb_reset_configuration from the Kernel API Manual 💅 and it is literally a lightweight device reset. no cap.

---

✨ SYNOPSIS ✨

int usb_reset_configuration (struct usb_device *dev );

---

🎀 ARGUMENTS 🎀

• dev — the device whose configuration is being reset. that’s the one, bestie 🫶

---

🦋 DESCRIPTION 🦋

Okay so what this does: it issues a standard SET_CONFIGURATION request to the device using the current configuration. The effect is to reset most USB-related state in the device, including:

• interface altsettings — reset to zero
• endpoint halts — cleared
• endpoint state — only for bulk and interrupt endpoints

Other usbcore state is unchanged, including bindings of usb device drivers to interfaces. not me pointing that out, but yes 💖

Because this affects multiple interfaces, avoid using this with composite (multi-interface) devices. Instead, the driver for each interface may use usb_set_interface on the interfaces it claims. Be careful though; some devices don’t support the SET_INTERFACE request, and others won’t reset all the interface state (notably endpoint state). Resetting the whole configuration would affect other drivers’ interfaces. 💀

The caller must own the device lock. fr fr.

If this routine fails the device will probably be in an unusable state with endpoints disabled, and interfaces only partially enabled. 🫠 so yeah, that’s the dramatic part.

---

🔥 RETURN 🔥

Zero on success, else a negative error code. that’s it, that’s the whole return vibe ✨

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/usb/core/message.c — and these besties right here:

• usb_control_msg(9)
• usb_control_msg_send(9)
• usb_control_msg_recv(9)
• usb_interrupt_msg(9)
• usb_bulk_msg(9)
• usb_bulk_msg_killable(9)
• usb_sg_init(9)
• usb_sg_wait(9)
• usb_sg_cancel(9)
• usb_get_descriptor(9)
• usb_get_string(9)
• usb_string(9)
• usb_cache_string(9)
• usb_get_status(9)
• usb_clear_halt(9)
• usb_disable_endpoint(9)
• usb_reset_endpoint(9)
• usb_disable_interface(9)
• usb_disable_device(9)
• usb_enable_endpoint(9)
• usb_enable_interface(9)
• usb_set_interface(9)
• usb_set_wireless_status(9)
• usb_driver_set_configuration(9)
• cdc_parse_cdc_header(9)

---

source/version: ./drivers/usb/core · date: October 2026 — mwah, go reset something cute 💋💖