usb_gadget_deactivate(9)

💖 NAME 💖

usb_gadget_deactivate(9) — from the Kernel API Manual, bestie — is literally the routine for deactivating a function which is not ready to work. No cap. 💅

✨ SYNOPSIS ✨

int usb_gadget_deactivate (struct usb_gadget *gadget );

🫶 ARGUMENTS 🫶

• gadget — the peripheral being deactivated. That's the one catching this whole deactivation vibe. 🎀

🔥 DESCRIPTION 🔥

Okay so this routine may be used during the gadget driver bind call to prevent the peripheral from ever being visible to the USB host, unless later usb_gadget_activate is called. Periodt. For example, user mode components may need to be activated before the system can talk to hosts.

⚠️ Sleep warning, bestie: this routine may sleep; it must not be called in interrupt context (such as from within a gadget driver's disconnect callback). Like, do not do it. 😭

It returns zero on success, else negative errno. Slay.

🌈 SEE ALSO 🌈

• Kernel file ./drivers/usb/gadget/udc/core.c and struct usb_udc(9) — the source-side crew.
• usb_ep_set_maxpacket_limit(9)
• usb_ep_enable(9)
• usb_ep_disable(9)
• usb_ep_alloc_request(9)
• usb_ep_free_request(9)
• usb_ep_queue(9)
• usb_ep_dequeue(9)
• usb_ep_set_halt(9)
• usb_ep_clear_halt(9)
• usb_ep_set_wedge(9)
• usb_ep_fifo_status(9)
• usb_ep_fifo_flush(9)
• usb_gadget_frame_number(9)
• usb_gadget_wakeup(9)
• usb_gadget_set_remote_wakeup(9)
• usb_gadget_set_selfpowered(9)
• usb_gadget_clear_selfpowered(9)
• usb_gadget_vbus_connect(9)
• usb_gadget_vbus_draw(9)
• usb_gadget_vbus_disconnect(9)
• usb_gadget_connect(9)
• usb_gadget_disconnect(9)
• usb_gadget_activate(9)
• usb_gadget_giveback_request(9)
• gadget_find_ep_by_name(9)
• usb_gadget_check_config(9)
• usb_udc_vbus_handler(9)
• usb_gadget_udc_reset(9)
• usb_gadget_udc_start_locked(9)
• usb_gadget_udc_stop_locked(9)
• usb_gadget_udc_set_speed(9)
• usb_gadget_enable_async_callbacks(9)
• usb_gadget_disable_async_callbacks(9)
• usb_udc_release(9)
• usb_initialize_gadget(9)
• usb_add_gadget(9)
• usb_add_gadget_udc_release(9)
• usb_get_gadget_udc_name(9)
• usb_add_gadget_udc(9)
• usb_del_gadget(9)
• usb_del_gadget_udc(9)

Catch you later, bestie! This page is chilling in the ./drivers/usb/gadget/udc source/version corner, dated October 2026, and it's all about usb_gadget_deactivate(9). 💖✨🎀