pcl_alloc_write(9)

💅 pcl_alloc_write — or, how to build a parsed chunk list from a Write list

okay so real quick, context: this is a page from the Kernel API Manual (yes, the kernel has lore, and yes, it's giving ancient scroll energy 🫶). It's pcl_alloc_write(9) and it's lowkey a lil' builder function. Let's get into it, bestie.

---

✨ NAME ✨

pcl_alloc_write — construct a parsed chunk list from a Write list. that's it, that's the whole job. no cap. 🎀

---

🌸 SYNOPSIS 🌸

bool pcl_alloc_write (struct svc_rdma_recv_ctxt *rctxt , struct
svc_rdma_pcl *pcl , __be32 *p );

look at her. three args, returns a bool. main character energy fr fr. ✨

---

🦋 ARGUMENTS 🦋

• rctxt — Ingress receive context. the ~scene of the crime~, i.e. the context this receive came in on. 💖
• pcl — Parsed chunk list to populate. this is the empty lil' list you're gonna fill up, bestie. she starts blank, she ends iconic. 👑
• p — Start of an un-decoded Write list. note the un-decoded part — it's raw, it hasn't had its glow-up yet. 🙈

---

💜 DESCRIPTION 💜

okay so before you even think about calling this, there are Assumptions (yes, capitalized, they're serious):

• The incoming Write list has already been sanity checked. like, somebody already did the vibe check on it, don't skip that step. ⭐
• cl_count is set to the number of chunks in the un-decoded list. it's gotta know how many chunks it's dealing with going in, periodt. 💅

Return values:

• true — Parsed chunk list was successfully constructed. slay! 🎉
• false — Memory allocation failed. 😭 not slay. that's the only failure mode listed here, so if you get a false, blame the allocator.

ngl, the whole bit hinges on those two assumptions up top. if the list wasn't sanity checked or cl_count is wrong, that's a you problem, not a pcl_alloc_write problem. 🫶

---

🌈 SEE ALSO 🌈

• Kernel file ./net/sunrpc/xprtrdma/svc_rdma_pcl.c — that's where she lives 🏠
• pcl_free(9)
• pcl_alloc_call(9)
• pcl_alloc_read(9)
• pcl_check_read_chunk_positions(9)
• pcl_process_nonpayloads(9)

the whole friend group honestly. go read all of them, iykyk. 🧚

---

and that's the page, bestie! 💖 this one shipped out of ./net/sunrpc/xprtrdma and it's dated October 2026 — so yeah, future girl summer. mwah, go allocate responsibly. 🌸💅🔥