dfs_cache_no...date_tgthint(9)

💅 dfs_cache_no...date_tgthint(9) — like, the Kernel API Manual, bestie 🎀

okay so real talk, the manual name got squished (dfs_cache_no...date_tgthint(9), iconic abbreviation energy, they really said "we're not typing all that") but the actual function is dfs_cache_noreq_update_tgthint, and yes it's a mouthful, and yes we're gonna get through it together 🫶

---

✨ NAME ✨

dfs_cache_noreq_update_tgthint — updates the target hint of a DFS cache entry, and the whole point is that it does it without sending any requests to the currently connected server. no network calls, no "hey server u up", nothing. it just vibes with what it already has 💅

---

🌸 SYNOPSIS 🌸

void dfs_cache_noreq_update_tgthint (const char *path , const struct
       dfs_cache_tgt_iterator *it );

---

🦋 ARGUMENTS 🦋

• path — the canonical DFS path you're looking up in the DFS referral cache. like, the actual address of the thing, no shortcuts, no "you know the one" 😌
• it — a target iterator, and it's the one carrying the target hint that this call is gonna write into the cache entry. it's giving "delivery girl with the update" 📦✨

---

💀 NOTE 💀

read this part twice, bestie, it's the main character caveat:

• if the cache entry is expired, this function will not update it. nope. expired is expired 🚫
• if path hasn't been found at all, it will not create a new cache entry. no entry, no entry-creation, not today 🛑
• it heavily relies on an existing cache entry — like, this function is nothing without an entry to lean on. codependent queen 😭💖

---

🔥 DESCRIPTION 🔥

it returns zero if the target hint got updated successfully. otherwise it returns non-zero — so zero means slay, anything else means something went sideways. periodt 💅

---

🌈 SEE ALSO 🌈

• the kernel file ./fs/smb/client/dfs_cache.c (the source, the original text, the mothership 👑)
• dfs_cache_canonical_path(9)
• dfs_cache_init(9)
• dfs_cache_destroy(9)
• dfs_cache_find(9)
• dfs_cache_noreq_find(9)
• dfs_cache_get_tgt_referral(9)
• dfs_cache_get_tgt_share(9)
• dfs_cache_remount_fs(9)

---

okay that's the whole thing, go forth and update those target hints 🧚💜

little sign-off from the source files: this one lives in ./fs/smb/client, dated October 2026, and it's filed under dfs_cache_no...date_tgthint(9) — mwah, bye bestie 🌸🎀