cppi5_hdesc_init(9)

💖 cppi5_hdesc_init — a Kernel API Manual moment ✨

okay so bestie, welcome to the glow-up of cppi5_hdesc_init(9) from the Kernel API Manual — this is the little guy that sets up the size of a Host Packet Descriptor, and honestly? she's lowkey iconic. let's get into it 🎀

---

✨ NAME ✨

cppi5_hdesc_init — Init Host Packet Descriptor size 🦋

---

🌸 SYNOPSIS 🌸

void cppi5_hdesc_init (struct cppi5_host_desc_t *desc , u32 flags , u32
psdata_size );

that's the whole vibe check right there, no cap 💅

---

🎀 ARGUMENTS 🎀

• desc — the Host packet descriptor, your main character 💖
• flags — the supported values are CPPI5_INFO0_HDESC_EPIB_PRESENT and CPPI5_INFO0_HDESC_PSINFO_LOCATION, pick your fighters 🫶
• psdata_size — the PSDATA size, periodt ✨

---

🔥 DESCRIPTION 🔥

so here's the tea: you get back the required Host Packet Descriptor size, and that's 0 — zero, nada, the whole thing — if PSDATA > CPPI5_INFO0_HDESC_PSDATA_MAX_SIZE. the way that max size is literally the line you do not cross 😭

fr fr, clock that 0 return — it's giving "too much PSDATA, bestie" and it is not a drill 💀

---

🦋 SEE ALSO 🦋

It's all in the Kernel file ./include/linux/dma/ti-cppi5.h, and the whole friend group is here:

• 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_set_retpolicy(9)
• cppi5_desc_get_tags_ids(9)
• cppi5_desc_set_tags_ids(9)
• cppi5_hdesc_calc_size(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, that's the entire group chat and they all ate 💅👑

---

okayyy that's the page 🎀 this gem lives in ./include/linux/dma, and the version stamp is October 2026 — so jot that down, bestie, and go init some descriptors 💖✨🌸