pcl_alloc_read(9)

🌸 pcl_alloc_read(9) 🌸

okay so this little icon is from the Kernel API Manual, and it's here to explain how to construct a parsed chunk list for normal Read chunks. Bestie, it's giving "small function, important job" energy, and we're gonna get into every single detail. 💅

---

✨ NAME ✨

pcl_alloc_read — construct a parsed chunk list for normal Read chunks. Slay. 🎀

---

🦋 SYNOPSIS 🦋

bool pcl_alloc_read (struct svc_rdma_recv_ctxt *rctxt , __be32 *p );

---

💖 ARGUMENTS 💖

• rctxt — the ingress receive context, aka the place where the incoming receive vibe lives. ✨
• p — the start of an un-decoded Read list. It's literally the beginning of the list before anybody has decoded it. 🫶

---

🌈 DESCRIPTION 🌈

okay so before we go anywhere, here are the assumptions — read the room, bestie:

• The incoming Read list has already been sanity checked. ✅
• cl_count is already set to the number of segments in the un-decoded list. 🔢
• The list might not be in order by position. So do not assume it's sorted, fr fr. 🙈

Return values, no cap:

• true: the parsed chunk list was successfully constructed, and cl_count is updated to be the number of chunks (ie. unique position values) in the Read list. Iconic. 👑
• false: memory allocation failed. 😭

---

🧚 SEE ALSO 🧚

The kernel file ./net/sunrpc/xprtrdma/svc_rdma_pcl.c is the main character here, and these besties are also in the group chat:

• pcl_free(9)
• pcl_alloc_call(9)
• pcl_alloc_write(9)
• pcl_check_read_chunk_positions(9)
• pcl_process_nonpayloads(9)

---

Signed off from ./net/sunrpc/xprtrdma, dated October 2026 — mwah 💋✨