cppi5_desc_set_retpolicy(9)

💅 cppi5_desc_set_retpolicy(9) — the Kernel API Manual glow-up 🎀

okay bestie, so you're in the Kernel API Manual (yes, the real one, not a vibe) and this is the page for cppi5_desc_set_retpolicy. Say it three times fast, iykyk. 🌸

---

✨ NAME ✨

cppi5_desc_set_retpolicy — sets the Packet Return Policy in the Desc. That's the whole assignment, no cap. 💅

---

🦋 SYNOPSIS 🦋

void cppi5_desc_set_retpolicy (struct cppi5_desc_hdr_t *desc_hdr , u32
flags , u32 return_ring_id );

look at her. void return, three args, absolutely iconic. 👑

---

🌈 ARGUMENTS 🌈

• desc_hdr — the packet/TR descriptor header. this is the main character of the function, everything happens to her.
• flags — the flags bestie, and here are the supported values you're allowed to pass:
  • CPPI5_INFO2_HDESC_RETPOLICY
  • CPPI5_INFO2_HDESC_EARLYRET
  • CPPI5_INFO2_DESC_RETPUSHPOLICY
• return_ring_id — the Packet Return Queue/Ring id. and listen: the value 0xFFFF is reserved, so don't you dare, that one's taken 🫶

lowkey important: those three flag values are the supported ones. don't freestyle with random bits and then come crying to me 😭

---

💜 SEE ALSO 💜

bestie this list is giving extended universe, grab a snack 🍓 — Kernel file ./include/linux/dma/ti-cppi5.h, plus:

• struct cppi5_desc_hdr_t(9)
• struct cppi5_host_desc_t(9)
• struct cppi5_desc_epib_t(9)
• struct cppi5_monolithic_desc_t(9)
• cppi5_desc_is_tdcm(9)
• cppi5_desc_get_type(9)
• cppi5_desc_get_errflags(9)
• cppi5_desc_get_pktids(9)
• cppi5_desc_set_pktids(9)
• cppi5_desc_get_tags_ids(9)
• cppi5_desc_set_tags_ids(9)
• cppi5_hdesc_calc_size(9)
• cppi5_hdesc_init(9)
• cppi5_hdesc_update_flags(9)
• cppi5_hdesc_update_psdata_size(9)
• cppi5_hdesc_get_psdata_size(9)
• cppi5_hdesc_get_pktlen(9)
• cppi5_hdesc_set_pktlen(9)
• cppi5_hdesc_get_psflags(9)
• cppi5_hdesc_set_psflags(9)
• cppi5_hdesc_get_pkttype(9)
• cppi5_hdesc_set_pkttype(9)
• cppi5_hdesc_attach_buf(9)
• cppi5_hdesc_link_hbdesc(9)
• cppi5_hdesc_epib_present(9)
• cppi5_hdesc_get_psdata(9)
• cppi5_hdesc_get_swdata(9)
• enum cppi5_tr_types(9)
• enum cppi5_tr_event_size(9)
• enum cppi5_tr_trigger(9)
• enum cppi5_tr_trigger_type(9)
• struct cppi5_tr_type0_t(9)
• struct cppi5_tr_type1_t(9)
• struct cppi5_tr_type2_t(9)
• struct cppi5_tr_type3_t(9)
• struct cppi5_tr_type15_t(9)
• struct cppi5_tr_resp_t(9)
• enum cppi5_tr_resp_status_type(9)
• enum cppi5_tr_resp_status_submission(9)
• enum cppi5_tr_resp_status_unsupported(9)
• cppi5_trdesc_calc_size(9)
• cppi5_trdesc_init(9)
• cppi5_tr_init(9)
• cppi5_tr_set_trigger(9)
• cppi5_tr_csf_set(9)

like, the whole friend group showed up. we love a supportive cast 💖

---

that's the page, periodt. this little gem lives in ./include/linux/dma, dated October 2026, and it's filed under cppi5_desc_set_retpolicy(9) — go forth and set those return policies responsibly, bestie 🧚‍♀️⭐