hw_test_and_set_setup_guard(9)

✨ hw_test_and_set_setup_guard(9) ✨

okay so bestie, welcome to the Kernel API Manual 💖 this one's a tiny little function from the chipidea USB gadget world, and honestly? it's giving "small but mighty" 🎀

---

🌸 NAME 🌸

hw_test_and_set_setup_guard — test & set setup guard (execute without interruption) 💅

like, it tests the thing AND sets the thing, and it does it without interruption. no cap. ✨

---

🦋 SYNOPSIS 🦋

int hw_test_and_set_setup_guard (struct ci_hdrc *ci );

that's the whole signature, bestie — returns an int, takes one pointer. slay. 🫶

---

🎀 ARGUMENTS 🎀

• ci — the controller 👑

that's it. that's the argument. one (1) controller, and she's the main character. 🌈

---

⭐ DESCRIPTION ⭐

okay so here's the tea 🍓: this function returns guard value. literally that's what the manpage says and i'm not about to invent lore, so. guard value. returned. periodt. 💀

---

💜 SEE ALSO 💜

the kernel file lives at ./drivers/usb/chipidea/udc.c — go look, iykyk 🔥

and here's the whole friend group, all the related pages, in order, not one of them skipped because we don't do that here 🧚:

• hw_ep_bit(9)
• hw_device_state(9)
• hw_ep_flush(9)
• hw_ep_disable(9)
• hw_ep_enable(9)
• hw_ep_get_halt(9)
• hw_ep_prime(9)
• hw_ep_set_halt(9)
• hw_port_is_high_speed(9)
• hw_test_and_clear_complete(9)
• hw_test_and_clear_intr_active(9)
• hw_test_and_clear_setup_guard(9)
• hw_usb_set_address(9)
• hw_usb_reset(9)
• _usb_addr(9)
• _hardware_enqueue(9)
• free_pending_td(9)
• _hardware_dequeue(9)
• _ep_nuke(9)
• _gadget_stop_activity(9)
• isr_reset_handler(9)
• isr_get_status_complete(9)
• _ep_queue(9)
• isr_get_status_response(9)
• isr_setup_status_complete(9)
• isr_setup_status_phase(9)
• isr_tr_complete_low(9)
• isr_setup_packet_handler(9)
• isr_tr_complete_handler(9)
• ci_udc_start(9)
• udc_start(9)
• udc_stop(9)
• ci_hdrc_gadget_init(9)

also note the sibling energy: hw_test_and_clear_setup_guard(9) is right there in the list, and hw_test_and_set_setup_guard(9) is the one you're reading. two icons. don't mix them up 💅

---

that's the page, bestie! 🌸 this one came out of ./drivers/usb/chipidea, dated October 2026, and it's filed under hw_test_and_set_setup_guard(9) in the Kernel API Manual — mwah, go read the source, ily, bye 🎀💖🦋