r535_gsp_retain_logging(9)

🌸 r535_gsp_retain_logging — the manual page, but make it make sense ✨

okay bestie, so this page is about r535_gsp_retain_logging, and it lives in the Kernel API Manual, section 9 (that's kernel-land, iykyk). It's a lil function with big "save the receipts" energy 💅

---

🌈 SYNOPSIS

void r535_gsp_retain_logging (struct nvkm_gsp *gsp );

returns nothing, takes one thing. short and sweet, periodt.

---

🎀 ARGUMENTS

• gsp — the gsp pointer 🫶 that's it, that's the whole argument list.

---

💖 DESCRIPTION

okay so here's the vibe check: if keep_gsp_logging is enabled, then we want to preserve the GSP-RM logging buffers and their debugfs entries. but plot twist 😭 — all those objects would normally get deleted if GSP-RM fails to load. so we swoop in and save them before that happens. main character energy fr.

to preserve the logging buffers, we need to do these things:

1. Allocate new buffers and copy the logs into them, so that the original DMA buffers can be released. (like moving your notes into a new notebook so you can hand back the old one 🍓)
2. Preserve the directories. We don't need to save single dentries because we're going to delete the parent when the *— and yeah, the sentence literally trails off like that in the source 🙈 not me finishing it for you, i refuse to invent lore.

⚠️ and here's the important bit: if anything fails in this process, then all the dentries need to be deleted. We don't need to deallocate the original logging buffers, because the caller will do that regardless. so like, don't double-free, bestie 💀 the caller's already got it.

---

🦋 SEE ALSO

• Kernel file ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/rm/r535/gsp.c — the whole fit lives here ✨
• nvkm_gsp_mem_ctor(9)
• struct registry_list_entry(9)
• add_registry(9)
• build_registry(9)
• clean_registry(9)
• strip(9)
• r535_gsp_rpc_set_registry(9)
• r535_gsp_msg_run_cpu_sequencer(9)
• struct rpc_ucode_libos_print_v1e_08(9)
• r535_gsp_msg_libos_print(9)
• create_debugfs(9)
• r535_gsp_libos_debugfs_init(9)
• create_pte_array(9)
• r535_gsp_libos_init(9)
• nvkm_gsp_radix3_sg(9)
• r535_debugfs_shutdown(9)
• is_empty(9)
• r535_gsp_copy_log(9)
• r535_gsp_libos_debugfs_fini(9)

like, that is a whole friend group right there. go read them too 👑

---

and that's the page! source path got cut off at ./drivers/gpu/drm/nouveau/nvkm... (they really said "you'll figure it out" 😭), the date on this one is October 2026, and it's from the Kernel API Manual. mwah, go ship it 💜✨