usb_free_streams(9)

💅 usb_free_streams(9) — the Kernel API Manual page, bestie edition ✨

okay so you found the usb_free_streams(9) page in the Kernel API Manual and you're like "what does this even do" — don't worry, i got you 🫶

---

✨ NAME ✨

usb_free_streams — free bulk endpoint stream IDs. that's the whole vibe. it's the cleanup girlie 💖

---

🌸 SYNOPSIS 🌸

int usb_free_streams (struct usb_interface *interface , struct
       usb_host_endpoint **eps , unsigned int num_eps , gfp_t mem_flags );

like. look at that signature. four args. int return. she's giving "i've done this before" 👑

---

🎀 ARGUMENTS 🎀

• interface — the alternate setting that includes all the endpoints. like, every single one. she's the group chat admin of this operation 💅
• eps — an array of endpoints to remove streams from. the ones getting un-streamed, if you will 🦋
• num_eps — number of endpoints in that array. yes you have to count them yourself, no she will not do it for you 🙈
• mem_flags — flags the hcd should use to allocate memory. hand her the allocation vibes and she'll run with them ✨

---

🦋 DESCRIPTION 🦋

so what she actually does: reverts a group of bulk endpoints back to not using stream IDs. it's the undo button for streams, the "we're so back to normal" moment 😌

lowkey it can fail tho — if we are given bad arguments, or if the HCD is broken. broken HCD is not a vibe, bestie. fr fr 💀

---

🌈 RETURN 🌈

• 0 on success 🎉 slay, we're free
• on failure, a negative error code 😭 it's giving "something went wrong and she's telling you in the negative"

---

👑 SEE ALSO 👑

the kernel file ./drivers/usb/core/hcd.c — and honestly the whole friend group:

• ascii2desc(9)
• rh_string(9)
• usb_bus_init(9)
• usb_register_bus(9)
• usb_deregister_bus(9)
• register_root_hub(9)
• usb_calc_bus_time(9)
• usb_hcd_link_urb_to_ep(9)
• usb_hcd_check_unlink_urb(9)
• usb_hcd_unlink_urb_from_ep(9)
• usb_hcd_giveback_urb(9)
• usb_hcd_alloc_bandwidth(9)
• usb_hcd_reset_endpoint(9)
• usb_alloc_streams(9)
• usb_hcd_resume_root_hub(9)
• usb_bus_start_enum(9)
• usb_hcd_irq(9)
• usb_hc_died(9)
• usb_create_shared_hcd(9)
• usb_create_hcd(9)
• usb_stop_hcd(9)
• usb_add_hcd(9)
• usb_remove_hcd(9)

like, that's the whole squad right there. usb_alloc_streams(9) is literally her sister function btw — iykyk 💜

---

and that's the page!! 🎀 mwah 💋

shoutout to the fine people at ./drivers/usb/core who shipped this in October 2026 — iconic of them honestly, we stan ⭐🌸💖