nlm4svc_proc_share(9)

📦 version 7.3.1, in nixpkgs unstable

💅 nlm4svc_proc_share(9) — like, the Kernel API Manual, bestie 🎀

okay so this is a page from the Kernel API Manual (yes that one, the (9) section, we're in kernel land now ✨) and honestly? it's a whole vibe. let's get into it 🫶

✨ NAME ✨

nlm4svc_proc_share — SHARE: open a file using DOS file-sharing modes 🦋

like yes, DOS. yes, in the kernel. we contain multitudes 💜

🌸 SYNOPSIS 🌸

__be32 nlm4svc_proc_share (struct svc_rqst *rqstp );

one function, one argument, zero drama (okay maybe a little drama, see RETURN below 😭)

🎀 ARGUMENTS 🎀

  • rqstp — the RPC transaction context. that's it. that's the whole argument. she's lowkey carrying the entire request on her shoulders 👑

⭐ RETURN ⭐

  • rpc_success — the RPC executed successfully. slay 💅
  • rpc_drop_reply — do not send an RPC reply. like, read the room and say nothing 🫥

🔥 DESCRIPTION 🔥

RPC synopsis, verbatim, because we do not paraphrase code in this house:

nlm4_shareres NLMPROC4_SHARE(nlm4_shareargs) = 20;

so, the permissible procedure status codes — iykyk 👑

  • NLM4_GRANTED — the requested share lock was granted. icon behavior, no notes 🎉
  • NLM4_DENIED — the requested lock conflicted with existing lock reservations for the file. it's giving "someone already claimed this seat" 💀
  • NLM4_DENIED_GRACE_PERIOD — the server has recently restarted and is re-establishing existing locks, and is not yet ready to accept normal service requests. she's recovering, give her a minute 🧚

and the Linux NLM server implementation also returns these, because she simply has more to say:

  • NLM4_DENIED_NOLOCKS — a needed resource could not be allocated. out of resources, out of patience 😭
  • NLM4_STALE_FH — the request specified an invalid file handle. that handle is stale fr fr 🙈
  • NLM4_FBIG — the request specified a length or offset that exceeds the range supported by the server. too big. literally too big 📏
  • NLM4_FAILED — the request failed for an unspecified reason. no explanation, just vibes 💀
bestie note 🫶: NLM4_FAILED genuinely does not tell you why. that's not me being vague, that's the spec being vague. do not @ me.

🌈 SEE ALSO 🌈

the kernel file is ./fs/lockd/svc4proc.c, and here's the whole friend group 🫶:

and that's the page!! 📖✨ this one lives in ./fs/lockd, dated October 2026, and she's officially nlm4svc_proc_share(9) — go forth and share those files with your DOS file-sharing modes, bestie. periodt 💅💖

📦 where this page comes from