CLUNK(9P)

📦 version 0_git20260208, in alpine 3.24, arch rolling, nixos 26.05, nixpkgs unstable

✨ NAME ✨

clunk — forget about a fid. yep, that's the whole NAME, and this is the CLUNK(9P) page, bestie 💖

🦋 SYNOPSIS 🦋

size[4] Tclunk tag[2] fid[4]
size[4] Rclunk tag[2]

💅 DESCRIPTION 💅

okay so the clunk request is basically you telling the file server: “bestie, the client is done with the current file that fid points to, we can let it go 🫶”. important plot twist though — the actual file does not get removed on the server, unless that fid had been opened with ORCLOSE. periodt.

once a fid has been clunked, the same fid can be reused in a new walk or attach request. slay, recycling 👑

even if the clunk returns an error, the fid is no longer valid. no cap, it's done — invalid even on the error path 💀

🎀 ENTRY POINTS 🎀

clunk transactions are generated by fsclose and fsunmount (see 9pclient(3)), and indirectly by other actions too — like failed fsopen calls. iykyk 🌈

that's the whole CLUNK(9P) situation — no source/version/date footer info on this page, just the manual name, so consider this your cute little sign-off: bye bestie, go clunk responsibly 💖🫶✨

📦 where this page comes from