nlm4svc_proc_granted(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… nlm4svc_proc_granted πŸ’…

okay so this is a page from the Kernel API Manual bestie, and it's about nlm4svc_proc_granted β€” yes that's a mouthful, we're gonna get through it together 🫢


🌸 NAME 🌸

nlm4svc_proc_granted β€” GRANTED: Server grants a previously blocked lock πŸ”“βœ¨

like, the lock was on hold and now the server is finally sliding it over. it's giving "your table is ready" energy fr fr.


πŸŽ€ SYNOPSIS πŸŽ€

__be32 nlm4svc_proc_granted (struct svc_rqst *rqstp );

that's the whole signature, no cap. it returns a __be32 and takes exactly one thing. iconic minimalism πŸ’…


πŸ¦‹ ARGUMENTS πŸ¦‹

  • rqstp β€” the RPC transaction context. it's literally the whole vibe of the call, everything the procedure needs to know about the request lives in here πŸ‘‘

⭐ RETURN ⭐

  • rpc_success β€” RPC executed successfully. that's it, that's the win, we love a clean success ✨

πŸ’– DESCRIPTION πŸ’–

so the RPC synopsis goes like this, and pls don't @ me, this is verbatim:

nlm4_res NLMPROC4_GRANTED(nlm4_testargs) = 5;

and here are the permissible procedure status codes β€” memorize them, they're important 🧚

  • NLM4_GRANTED β€” the granted lock was accepted. slay, the client said yes πŸ’…βœ…
  • NLM4_DENIED β€” the procedure failed, possibly due to internal resource constraints. lowkey a bummer, could just be the box being stretched thin 😭
  • NLM4_DENIED_GRACE_PERIOD β€” the client host recently restarted and its NLM is re-establishing existing locks, so it is not yet ready to accept callbacks. read that again bestie: it's not yet ready, it's still putting its face on πŸ’€πŸ§΄
heads up: NLM4_DENIED and NLM4_DENIED_GRACE_PERIOD are both real outcomes here, so don't go assuming every call comes back NLM4_GRANTED. the grace period one especially β€” a client that just rebooted is genuinely not going to take your callback yet.

πŸ”₯ SEE ALSO πŸ”₯

Kernel file ./fs/lockd/svc4proc.c β€” like, that's where the actual code lives, go look, iykyk πŸ‘€

the whole lockd friend group honestly 🌈🫢


and that's the page!! it lives in ./fs/lockd, dated October 2026 β€” so like, future vibes but make it kernel πŸ¦‹πŸ’œ go forth and grant those locks bestie, you're gonna do amazing πŸŽ€βœ¨πŸ’–

πŸ“¦ where this page comes from