nlmclnt_lookup_host(9)

💖 NAME 💖

nlmclnt_lookup_host — okay so, from the Kernel API Manual (section 9 bestie, we're in the kernel docs now 💅), this is the function that finds you an NLM host handle matching a remote server. that's it, that's the whole vibe check ✨

---

🦋 SYNOPSIS 🦋

struct nlm_host * nlmclnt_lookup_host (const struct sockaddr *sap ,
const size_t salen , const unsigned short protocol , const u32 version ,
const char *hostname , int noresvport , struct net *net , const struct
cred *cred );

like look at all those params 😭 she takes eight arguments, highkey an overachiever, we stan 🫶

---

🎀 ARGUMENTS 🎀

• sap — the network address of the server 🌐 like, where the server actually lives, address-wise.
• salen — the length of the server address 📏 (yes she needs to know how big the address is, don't ask, it's a whole thing).
• protocol — the transport protocol to use 🚚 your ride, basically.
• version — the NLM protocol version 🔢 which generation of NLM we're dealing with.
• hostname — okay so the original gives her zero description, not one single word, and honestly? iconic. main character energy 🎀 she's just there, iykyk.
• noresvport — set this to 1 if a non-privileged port should be used 🔓 slay, no root required.
• net — pointer to the net namespace 🪐 her own little universe.
• cred — pointer to cred 🪪 credentials, the whole "who am i" of it all.

---

🌈 DESCRIPTION 🌈

so here's the tea ☕: this returns an nlm_host structure that matches the passed-in [server address, transport protocol, NLM version, server hostname] 💖 all four, matching, no cap.

and if one of those doesn't already exist in the host cache? 🧚 she creates a new handle and returns it. literally just builds it out of thin air, ate and left no crumbs 👑

---

⭐ SEE ALSO ⭐

Kernel file ./fs/lockd/host.c — go read the source bestie, it's giving required reading 📖

• nlmclnt_release_host(9)
• nlmclnt_shutdown_rpc_clnt(9)
• nlmsvc_lookup_host(9)
• nlmsvc_release_host(9)
• nlm_rebind_host(9)
• nlm_host_rebooted(9)

---

okay that's the whole page, you ate that 🍓 and real quick, the receipts: this one came from ./fs/lockd, dated October 2026, and the page is literally called nlmclnt_lookup_host(9) — periodt 💅✨