usb_autopm_get_interface(9)

📦 version 7.3.1, in nixpkgs unstable

✨ NAME ✨

okay so bestie, welcome to the usb_autopm_get_interface(9) page from the Kernel API Manual 💖 — this one is literally about incrementing a USB interface’s PM-usage counter. slay.

  • usb_autopm_get_interface — increment a USB interface’s PM-usage counter ✨

🌸 SYNOPSIS 🌸

int usb_autopm_get_interface (struct usb_interface *intf );

🎀 ARGUMENTS 🎀

  • intf — the usb_interface whose counter should be incremented 💅

🦋 DESCRIPTION 🦋

okay so picture this: this routine should be called by an interface driver when it wants to use intf and needs to guarantee that it is not suspended. periodt. in addition, the routine prevents intf from being autosuspended subsequently. 🫶

quick side note, bestie: this will not prevent suspend events originating in the PM core. important detail, no cap. this prevention will persist until usb_autopm_put_interface is called or intf is unbound. a typical example would be a character-device driver when its device file is opened. iconic, honestly. 🌈

intf’s usage counter is incremented to prevent subsequent autosuspends. however, if the autoresume fails then the counter is re-decremented. yep, it backs that thing right back out 😭

⚠️ this routine can run only in process context. process-context only, bestie — that’s the vibe check for this one. 💀

⭐ RETURN ⭐

0 on success. that’s it, that’s the return value 🎀

👑 SEE ALSO 👑

the kernel file is ./drivers/usb/core/driver.c, and the whole linked crew is right here — every single one, bestie, we’re not skipping anybody 💜

🫶💖 signed off from ./drivers/usb/core — October 2026 — for the usb_autopm_get_interface(9) page. bye bestie! ✨

📦 where this page comes from