ocxl_function_fetch_afu(9)

💅 ocxl_function_fetch_afu(9) 🦋

okay so this is a page straight out of the Kernel API Manual, and honestly? it's a little one but it's lowkey iconic. it's called ocxl_function_fetch_afu and it literally just… fetches an AFU instance from an OpenCAPI function. that's the whole vibe. let's get into it ✨

---

🌸 NAME 🌸

ocxl_function_fetch_afu — bestie, it fetches an AFU instance from an OpenCAPI function. no cap, that's the job.

---

✨ SYNOPSIS ✨

struct ocxl_afu * ocxl_function_fetch_afu (struct ocxl_fn *fn , u8 afu_idx );

---

🎀 ARGUMENTS 🎀

• fn — the OpenCAPI function you're pulling the AFU out of. your main character function, basically. the source of truth.
• afu_idx — the index of the AFU you want. which one? this number. a u8, so keep it smol 💅

---

💖 DESCRIPTION 💖

so if it works out — and we're manifesting that it does — the AFU you got back is yours now, and you gotta release it with ocxl_afu_put. like returning a library book but make it kernel. don't just ghost it, that's rude 🫶

it returns a pointer to the AFU, or NULL on error. that's it. NULL means it didn't slay, and you should handle that accordingly 😭

---

👑 SEE ALSO 👑

the whole friend group, gathered for the function's kernel file ./include/misc/ocxl.h:

• ocxl_function_open(9)
• ocxl_function_afu_list(9)
• ocxl_afu_get(9)
• ocxl_afu_put(9)
• ocxl_function_config(9)
• ocxl_function_close(9)
• ocxl_context_alloc(9)
• ocxl_context_free(9)
• ocxl_context_attach(9)
• ocxl_context_detach(9)
• ocxl_afu_irq_alloc(9)
• ocxl_afu_irq_free(9)
• ocxl_afu_irq_get_addr(9)
• ocxl_irq_set_handler(9)
• ocxl_afu_config(9)
• ocxl_afu_set_private(9)
• ocxl_afu_get_private(9)
• ocxl_global_mmio_read32(9)
• ocxl_global_mmio_read64(9)
• ocxl_global_mmio_write32(9)
• ocxl_global_mmio_write64(9)
• ocxl_global_mmio_set32(9)
• ocxl_global_mmio_set64(9)
• ocxl_global_mmio_clear32(9)
• ocxl_global_mmio_clear64(9)

---

aaaand that's the whole page, babes 💜 this little gem lives in ./include/misc and it's stamped October 2026 — ocxl_function_fetch_afu(9), mwah, go fetch 🧚⭐