rproc_coredump(9)

🦋 rproc_coredump(9) — Kernel API Manual, bestie edition ✨

okay so this is rproc_coredump(9) from the Kernel API Manual and it's genuinely one of those little functions that does a LOT behind the scenes. coredump but for a remote processor? yes ma'am. let's get into it 💅

---

✨ NAME ✨

rproc_coredump — perform coredump 🫶

---

🌸 SYNOPSIS 🌸

void rproc_coredump (struct rproc *rproc );

---

🎀 ARGUMENTS 🎀

• rproc — the rproc handle, aka your main character pointer. you pass it in, it does the thing 💖

---

🔥 DESCRIPTION 🔥

okay so picture this: this function is gonna generate an ELF header for all the registered segments, and then it creates a devcoredump device that's associated with rproc. iconic behavior, honestly.

and then — based on the coredump configuration — it does one of two vibes:

1. direct mode 🚀 — it copies the segments straight from device memory to userspace. no middleman, no extra buffer, we love a direct path.
2. buffered mode 🧺 — it copies the segments from device memory into a separate buffer, and then userspace can read from that buffer whenever it's ready.

now, about that first approach — the direct one — it's lowkey the memory-efficient queen 👑 because it avoids using extra vmalloc memory. no cap, that's the whole selling point. but (and this is the part you need to know, bestie) it will stall the recovery flow until the dump is actually read by userspace. so like… it's sitting there waiting on userspace to come collect. the tradeoff is real 😭

⚠️ reminder: direct copy = no extra vmalloc memory, but recovery flow stalls until userspace reads the dump. pick your fighter accordingly 🥊

---

💜 SEE ALSO 💜

• Kernel file ./drivers/remoteproc/remoteproc_coredump.c — go read the source, iykyk 📖
• rproc_coredump_cleanup(9)
• rproc_coredump_add_segment(9)
• rproc_coredump_add_custom_segment(9)
• rproc_coredump_set_elf_info(9)
• rproc_coredump_using_sections(9)

all the siblings, all in the family, go say hi 🌈

---

and that's the page, bestie!! 🎀 this one lives in ./drivers/remoteproc and it's dated October 2026 — so like, future vibes only ⭐ thanks for reading rproc_coredump(9), mwah 💋🧚