nlmsvc_proc_test(9)

📦 version 7.3.1, in nixpkgs unstable

💅 nlmsvc_proc_test(9) — the Kernel API Manual, bestie edition 🎀

Okay so real quick before we dive in: this page lives in the Kernel API Manual, and the star of the show is nlmsvc_proc_test. Pull up a chair, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

nlmsvc_proc_test — TEST: Check for conflicting lock 🔥

Like, that's literally its whole job. It checks whether a lock would conflict with stuff that's already going on. No drama, just vibes and lock-checking.

🌸 SYNOPSIS 🌸

__be32 nlmsvc_proc_test (struct svc_rqst *rqstp );

🦋 ARGUMENTS 🦋

  • rqstp — the RPC transaction context 💖. Think of it as the little backstage pass that tells the function everything it needs to know about the request it's handling.

⭐ RETURN ⭐

  • rpc_success — RPC executed successfully ✨. It ate, it slayed, no notes.
  • rpc_drop_reply — Do not send an RPC reply 🙈. Yeah, sometimes the move is to just... not reply. Iconic of it, honestly.

👑 DESCRIPTION 👑

RPC synopsis, and I'm gonna give it to you verbatim because precision is the moment:

nlm_testres NLM_TEST(nlm_testargs) = 1;

Permissible procedure status codes, aka the four moods this thing can be in 🌈:

  • LCK_GRANTED — The server would be able to grant the requested lock 💖. Yay! Slay! The lock is available and everything's good.
  • LCK_DENIED — The requested lock conflicted with existing lock reservations for the file 💀. Not the outcome anyone wanted, but at least it's honest about it.
  • LCK_DENIED_NOLOCKS — The server could not allocate the resources needed to process the request 😭. It's not you, it's the resource allocation. Genuinely tragic.
  • LCK_DENIED_GRACE_PERIOD — The server has recently restarted and is re-establishing existing locks, and is not yet ready to accept normal service requests 🧚. Okay so it just woke up and needs a minute — give it space, it's healing.

💜 SEE ALSO 💜

Kernel file ./fs/lockd/svcproc.c, plus the whole friend group 🫶:

Ngl bestie, if a lock test comes back LCK_DENIED_GRACE_PERIOD you do not get to be mad at the server. It literally just restarted. Read the room 💅

And that's the page, mwah 💋 — brought to you by the kernel file ./fs/lockd, dated October 2026, and filed under nlmsvc_proc_test(9) forever and always. Periodt. 🌟

📦 where this page comes from