next_desc(9)

💅 next_desc(9) — like, the Kernel API Manual page you actually wanna read 🎀

okay so bestie, this is next_desc(9) from the Kernel API Manual and it's literally a tiny little iterator helper for USB gadget descriptor arrays. lowkey one of those pages where the whole thing fits in a text message, but we're gonna make it cute anyway ✨

---

🦋 NAME 🦋

next_desc — advance to the next desc_type descriptor. that's it. that's the whole job. she's a one-trick pony and she ate 💅

---

🌸 SYNOPSIS 🌸

struct usb_descriptor_header** next_desc (struct usb_descriptor_header
**t , u8 desc_type );

that's the whole signature, no cap — note the double pointer energy, she's giving ** twice because she's dramatic like that 🔥

---

✨ ARGUMENTS ✨

• t — currect pointer within descriptor array. yes, "currect" — that's a typo straight from the original manpage, screenshot it and put it in the group chat 😭 (the actual meaning: it's your current pointer, chugging along inside the descriptor array)
• desc_type — descriptor type. the thing you're hunting for. the vibe you're looking for in the crowd 🕵️‍♀️

---

🫶 RETURN 🫶

next desc_type descriptor or NULL. if she finds one she hands it to you, and if she doesn't, you get NULL — no consolation prize, no explanation, just NULL 😭

---

💖 DESCRIPTION 💖

Iterate over t until either desc_type descriptor found or NULL (that indicates end of list) encountered.

basically she walks the array for you, step by step, checking vibe after vibe, and she keeps going until she either finds the desc_type you asked for or smacks into a NULL — which is the universal signal for "end of list, ma'am, nothing more to see here" 🎀

like a bestie scanning the party for the one person you actually came to see, and if they're not there she just shrugs and reports back NULL 🙈

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/usb/gadget/composite.c and, like, the entire extended USB gadget family — she runs with a big crew 👑:

• struct usb_os_string(9)
• function_descriptors(9)
• config_ep_by_speed_and_alt(9)
• config_ep_by_speed(9)
• usb_add_function(9)
• usb_function_deactivate(9)
• usb_function_activate(9)
• usb_interface_id(9)
• usb_func_wakeup(9)
• bos_desc(9)
• usb_add_config(9)
• usb_string_id(9)
• usb_string_ids_tab(9)
• usb_gstrings_attach(9)
• usb_string_ids_n(9)
• usb_composite_probe(9)
• usb_composite_unregister(9)
• usb_composite_setup_continue(9)

---

fr fr go read the others too, this whole lil friend group lives in ./drivers/usb/gadget and they all reference each other, iykyk 🦋

---

k bye bestie, this page came to you from ./drivers/usb/gadget, dated October 2026, signed next_desc(9) — slay, stay hydrated, and may all your pointers find their descriptor 💜✨🎀